@database "Eucalyptus.guide"
@master "Eucalyptus.guide"
@author "Paul A. Schifferer"
@(c) "Copyright © 1997 Isengard Developments"
@$VER: Eucalyptus.guide 1.0 (6.8.97)
@wordwrap

@node Main "Eucalyptus: Table of Contents"

        @{i}Eucalyptus@{ui}
        Version 1.0

        Written by Paul A. Schifferer
        Copyright © 1997 Isengard Developments
        All rights reserved.

        @{b}@{i}Table of Contents@{ui}@{ub}

                 @{u}Legal@{uu}

        @{"     I. " link Terms} Terms
        @{"    II. " link Disclaimer} Disclaimer of Warranty

                 @{u}Starting@{uu}

        @{"   III. " link Intro} Introduction
        @{"    IV. " link Required} System requirements
        @{"     V. " link Install} Installing Eucalyptus
        @{"    VI. " link Registration} Registration
        @{"   VII. " link Bugs} Undocumented features
        @{"  VIII. " link Beta} Beta-testers' note
        @{"    IX. " link UsingWB} Using Eucalyptus from the Workbench
        @{"     X. " link UsingShell} Using Eucalyptus from the Shell

                 @{u}Operation@{uu}

        @{"    XI. " link MainWindow} Main window
        @{"   XII. " link Folders} Folders
        @{"  XIII. " link FolderWindow} Folder window
        @{"   XIV. " link Msgs} Messages
        @{"    XV. " link MsgWindow} Message window
        @{"   XVI. " link Composing} Composing mail
        @{"  XVII. " link AddressBook} Address Book
        @{" XVIII. " link ConfigFilters} Filters
        @{"   XIX. " link ConfigViewers} Viewers
        @{"    XX. " link Configure} Configuring Eucalyptus
        @{"   XXI. " link GetSendMail} Getting and sending mail
        @{"  XXII. " link ARexx} ARexx Interface

                 @{u}Miscellaneous@{uu}

        @{"    XV. " link Misc} Miscellaneous

                 @{u}Appendices@{uu}

        @{"     A. " link History} Program history
        @{"     B. " link Refs} References
        @{"     C. " link me} Author information
        @{"     D. " link Acks} Acknowledgements
@endnode

@node Terms "Eucalyptus: Terms"
@{fg shine}Terms@{fg text}

You may copy and distribute verbatim copies of the programs' executable code and documentation as you receive it, in any medium, provided that you conspicuosly and appropriately publish only the original, unmodified programs, with all copyright notices and disclaimers of warranty intact and including all the accompanying documentation, example files and anything else that came with the original.

You may not copy and/or distribute these programs without the accompanying documentation and other additional files that came with the original.   You may not copy and/or distribute modified versions of these programs.

You may not disassemble, decompile, re-source or otherwise reverse engineer the programs.

You may charge a fee to recover distribution costs.  The fee for diskette distribution may not be more than the cost to obtain a public domain diskette from Fred Fish.
@endnode

@node Disclaimer "Eucalyptus: Disclaimer of Warranty"
@{fg shine}Disclaimer of Warranty@{fg text}

THERE IS NO WARRANTY FOR THE PROGRAMS, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING, THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.   THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAMS TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

SO THERE.
@endnode

@node Intro "Eucalyptus: Introduction"
@toc Main
@{fg shine}Introduction@{fg text}

It seems like I write a lot of programs because I can't find one that does all the things I want it to do.  My philosophy is that if something doesn't do what I need, and I can write it, I will.  Eucalyptus was borne of this philosophy.

Some of you may be wondering from where the name came.  If you've used e-mail on UNIX systems, you should be familiar with some of the popular programs for that purpose, namely Elm and Pine, which, quite obviously, are named after trees.  I always thought that this was an interesting tradition.  But unlike Elm or Pine, Eucalyptus is not an acronym for anything.  (If you can think of anything, I'd be really interested to hear it. :)  I wanted the name to be interesting as well, and Eucalyptus was what I came up with.  Just say it.  "Eucalyptus."  See how it rolls off the tongue?  I knew you'd like it too.
@endnode

@node Required "Eucalyptus: System requirements"
@toc Main
@{fg shine}System requirements@{fg text}

