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

                      Release date - 08 Aug 1999

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.62. 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 menu that appears,
the item "Address configuration" allows you to specify your main
FidoNet address and up to eight AKAs of your system. In the "Outbound
configuration" dialog, that appears when you choose the respective menu
item, you should specify 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 "Long filenames in outbound" should be enabled if you use a
mailer that supports long filenames in the Bink-style outbound. Since
there is no standard for using long filenames with arcmail attach, this
option should be turned off if you use that outbound mode. For
fileboxes, the value of the option generally does not matter.

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.3 beta:
~~~~~~~~~
[!] The code of the plugin is rewritten using the FAR+Plus C++ classes
    library (soon to be released as a separate product)
[+] The plugin now supports multiple AKAs and substitutes the correct
    AKA in the From address field of netmail messages it creates.
    (Suggested by many users).
[*] Added option "Long filenames in outbound". (Suggested by several
    users, including Vladimir Lavrinenko, 2:5030/596.2)
[*] When a file is attached via a filebox, its read-only attribute is
    cleared. (Suggested by Andrew Velder, 2:5010/111)
[*] Added history list for the "Outbound path" field.
[-] Implemented a workaround for a bug in Win32 API causing files with
    Cyrillic names to be always attached with long names. (Reported
    by Alex Petin, 2:5000/97.8)
[-] If a file attached via filebox was already present in the filebox
    directory, the busy flag for the destination node was not deleted.
    (Reported by KAV, 2:467/34)
[-] After attaching a file from a directory containing Cyrillic
    filenames, these filenames were shown incorrectly. (Reported by
    Dima Kuryanov, 2:5020/968.54)
[-] It was possible to create a short name filebox for an invalid
    address (having zone or point greater than 1023). (Reported by
    Andrey Kuprishov, 2:5023/27)

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.
