                           FarAttach 1.2 beta
                           ~~~~~~~~~~~~~~~~~~
                        File attach plugin for FAR
       Written by Yoletir / FaerieFire AKA Dmitry Jemerov, 2:5030/654

                      Release date - 16 Aug 1998

This plugin is designed to facilitate attaching selected files to a
given FidoNet address.

This plugin is freeware and may be used without any restrictions. The
plugin has been tested with FAR 1.50 beta, 1.50 release, 1.51 and 1.52.
It is not guaranteed to work with other versions of FAR.

The last version of FarAttach can always be requested from the author
(Ronnie BBS, 2:5030/654) by alias FARATTACH.

In order to install the plugin, you should unpack the archive to the
subdirectory Plugins\FarAttch in the main directory of FAR.

NOTE for users of FarAttach 1.0 beta and earlier versions:
Please delete the old version of FTDll32.dll from the Windows system
directory (WINDOWS\SYSTEM or WINNT\SYSTEM32).

For initial setup of the plugin, you should choose the item "File
attach" in the "Plugins configuration" menu. In the dialog that
appears, you should specify your main FidoNet address, the type of
outbound you use (Arcmail attach, Bink-style outbound, T-Mail or
long-name fileboxes) and the path to the directory for that type of
outbound.

The option "OEM codepage in outbound" allows for compatibility with
different mailers. Most of them, including T-Mail, expect Cyrillic
filenames in outbound to be in OEM (DOS) codepage, and thus require
this option to be turned on. Others, like Argus, expect ANSI codepage
and require this option to be off.

In order to send the files, you should first select in a FAR panel the
files you want to send. If there is only one file, you can just put the
cursor on it. Then you should select the item "Attach files" in the
plugin commands menu. (You can create a macro for invoking the plugin
more quickly). In the dialog that appears, you should enter the address
to which you want to send the files (incomplete addresses are allowed),
select the flavour needed and check the Kill/sent flag if you want the
files to be deleted after successful sending.


This is only a beta version of the plugin. It may contain bugs. Please
send bug reports, comments and suggestions to the author (Dmitry
Jemerov, 2:5030/654, yole@exch.nnz.spb.su).


What's new in the latest version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1.2 beta:
~~~~~~~~~
[*] Switched from Borland C++ to Visual C++. The .DLL is now more than
    a half smaller.
[*] Size of files to be attached is shown with better precision.
[*] Now FarAttach clears the selection after attaching multiple files.
    (Suggested by Den Ivanov, 2:5045/66.23)
[*] New option "OEM codepage in outbound" allows to select the codepage
    in which Cyrillic filenames are written in *.?LO and *.MSG.
    (Suggested by Alex Kapralov Jr., 2:5030/614)
[-] Now FarAttach doesn't run when invoked from plugin panels. Attaching
    registry keys is rather senseless, anyway...
[-] Error messages from the FidoTools DLL were shown in wrong codepage.
[-] FarAttach didn't correctly attach files from the root directory.
    (Reported by Den Ivanov, 2:5045/66.23)
[-] FarAttach couldn't correctly create netmail attaches with Direct
    and Kill/Sent attributes. (Reported by Alex Kaganoff, 2:5030/82.50)

1.1 beta:
~~~~~~~~~
[*] Now the FidoTools DLL is loaded dynamically. It is no longer
    necessary to put FTDll32.dll in the system directory of Windows.
[*] Now FarAttach doesn't perform full rescan of outbound before
    attaching files, thus it works much faster.
[-] Fixed bug because of which FarAttach couldn't create non-existing
    directories in Bink outbound.
[-] Now ArcMail and Binka attaches are created with short file names.
    (Reported by Serg Agarkoff, 2:5041/1)
[-] Fixed bug causing error messages generated in FidoTools (for
    example, about nodes being busy) to be "lost".

1.0 beta:
~~~~~~~~~
[+] Added help.
[*] Added history to the address entry field in the main dialog.
[*] Support for a new type of outbound - long-name fileboxes.
[*] The Kill/sent flag now works when sending files via fileboxes.
[-] Directories are not attached now.