- AmigaOS 2.04 or better
  - 2.1 or better for Locale support
  - 3.0 or better for Datatype support
- 68000 or better processor
- 1MB RAM (2MB or greater recommended)
- ClassAct V2.0 classes
- Internet connection

Optional:
- @{i}newicon.library@{ui} for button image remapping
- @{i}bsdsocket.library@{ui} for internal POP/SMTP
@endnode

@node Registration "Eucalyptus: Registration"
@toc Main
@{fg shine}Registration@{fg text}

Eucalyptus is a free product.  A labor of love, if you will.  I wrote it because I wanted an e-mail program that would do all the things I wanted it to do.

The only registration I ask of you is that you drop @{"me" link me} a line, good or bad, about what you think about Eucalyptus.  If you don't like it, by all means, tell me why.  Maybe I can make that change that'll make you happy.  If you do like it, say so, and give me suggestions for improvement.
@endnode

@node me "Eucalyptus: Author information"
@toc Main

The official support site for Eucalyptus (and other programs) is:

http://www.geocities.com/SiliconValley/Pines/3517

Visit there often to see what's developing.

The address to which you can send me money, postcards, a spare Amiga, or anything else is:

Paul A. Schifferer
515 11th Street        or     PSC 3 Box 2342
Edwards, CA  93523            APO AP 96266
USA                           USA

I can also be contacted via Internet at:

     @{b}gandalf@inet.att.co.kr@{ub}
or   @{b}isengard@geocities.com@{ub}
@endnode

@node Install "Eucalyptus: Installing Eucalyptus"
Included in the archive is an installer script to be used with the Commodore Installer.  If you don't have it, it can be retrieved from the Aminet.
@endnode

@node Bugs "Eucalyptus: Undocumented features"
@toc Main
@{fg shine}Undocumented Features@{fg text}

Some people call these things 'bugs'.  If you happen to notice one of these little critters, let me know, please!  I've done my best to make sure all the bugs were discovered and removed, but I can't find them all.  If finances are favorable, I may send you the next release at my cost.  (See @{"Beta-Testers'" link Beta} Note.)

Please, if you send me bug reports, make sure to let me know the type of system you're running it on (CPU, RAM, etc.), which executable you were using, what other programs were running with it (especially commodities and system enhancers, since they tend to gum up the works sometimes), and what you were doing at the time of the bug occurrence/system crash.
@endnode

@node Beta "Eucalyptus: Beta-testers' note"
@toc Main
@{fg shine}Beta-Testers' Note@{fg text}

This release is in general public distribution.

If you wish to be a beta-tester for future versions of this program, or for any other program I may release, drop @{"me" link me} a postcard or e-mail.  I will put you on the list of beta-testers, for which you will receive notification of test-releases and get your fingers first on the newest and neatest stuff.

@endnode

@node UsingWB "Eucalyptus: Using Eucalyptus from the Workbench"
@toc Main
@{fg shine}Using Eucalyptus from the Workbench@{fg text}

To start Eucalyptus from the Workbench environment, simply double-click on its icon.  Eucalyptus's behavior can be modified by using ToolTypes.  The following ToolTypes are supported:

@{b}SETTINGS=@{i}file@{ui}@{ub}
This indicates the settings file to use for Eucalyptus's configuration.  If not specified, Eucalyptus will first look in its program directory, then ENV:/ENVARC: for a settings file.

@{b}PUBSCREEN=@{i}name@{ui}@{ub}
Use this ToolType when you want to open Eucalyptus on another program's existing public screen.  The name you supply is the name of the screen on which to open.

@{b}PORTNAME=@{i}name@{ui}@{ub}
This ToolType gives the name for Eucalyptus's ARexx port, which defaults to EUCALYPTUS.

@{b}STARTUP=@{i}name@{ui}@{ub}
This ToolType lets you provide the name of an ARexx script to execute when Eucalyptus is started.

@{b}QUIET@{ub}
This ToolType tells Eucalyptus not to display its initial greeting banner.

@endnode

@node UsingShell "Eucalyptus: Using Eucalyptus from the Shell"
@toc Main
@{fg shine}The Shell@{fg text}

To start Eucalyptus from the Shell, simply enter its name at the command line, and the program will begin execution.  The following options are available from the Shell:

@{b}SETTINGS=@{i}file@{ui}@{ub}
This indicates the settings file to use for Eucalyptus's configuration.  If not specified, Eucalyptus will first look in its program directory, then ENV:/ENVARC: for a settings file.

@{b}PUBSCREEN=@{i}name@{ui}@{ub}
Use this ToolType when you want to open Eucalyptus on another program's existing public screen.  The name you supply is the name of the screen on which to open.

@{b}PORTNAME=@{i}name@{ui}@{ub}
This ToolType gives the name for Eucalyptus's ARexx port, which defaults to EUCALYPTUS.

@{b}STARTUP=@{i}name@{ui}@{ub}
This ToolType lets you provide the name of an ARexx script to execute when Eucalyptus is started.

@{b}QUIET@{ub}
This ToolType tells Eucalyptus not to display its initial greeting banner.

@{b}MAIL@{ub}
This ToolType tells Eucalyptus to startup in "mail-send mode," which is specifically designed for use with the "mailto:" option in web browsers.  "Mail-send mode" causes Eucalyptus to open only a single message composition window.  When this window is closed, by sending, postponing or cancelling the message, Eucalyptus will then shutdown.

@{b}TO=@{i}name@{ui}@{ub}
This argument is used to provide one or more "To" addresses for the message being composed.  It is only relevant when used with the "MAIL" switch.

@{b}CC=@{i}name@{ui}@{ub}
This argument is used to provide one or more "Cc" (carbon copy) addresses for the message being composed.  It is only relevant when used with the "MAIL" switch.

@{b}BCC=@{i}name@{ui}@{ub}
This argument is used to provide one or more "Bcc" (blind carbon copy) addresses for the message being composed.  It is only relevant when used with the "MAIL" switch.

@{b}SUBJECT=@{i}name@{ui}@{ub}
This argument is used to provide the subject for the message being composed.  It is only relevant when used with the "MAIL" switch.

@{b}REPLYTO=@{i}name@{ui}@{ub}
This argument is used to provide a "Reply-To" address for the message being composed.  It is only relevant when used with the "MAIL" switch.

@endnode

@node MainWindow "Eucalyptus: The Main Window"
@toc Main
@{fg shine}The Main Window@{fg text}

This is the window from which you begin your e-mail experience with Eucalyptus.  It is simply laid-out:  a speedbar with a few buttons on the left or top, and a listbrowser that shows you all your folders.

Pressing the menu button on your mouse will bring up the available @{"menus" link MainMenu} for the main window.

@{b}The Speedbar@{ub}
This handy item has a few convenience buttons for doing some common things in Eucalyptus.  The following buttons (in the order they appear) currently reside in the speedbar.  @{b}NOTE: If the window is not large enough to show all the speedbar buttons, hold down the Shift key, click somewhere in the speedbar, and move the mouse up/down or left/right to scroll through the buttons.@{ub}

@{i}Compose a message@{ui}
Pressing this button will kick off a new thread wherein you can start @{"composing" link Composing} a new message.

@{i}Check for new mail@{ui}
This will send a signal to Eucalyptus' mail retrieval thread to check the server for new mail.

@{i}Edit addressbook@{ui}
This button brings up a window to edit your @{"address book" link AddressBook}.

@{i}Create a new folder@{ui}
Pressing this will allow you to create a new folder in which to store all those messages you keep getting.  (See @{"Folders" link Folders} for more information on maintaining folders.)

@{i}Open a folder@{ui}
This button will cause the selected folder to open its window.

@{i}Edit a folder@{ui}
This button will bring up a new window in which you can edit the attributes and various other items about the selected folder.  (See @{"Folders" link Folders} for more information on maintaining folders.)

@{i}Close a folder@{ui}
If the select folder's window is open, this button will tell it to close.

@{i}Delete a folder@{ui}
This button will delete the selected folder from the folder list.  (See @{"Folders" link Folders} for more information on maintaining folders.)

@{i}Start online help@{ui}
Pressing this will bring up Eucalyptus' online help file, Eucalyptus.guide (what you're reading now).  The file should be in either the HELP: assign, or the same directory as Eucalyptus itself.

@{b}The Folder List@{ub}
This listbrowser is divided into two columns displaying information about your configured folders.

The first column shows the name of the folder.  To the left of the name may be a small icon (if the folder has sub-folders).  Clicking this icon will toggle whether the folder's sub-folders will be shown or hidden in the listbrowser.    (See @{"Folders" link Folders} for more information.)

The second column shows the number of messages in the folder.  It will show the total number of messages, the number of new messages (if there are any), and the number of unread messages (if any).  Following this will be the size (in KB) of the folder contents.  After that will be an indicator if there are messages in the folder's spool file, if applicable.

The folder will be highlighted if there are new messages or messages in its spool file.

@endnode

@node MainMenu "Eucalyptus: Main menu"
@toc MainWindow
@{fg shine}Main menu@{fg text}

There are five menus in Eucalyptus' main window.  They are: @{b}Project@{ub}, @{b}Folder@{ub}, @{b}ARexx@{ub}, @{b}Settings@{ub}, and @{b}Help@{ub}.

@{b}Project menu@{ub}
From this menu, you can control Eucalyptus' general behavior.

@{i}Compose message...@{ui}
Starts off a new mail composition thread.  (See @{"Composing mail" link Composing} for more information on the options available when composing mail.)

@{i}Submit a bug report...@{ui}
Starts off a composition thread, just like "Compose message...", but it will use a built-in template that is formatted for your bug-reporting convenience.  Hopefully, you'll never have to use this. :)

@{i}Get new mail@{ui}
Sends a signal to Eucalyptus' "get mail" thread to check for incoming messages.  This will reset the mail checking interval.

@{i}Open retrieve window...@{ui}
Tells Eucalyptus to open the @{"mail retrieval window" link MailRetrieveWindow}, which will allow you to be picky about which mails you want to retrieve from the server.  This option is only relevant if you are using the internal POP client and are currently connected to the Internet via a TCP/IP stack, like AmiTCP or Miami.

@{i}Send mail@{ui}
Sends a signal to Eucalyptus' "send mail" thread to check for outgoing messages.  This will reset the mail checking interval.  Note that selecting this item will also remove a suspension.

@{i}Suspend mail send@{ui}
Sets a flag to temporarily suspend (or remove suspension) mail sending.

@{i}Stop mail send@{ui}
Signals the "send mail" thread to stop sending mail for the current interval.

@{i}Hide@{ui}
Will close Eucalyptus' main window and place an icon for it on the Workbench.  You can double-click this icon to restore the window.

@{i}Quit@{ui}
Shut down Eucalyptus.

@{b}Folder menu@{ub}
This menu lets you control various aspects of your folders.

@{i}Open...@{ui}
@{i}Close@{ui}
@{i}New@{ui}
@{i}Edit...@{ui}
@{i}Delete@{ui}
All of these items behave exactly like the corresponding buttons in the @{"main window" link MainWindow}.

@{b}ARexx menu@{ub}
Allows you to have easy access to your ARexx macros for Eucalyptus.

There is only one item in this menu by default, "Execute macro...".  This will bring up a file requester, from which you may select the macro to execute.

The rest of the menu is user-configurable, via the @{"General" link ConfigGeneral_ARexx} settings panel.  You may specify up to 61 ARexx macros to be in this menu.

@{b}Settings menu@{ub}
This menu gives you access to the settings panels for Eucalyptus.

@{i}Enable logging@{ui}
Toggles whether you want to have Eucalyptus log its activity/errors to a file on disk.

@{i}General...@{ui}
Opens the @{"General" link ConfigGeneral} settings panel.

@{i}User...@{ui}
Opens the @{"User" link ConfigUser} settings panel.

@{i}Mail...@{ui}
Opens the @{"Mail" link ConfigMail} settings panel.

@{i}Address book...@{ui}
Opens the @{"Address book" link AddressBook}.

@{i}Viewers...@{ui}
Opens the @{"Viewers" link ConfigViewers} settings panel.

@{i}Filters...@{ui}
Opens the @{"Filters" link ConfigFilters} settings panel.

@{i}ClassAct...@{ui}
Will attempt to start the ClassAct settings program.

@{i}Save settings@{ui}
Saves the current settings in the last used settings file, or the default file, if none was specified.

@{i}Save settings as...@{ui}
Brings up a requester, asking which file to which to save the current settings.

@{i}Load settings...@{ui}
Brings up a requester, asking which file from which you would like to load settings.

@{b}Help menu@{ub}
This menu lets you find out about informational things about Eucalyptus and access online help.

@{i}About...@{ui}
@{i}Credits...@{ui}
@{i}Miscellaneous...@{ui}
These three menu items bring up a requester telling you various things about the program.

@{i}Help...@{ui}
Brings up the online help file.

@endnode

@node Folders "Eucalyptus: Folders"
@toc Main
@{fg shine}Folders@{fg text}

This section covers general folder maintenance in Eucalyptus, i.e., creating, deleting and otherwise modifying folders.

@{b}Creating a folder@{ub}
The first thing that happens when you select this option (via menu or speedbutton) is that you will be prompted to create (or select) a directory for the folder.  After a directory is selected, the Folder Information window will be presented (see sub-section "Editing a folder" below).

@{b}Editing a folder@{ub}
After you initially create, or select for editing, a folder, you will be presented with the @{"Folder Information" link FolderInfo} window.

@{b}Deleting a folder@{ub}
This isn't so hard that you need instructions on how to delete a folder, but I wanted to included the fact that there are certain folders in Eucalyptus that @{i}cannot@{ui} be deleted.  These folders are: Incoming, Postponed, Outgoing, and Sent.  These folders are required for the proper operation of Eucalyptus.

@endnode

@node FolderWindow "Eucalyptus: Folder window"
@toc Main
@{fg shine}Folder window@{fg text}

@endnode

@node FolderMenu "Eucalyptus: Folder menu"
@toc MainWindow
@{fg shine}Folder menu@{fg text}

@{b}Folder@{ub}

@{i}Check new@{ui}
Checks the spool file for the folder, if one is being used, and sends a signal to check mail to Eucalyptus' "get mail" thread.

@{i}Refresh@{ui}
Rereads the current list of messages for the folder and builds a new index.

@{i}Expunge deleted@{ui}
Deletes any messages marked for deletion ('D') from disk.

@{i}Apply filters@{ui}
Applies the current set of filters against the messages in the folder.

@{i}Hide@{ui}
Iconifies the folder window.

@{i}Quit@{ui}
Closes the folder window and all message windows for the folder.

@{b}Message@{ub}

@{i}Read...@{ui}
Opens a read window for the selected message(s).  Asks for verification if more than one message is selected.

@{i}Reply...@{ui}
@{i}Forward...@{ui}
@{i}Bounce...@{ui}
Opens a compose thread for replying, forwarding or bouncing the selected message(s).  Asks for verification if more than one message is selected.

@{i}Print...@{ui}
Prints the selected message(s).  This item is current unavailable.

@{i}Delete@{ui}
Sets the delete flag on the selected messages.

@{i}Import...@{ui}
Allows you to import one or more message files into the folder.

@{i}Move@{ui}
@{i}Copy@{ui}
Moves or copies the selected message(s) to another folder.

@{i}Get address@{ui}
Extracts the "From" or "Reply-To" address from the selected message(s) and adds them to the Address Book.

@{i}Select...@{ui}
Brings up a window that allows you to @{"select messages" link SelectMsgs} in the folder.

@{i}Sort@{ui}
Applies the current sort type to the folder's message list.

@{i}Set status...@{ui}
Lets you set the status flags on the selected message(s).

@endnode

@node Msgs "Eucalyptus: Messages"
@toc Main
@{fg shine}Messages@{fg text}

@endnode

@node MsgWindow "Eucalyptus: Message window"
@toc Main
@{fg shine}Message window@{fg text}

This sections covers how to use Eucalyptus' internal message reader.

When you open up a message, Eucalyptus opens a window with which you may read the message (or various parts of it).

At the top of the window is a speedbar, with the following buttons:

@endnode

@node MsgMenu "Eucalyptus: Message menu"
@toc MainWindow
@{fg shine}Message menu@{fg text}

@{b}Message@{ub}

@{i}Get address@{ui}
Extracts the "From" or "Reply-To" address from the message and adds it to the Address Book.

@{i}Hide@{ui}
Iconifies the message window.

@{i}Close@{ui}
Closes the message window.

@{b}Contents@{ub}

@{i}Save text...@{ui}
Saves the message text to a file on disk.

@{i}Save attachment(s)...@{ui}
Saves any attachments to disk.  Eucalyptus will present a request that allows you to select which attachments to save.

@{i}UUdecode...@{ui}
If the message contains uuencoded data, this will decode it and save it to disk.

@{b}Security@{ub}

@{i}Check signature...@{ui}
If this is a signed message, Eucalyptus will attempt to verify the signature.

Currently, only PGP signatures are supported.  PGP must be installed for this feature to work.

@{i}Decrypt...@{ui}
Decrypts the message, if it is encrypted, and displays the decrypted text.

Currently, only PGP de/encryption is supported.  PGP must be installed for this feature to work.  Other types of de/encryption, such as S/MIME and MOSS are being considered for possible inclusion into Eucalyptus.

@{i}Extract key...@{ui}
Extracts any keys included in the message.

Currently, only PGP keys are supported.  PGP must be installed for this feature to work.

@endnode

@node Composing "Eucalyptus: Composing mail"
@toc Main
@{fg shine}Composing mail@{fg text}

This sections discusses composing e-mail messages.

@endnode

@node ComposeMenu "Eucalyptus: Compose menu"
@toc MainWindow
@{fg shine}Compose menu@{fg text}

@{b}Compose@{ub}

@{i}Send@{ui}
Writes your message to the Outgoing folder, and signals Eucalyptus' send mail thread to begin processing.

@{i}Queue...@{ui}
Writes your message to the Outgoing folder, but waits until the next mail cycle comes around to send it.

Before the message is written, a small requester will pop up asking for some queuing information.  In this request, you can tell Eucalyptus that you want to send the message at specific time, at certain intervals, etc.  (See @{"Specifying Queue Information" link QueueInfo} for more information on queuing options.

@{i}Postpone@{ui}
Writes the message to the Postponed folder for later editing.  The message is not written in MIME-compliant format and is not suitable for sending.

@{i}Cancel@{ui}
Cancels the current message.  If you are editing a previously postponed message, you are given the option of re-postponing, removing the postponement altogether, or aborting the cancel.

@{b}Edit@{ub}

@{i}Undo@{ui}
Undoes the last operation.  Only one level of undo is supported.

@{i}Cut@{ui}
Cuts the selected text from the textfield into the clipboard.

@{i}Copy@{ui}
Copies the selected text from the textfield into the clipboard.

@{i}Paste@{ui}
Pastes the text currently in the clipboard at the current cursor position in the textfield.

@{i}Erase@{ui}
Erases the selected text without copying it to the clipboard.

@{i}Clear all text@{ui}
Erases the entire textfield.

@{i}Insert file...@{ui}
This will present you with a requester for a file to add to the textfield.  It will be added at the current cursor position.

@{i}UUencode file...@{ui}
This is basically the same thing as "Insert file...", except that the file can be any format (not just text), and the data will be UUencoded into the textfield at the current cursor position.

@{i}Save to file...@{ui}
Will save the current text in the textfield to a file on disk.  You will be asked for a filename.

@{b}Misc@{ub}

@{i}Check spelling...@{ui}
Initiates the spell checker.

@endnode

@node Menus "Eucalyptus: Menus"
@toc Main
@{fg shine}Menus@{fg text}

@{"    Main window " link MainMenu}
@{"  Folder window " link FolderMenu}
@{" Message window " link MsgMenu}
@{" Compose window " link ComposeMenu}

@endnode

@node FolderInfo "Eucalyptus: Folder Information"
@toc Main
@{fg shine}Folder Information@{fg text}

In here, you can determine attributes for the folder.  The following options are available in this window:

@{i}Name@{ui}
This is where you can provide the name for the folder.  Avoid naming two or more folders with the same name, as this may have unwanted side effects during message filtering.

@{b}NOTE: You may change the names of the special folders (Incoming, Postponed, Outgoing, and Sent) with affecting their special status.@{ub}

@{i}Sub-folder of@{ui}
Here is where you can set up your folder hierarchy.  Use the select gadget at the far right to bring up a list of folders.  There is no limit to the number of folder levels you can create.

@{i}Folder directory@{ui}
This gadget allows you to specify the directory of this folder.

@{i}Spool file@{ui}
The spool file is where the folder gets its new messages.  The only folder that requires a spool file is Incoming; all others are optional.  If a spool file is provided, the folder will read from it when it is opened.  @{b}Do not specify the same spool for more than one folder.@{ub}

@{i}Sort by@{ui}
This chooser allows you to specify the sort method that will be used for the folder.  The default is Date sorting by newest first.

@{i}Open at startup?@{ui}
Setting this attribute tells Eucalyptus to open the folder's window when the program starts.

@{i}Apply filters on import?@{ui}
This attribute tells Eucalyptus to automatically apply filters to the messages in the folder after the initial import when opening the folder window, or when you explicitly tell the folder to import new messages or check its spool file.

@{i}Reverse sort?@{ui}
Setting this attribute reverses the sorting algorithm being used.  For example, Date sorting is by newest message first.  Reversing will cause messages to be sorted by oldest first.

@{i}Thread messages?@{ui}
This attribute causes messages to be grouped by thread (similar subjects) after sorting is applied.

@endnode

@node Configure "Eucalyptus: Configure"
@toc Main
@{fg shine}Configure@{fg text}

Configuring Eucalyptus is a snap.  Several settings panels are available for you to set up Eucalyptus to suit your needs.

@{"General settings" link ConfigGeneral}
@{"User settings" link ConfigUser}
@{"Mail settings" link ConfigMail}
@{"Filter settings" link ConfigFilters}
@{"Viewer settings" link ConfigViewers}

@endnode

@node ConfigGeneral "Eucalyptus: General Settings"
@toc Main
@{fg shine}General Settings@{fg text}

This settings panel lets you configure general program attributes.

@endnode

@node ConfigUser "Eucalyptus: User Settings"
@toc Main
@{fg shine}User Settings@{fg text}

This settings panel lets you set the information about yourself.

@endnode

@node ConfigMail "Eucalyptus: Mail Settings"
@toc Main
@{fg shine}Mail Settings@{fg text}

This settings panel lets you configure how Eucalyptus handles message displaying, composing, send and receiving mail, and various other things.

@endnode

@node ConfigFilters "Eucalyptus: Filters"
@toc Main
@{fg shine}Filters@{fg text}

This settings panel lets you set up your message filters.

@endnode

@node ConfigViewers "Eucalyptus: Viewers"
@toc Main
@{fg shine}Viewers@{fg text}

This settings panel lets you configure external viewers for use in message reading.

@endnode

@node AddressBook "Eucalyptus: Address Book"
@toc Main
@{fg shine}Address Book@{fg text}

Eucalyptus includes a lovely little address book for your e-mail address storage enjoyment.  This section discusses the options available, in order to derive the maximum amount of pleasure from using your Address Book.

The window is divided into three basic sections: the address list, maintenance buttons, and address information.

@{b}The Address List@{ub}
This is a two-column listbrowser that shows all the addresses in your address book.  It supports a two-level address hierarchy (groups).

The four arrow buttons on the side of the listbrowser allow you to move the selected address to the top of the list, up one, down one, or to the bottom of the list, respectively.

@{b}Maintenance buttons@{ub}
The following buttons let you edit the contents of your address book.

@{i}New@{ui}
This button adds a new address entry into the list.

@{i}New member@{ui}
This button adds a new entry into the currently selected address group.  @{b}NOTE: A group is selected if either the group header or any member of the group is selected.@{ub}

@{i}Delete@{ui}
Deletes the selected address.

If a group header is selected, then all members of the group will be deleted as well.  Use this option with care.  (See the "Group?" option below for information on preserving group members when deleting a group header.)

@{i}Sort@{ui}
@{i}Sort group@{ui}
These two buttons will do an explicit sort of either the whole list, or the selected group, respectively.

@{b}Address Information@{ub}
This group of gadgets lets you edit the information about the selected address.

@{i}Name@{ui}
Put the name of the addressee here.  This is the group name (per RFC 822) when sending messages to a list of addresses.

@{i}Address@{ui}
This is the Internet-style (user_name@domain) address of the addressee.  This is the part that really counts.  This field is irrelevant for group headers.

@{i}Comments@{ui}
This field is provided for your own personal use.  This field is not available for group members.

@{i}Key ID@{ui}
This field lets you specify the key ID for encrypting the message to this particular user.

@{i}Group?@{ui}
This attribute determines whether the address entry is a group header or just a regular address entry.

If you deselect this option on a group header that contains members, you will be given the option of totally obliterating the group members, making the members part of the root address list, or cancelling.  Use this option with care.

@endnode

@node GetSendMail "Eucalyptus: Getting and sending mail"
@toc Main
@{fg shine}Getting and sending mail@{fg text}


@endnode

@node ARexx "Eucalyptus: ARexx"
@toc Main
@{fg shine}ARexx@{fg text}

This section deals with Eucalyptus' ARexx ports.  There are four different types of ports: the main port (default: EUCALYPTUS), the mail retrieve port (default: EUCALYPTUS_GET), the mail send port (default: EUCALYPTUS_SEND), and mail composition ports (default: COMPOSE.#).

@{b}The main port@{ub}
This section details the commands available in Eucalyptus' main ARexx port.

@{i}Quit@{ui}

     Syntax:  Quit
Description:  Tells Eucalyptus to shutdown.

@{b}The mail retrieval port@{ub}
This section details the commands available in Eucalyptus' mail retrieval ARexx port.

@{b}The mail send port@{ub}
This section details the commands available in Eucalyptus' mail send ARexx port.

@{b}The composition port@{ub}
This section details the commands available in Eucalyptus' composition ARexx ports.  Each mail composition process has one of these ports, which is mainly used for interfacing with the spell checker, but can be used for other things.

@endnode

@node Misc "Eucalyptus: Miscellaneous"
@toc Main
@{fg shine}Miscellaneous@{fg text}

This chapter basically covers, well, miscellaneous things that usually can't be placed anywhere else, plus just some tidbits of information.

@{fg shine}The Future@{fg text}

The following items are on my to-do list for future versions of Eucalyptus.  If you think of an item that is not in this list, please feel free to drop me an e-mail or postcard.

- XPK support.
- Multiple message security types (de/encryption and signatures in addition to PGP).

@{fg shine}Authenticity@{fg text}

If you want to be sure that the files in this archive are authentic, I have enclosed below my PGP public key.  All binaries and documentations are accompanied by a PGP signature file, which can be used to verify the authenticity of each file.

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: 2.6.2

mQBtAzFM4HgAAAEDAMrjdVJRvZT93v/e9lKPtEdNsnyFpC66+lJ3tcqy62dcbQKl
2kze/s3vpxDN8DBhs/WeoxPQFmMFekT8BdkxELznxLGPOil1ylPCaNQY2juwQfVP
AMYKGbTTzufh5uYGvQAFEbQnUGF1bCBBLiBTY2hpZmZlcmVyIDxnYW5kYWxmQGh1
Z2hlcy5uZXQ+
=gVLn
-----END PGP PUBLIC KEY BLOCK-----

@endnode

@node Caveats "Eucalyptus: Caveats"
@toc Main
@{fg shine}Caveats@{fg text}

@endnode

@node History "Eucalyptus: Program history"
@toc Main
@{fg shine}History@{fg text}

@{b}1.0@{ub} ?? ??? 1997 -

@{u}Bugs fixed@{uu}

@{fg shine}Testing@{fg text}

Eucalyptus has been tested on the following systems:

@{b}A2000@{ub}
Derringer 030/882 @ 33 MHz (20MB)
AmigaOS 3.1 (V40)
Picasso IV (Picasso 96 V1.21)
DataFlyer IDE w/ Western Digital 1.2GB HD
GVP Impact Series II SCSI HardCard w/ Quantum 80MB HD

@{b}A1200@{ub}
030 @ 40 MHz (8MB)
AmigaOS 3.0 (V39)

@{b}A2000@{ub}
000 @ 7 MHz (8MB)
AmigaOS 2.1 (V38)
Original Chip Set (OCS)

@{b}A4000@{ub}
040 @ ?? MHz (26MB)
AmigaOS 3.1 (V40)

@endnode

@node Refs "Eucalyptus: References"
@toc Main
@{fg shine}References@{fg text}

The following RFCs were consulted during the creation of Eucalyptus:

 821 @{i}Simple Mail Transfer Protocol@{ui}, by Jonathon B. Postel, August 1982.
 822 @{i}Standard for the Format of ARPA Internet Text Messages@{ui}, revised by David H. Crocker, August 1982.
1321 @{i}The MD5 Message-Digest Algorithm@{ui}, by R. Rivest, April 1992.
1344 @{i}Implications of MIME