%Start

@N@C1@l@c@bXFmail

  See the XFmail home page: http://www.xfmail.org  

 Copyright (c) 1998-2004
  The Archimedes Team (http://archimedes.sourceforge.net)

 Copyright (c) 1995-1998
  Gennady B. Sorokopud (gena@NetVision.net.il)

 Copyright (c) 1995
  Ugen. J. S. Antsilevich (ugen@latte.worldbank.org)   

 Code by the above  authors is variously licensed under the 
 GNU General Public License, or GNU Library General License.
 (See headers of source code files for details.)
 Code by Gennady B. Sorokopud and Ugen. J. S. Antsilevich was
 previously licensed under different terms, and is relicensed
 under the GPL/LGPL with their permission.

 This program may also incorporate some or all or the following
 code by other authors, under other license terms, as specified
 in the source code:

 Implementation of RSA Data Security Inc, MD5 Message-Digest Algorithm, 
 Copyright (c) 1991-2 RSA Data Security Inc (md5.c).

 Compface library: Copyright (c) 1990 James Ashton.

 Code Copyright (c) 1987 X Consortium (RdBitF.c).

 GNU Regex: Copyright (c) 1993 Free Software Foundation.

 Text Editor library (c) 1996 Mark Van Kempen.

 This program requires, and is linked to, the XFORMS library,
 (Copyright(c) 1996-98 by T.C. Zhao and Mark Overmars).

 This program is free software; you can redistribute it and/or modify 
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or 
 (at your option) any later version.

@b  This program is distributed in the hope that it will be useful,
@b  but WITHOUT ANY WARRANTY, without even the implied warranty of
@b  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
@b  GNU General Public License for more details.

 See the file 'COPYING'.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston MA 02111-1307, USA.

 Additional Permissions granted:

 This program is designed to use the XForms library, so we consider
 permission to link to that non-GPL-compatible library is implicit.
 However, in case this is not considered so, we explicitly state:

 'As a special exception, the Archimedes Project, with the permission
 of all earlier copyright holders, formally gives permission to link
 this program with the XForms library, and distribute the resulting
 executable without the source code for XForms in the source
 distribution'.

 Permission to link to the Compface library, which this program is 
 designed to optionally use and for which source code is provided 
 (but which may have a GPL-incompatible license), is also formally given 
 on the same terms as for linking to the XForms library. 

 (Other included code not licensed under the GPL/LGPL is licensed under
 terms believed to be compatible with distribution under the terms of
 the GPL.)
      	
@b This software is provided 'as is' without any expressed or implied warranty
@b of any kind.  Under no circumstances is the author responsible for the proper
@b functioning of this software, nor do the authors assume any responsibility
@b for damages incurred by its use.

 See the Copyright file included in the distribution

@bTable of Contents:

Overview^Overview
The Main Window^Main
The Folder Pane^Folders
The Message Pane^Messages
The Message Preview Pane^Preview
The Button Bar^ButtonPad
The Main Menu^MainMenu
The Address Book^AddressBook
Signature editor^Signature
Configuration^Config
Filtering Rules^Rules
View Message^Viewmsg
Edit Message^Editmsg
Compose new attachment^attach
Search dialog^Search
The Spell Checker Interface^Spellchecker
Advanced XFMail Customization^XFDefaults
What's new in this version^What-New

%Overview

@N@C4@c@b@lOverview

XFMail is an X11 application for managing electronic mail.
It was created using the XForms library toolkit by T.C. Zhao and
Mark Overmars.

Three different types of mailboxes (folders) are supported:
 - standard unix mailbox (elm-style)
 - MH (compatible with mhtools)
 - IMAP (located on IMAP4 or IMAP4rev1 servers)

XFMail supports the POP, SMTP, and IMAP e-mail protocols and has full
MIME support.

PGP/GnuPG encryption/decryption is supported through an external PGP utility.

%Main

@N@C4@c@b@lThe Main Window

The Main XFMail window is divided into five (six) parts. These parts are
described in the next few sections. The top of the window is called the
menu bar. It contains menus labeled File, Message, Folder, Send,
Misc and Help. Below this is the button bar. The button bar is a group
of buttons with icons that perform often used XFMail functions.  Below
this are the folder pane and the message pane. Optionally message preview
pane can be displayed as well. At the bottom of the window is the status bar.

%Folders

@N@C4@c@b@lThe Folder Pane

The folder pane (the left pane in the main window) shows all of the
mail folders available to XFMail. Currently XFMail supports three
different types of folders:

- MH
  Each folder is a directory under ~/Mail/. The messages are stored
  in separate files and file names are numbers.
  This is the default folder type in XFMail.  MH folders are used
  for many internal operations. It's strongly recommended to use
  folders of this type whenever possible.
  All move and delete operations in these folders are completed
  immediately (no delayed operations).
  MH folders can have subfolders of both MH and MBOX type.
  You will be asked to choose the subfolder type when creating a new
  subfolder in an MH folder.

- MBOX
  Standard Unix mailbox. Can be located anywhere in the filesystem.
  All messages are stored in the same file, and separated by
  special From lines.
  These folders support delayed operation (i.e. move/delete is
  performed when the folder is closed).
  XFMail's handling of folders of this type is less efficient than
  MH.  It's recommended to use MH folders unless the use of MBOX
  folders is really necessary.
  Caching of MBOX folders gives only slight speed improvement.
  The incoming spool file is represented as an MBOX folder with name
  'xxxx (spool)' (where xxxx is your spool file name) in the folder list.
  This type of folder can not have any subfolders, however it can
  act as a subfolder of an MH folder.

- IMAP
  XFMail supports IMAP4 (IMAP4rev1) protocol (IMAP2 is not supported), and
  can access folders located on a remote IMAP server.
  Use these folders when you need to access your e-mail from different
  places.
  You will need to install an IMAP4 server (for example from Washington
  University). Access to folders of this type can be slow because
  of the network delays.
  You can defined and connect to multiple IMAP servers at the same time.
  Disconnected (offline) IMAP operations are not supported.
  IMAP folders can have subfolders if permitted by the server.

Double click on a folder to open it.
If you double-click a folder that is already opened, it will be rescanned.
If you hold a Shift button during the double-click only unread messages will be 
opened. This can significantly speed up folder opening, if you only want to
read the new messages.
(The middle mouse button acts exactly as double-click).
If you select a folder with the left mouse button,
information about this folder will be displayed in the status bar.
For more detailed information about the selected folder press F1.
When you click with the right mouse button over a folder, the folder
menu will be displayed. The operations in this menu will always work
on the selected folder, even if it is not opened.

For each folder in the window list, you will see the following:

1) The folder name. It is case sensitive and can't be longer than 16
characters. For folder names longer than 8 characters you probably have to
adjust the name field length via the Config Display dialog and drag the
separator bar between the folder pane and the message pane to make them fit in 
the window. System folders are red, the current folder is blue, IMAP folders are
drawn with a darker blue and all other folders are black (by default). You
can change the color of every folder through the folder options window.

2) The number of messages in the folder. It's not recommended to have more 
than 10000 messages in a folder because rescanning such a folder can be slow.
Folders with a large number of messages can be cached. Caching only
improves the folder rescan time.

3) The number of unread messages in the folder. Note: when the
mailer starts, it does not check the number of unread messages in
each folder. The number is calculated when you enter (open) the
folder (or you can use the Rescan All option to calculate the
number of unread messages in all folders).

If a folder has subfolders , they will be displayed under their parent
folder with appropriate shift to the right. Each parent folder
has an expand/collapse mark at the left. Clicking on it will expand or
collapse the subfolder tree of the selected folder (you can also
use Expand/Collapse option in Folder menu).

You can customize the folder pane using the 'Config Display'  and
'Appearance' dialogs. The folder pane can also be resized by pressing
and holding the mouse button over the vertical divider on the left
of the folder pane and then dragging the divider to the desired position.

In addition there are a number of options associated with each folder.
Those options can be changed through the 'Options' selection in the
folder menu.

%Messages

@N@C4@c@b@lThe Message Pane

All messages in the current folder (the one marked with blue in
the folder window) are displayed in the message pane.

Note: you can customize the displayed information for messages using
the Config/Display dialog. You also can define sorting for the
messages using the same dialog.


The information line for each message contains:

- One character that shows message status.

N - Signifies an unread message. The message line will be in red.
L - Signifies a locked message (it is open in a view or edit window).
    You cannot move or delete a locked message.
* - Signifies a message is marked using Mark/Unmark options.
    The message line will be brown.
+ - Signifies a message that was sent directly to you.

D - Signifies a message marked for deletion.
    NOTE: Delayed message operations are used only in MBOX-style
    and IMAP folders.

A - Signifies an answered message (i.e. a reply to the message was
    sent).
F - Signifies a forwarded message.
P - Signifies a message either encrypted or signed with PGP/GnuPG.
M - Signifies a message that contains MIME attachments.

If a message has a high priority, '!' is displayed right
after the status character.

If a message is in the outbox and XFMail failed to send it then the
message line will be in magenta.

- The date and time when the message was received in the form 
  mmm-dd hh:mm yy

- The size of the message in bytes.
  If the message is bigger than 10000 bytes then the size is shown
  in kilobytes with the letter 'K' at the end.
  If the message is bigger then 1000000 bytes then the size is shown
  in megabytes with the letter 'M' at the end.

- The sender's name (The From: field).  If the sender's full name
  is available, this will be displayed.  If not, this field contains the
  e-mail address of the sender.  Note: in the 'sent mail' folder,
  the To: field replaces the From: field, since this is much more
  useful.

- The message subject

You can open (view) any message by double-clicking on it. When you
select a message, information about it will be displayed in the
status bar. For more detailed information about the message press F1.

Right clicking a message will bring up a message manipulation
menu.

Any number of messages can be selected simultaneously. Pressing SHIFT and
clicking over any message will select all messages between this message and
the currently selected one. If you hold down CTRL you can select/deselect
any message by just clicking on it.

You can move or delete all selected messages by pressing the \"move\"
or \"delete\" buttons on the button bar.

The most recently selected message always becomes the current
message. There is always at least one selected message in the message
pane unless the current folder is empty.

Drag-and-drop between folders is supported. You can select messages
and then click and drag them over to the folder pane and into the
appropriate folder. If you hold SHIFT during a drag and drop
operation, messages will be copied to the selected folder instead
of being moved.

When you double-click on any message, a new message viewer window will
be opened (for a message in the draft folder the editor will be opened instead).
If you click over a message with the middle mouse button, the message will be
displayed in an already existing message viewer window (if there are no
opened viewer windows yet, this will act as the double-click, i.e. a new
window will appear). This mode is convenient for quick message browsing.

For more information about a selected message press F1.
If you want to change several options for the selected message simultaneously
use the 'Options' dialog from the 'Message' menu.

%Preview

@N@C4@c@b@lThe Message Preview Pane

This pane will be displayed only if 'Show preview pane' option is set in
Config View/Edit^Config-View

The pane shows text of the selected message in the same way as the message
viewer. If the pane is shown, new messages will become unread as soon as you
select them. Right-click over the pane will refresh contents of the currently
displayed message. Pane can be resized by dragging the separator between
it and folder/message panes.

An attempt to preview message which resides on remote server (POP/IMAP)
will NOT cause the message to be retrieved. Use 'Download' message
option for previewing such messages.

If 'Show header with' option is set, message header will be previewed as
well, but the scrollbar will be set that way, so header is hidden.
Message header wll be displayed in simplified form and only fields loaded into
memory will be shown.

If the previewed message contains any MIME attachments, they will be displayed
at the end of the message text. Clicking on the attachment with
 - left mouse button
  will open (view) the attachment
 - middle mouse button
  will bring up 'View As' MIME selection dialog
 - right mouse button
  will bring up MIME menu which allows saving and printing of the selected
  attachment

Preview pane is designed to allow fast browsing of message text, and it
does not have functions for manipulating PGP/uuencode etc...
You should use message viewer for those purposes.

Colors and fonts used by Preview pane can be customized in Appearance
dialog ('Message Viewer' controls colors, and fonts are controlled by
appropriate charset settings).

%ButtonPad

@N@C4@c@b@lThe Button Bar

The button bar allows you to quickly perform common XFMail functions.
The individual buttons are not labeled with text, but you can bring
up a \"tool tip\" for each button by leaving the mouse cursor over
it for a second or two.

Button bar function overview (from left to right):

- Exit XFMail.  The trash folder will (optionally) be emptied and
  the configuration will be saved.

- Edit the current message with the internal editor

- Create a new message

- View the current message

- Print the message to the configured printer

- Reply to the selected message
   A right click will always generate a reply to the sender only.
   A left click will generate a reply according to settings
   in Rep/Fwd configuration dialog.
   If the preview pane is shown, and part of the message text is selected,
   only this text will be quoted in the reply message.

- Forward the selected message
   If the preview pane is shown, and part of the message text is selected,
   only this text will be forwarded.

- Move the selected message(s) to another folder
   (pressing the right mouse button will display a folder list)

- Delete the selected message(s)
   (a right click will cause EXPUNGE in IMAP folders).

- Check for new mail from all sources
   (a right click will check only the spool file and skip POP and IMAP)

- Send the selected message(s)

- Save the selected message to file (select only one message)
   (a right click will save the message with a full header)

- Abort the current operation

- Open the help window

%MainMenu

@N@C4@c@b@lThe Main Menu

- File

    - Save options
       Saves all configuration files to disk

    - Save to File
       Saves the current message to a file

    - Exit
       Exits XFMail (same as exit on button bar)

- Message 

    - View
       Views the current message

    - Edit
       Edits the current message

    - Delete/Undelete
       Deletes the selected message(s)
       If the folder supports delayed operations then
       deleting the message(s) a second time will undelete
       it(them).

    - Move to Folder
       Moves the selected message(s) to a folder

    - Copy to Folder
       Copies the selected message(s) to a folder

    - Mark
       Marks the current message

    - Unmark
       Unmarks the current message

    - Mark Read/Unread
       Marks the selected message(s) as read (or unread)

    - Print
       Prints the selected message.

    - Apply rules
       Filters the selected messages using the filtering rules

    - Select all
       Selects all messages in the opened folder

    - Select marked
       Selects only marked messages.  Convenient for working
       with search results.

    - Delete from POP
       Deletes all selected messages from the POP server

    - Refresh
       Re-reads the message from file or remote server

    - Options
       Displays a small dialog which allows changing of many
       options associated with the selected message.

    - Pipe
       Pipes a message to the entered shell command.

    - Download
       Retrieves message body from remote IMAP/POP server.
       If preview pane is on, it will be refreshed automatically.

- Folders

    - Create
       Creates new folder

    - Create subfolder
       Creates a subfolder of the selected folder (if supported)

    - Delete
       Deletes the selected folder (system folders cannot be deleted)

    - Rename
       Change the name of the selected folder

    - Open
       Opens a specific folder. Same as double-clicking on the 
       folder name

    - Open Unread
       Opens the selected folder, but only unread messages in it
       are rescanned (this saves time on large/remote folders)

    - Empty Trash Folder
       Deletes all messages in the trash folder(s). This also optionally
       happens when XFMail exits.
       IMAP folders can have separate trash folders.

    - Catch Up Unread
       Marks all unread messages in the current folder as read

    - Search
       Brings up the message search dialog

    - Rescan All
       Rescans all folders. This is useful if you want to find
       out the exact number of unread messages in all folders.

    - Options
       Displays folder configuration dialog.

    - Expand/Collapse
       Expands (or collapses) the branch of the selected folder tree.

    - Expunge
       Expunges (permanently deletes) all messages marked as
       deleted in current folder.
       Note: expunge is not supported in MH folders.

- Send

    - New
       Creates a new message and opens the message edit dialog

    - Reply to Sender
       Generates a reply to the current message. Only the sender will
       receive a copy of the reply.  Cc and Bcc entries in the
       original message are ignored.
       If the preview pane is shown, and part of the message text is selected,
       only this text will be quoted in the reply message.

    - Reply to All
       Generates a reply to the current message. The reply is sent to
       all addresses in the original message (To, From, and CC).
       If the preview pane is shown, and part of the message text is selected,
       only this text will be quoted in the reply message.

@C1@b       Note: this option will ALWAYS generate a reply to all recipients,
@C1@b       without taking your settings in Rep/Fwd configuration dialog into
@C1@b       account. So be carefull!

    - Forward
       Forwards the current message
       If the preview pane is shown, and part of the message text is selected,
       only this text will be forwarded.

    - Bounce
       Bounces (resends) a message to another recipient(s)

    - Send All
       Sends all messages in the outbox

- Misc

    - Address Book
       Brings up the address book dialog

    - Config Accounts+Misc
       Brings up dialogs for configuring accounts for sending and receiving
       mail,  posting to News servers, LDAP servers, plus miscellaneous
       items such as Editor settings, and configuring external programs.

    - Config XFMail Settings
       Brings up different configuration dialogs to change the settings
       that XFMail uses.  There is a separate section in this help
       file that covers the settings.

    - Appearance
       Brings up a dialog that allows changing font and color
       settings used by XFMail.

    - Signature
       Brings up the signature editor dialog

    - Rules
       Brings up the filtering rules editing dialog

    - Retrieve mail
       Retrieves new mail from all sources

    - Log
       Brings up the log dialog. This window will display messages
       about any XFMail network activity (POP, SMTP, IMAP) and other
       important messages. This is useful for debugging purposes.  All
       of the information from the log window can be redirected to a
       file by using the \"To file\" button.

- IMAP
       Allows connect/disconnect from/to configured IMAP server(s).
       IMAP servers can be defined in
       Receive^Config-Receive dialog

- Help

    - Contents
       Displays this help file

    - About
       Displays author and copyright information

    - Bug Report
       Allows you to send a bug report to the author.  Please note
       that by default, this attaches a copy of your configuration
       file to help the authors determine the source of the bug.

    - Subscribe to mailing list
       Sends mail to Majordomo@Burka.NetVision.net.il with
      \"subscribe xfmail <your addr>\" line

    - Unsubscribe from mailing list
       Unsubscribes you from the above mailing list

    - What's new
       Displays a list of new features in this release of XFMail.

%AddressBook

@N@C4@c@b@lThe Address Book

The address book allows you to manage your own e-mail address database.
You can add addresses to the address book either automatically or
through view/edit message dialogs (see below).

Multiple address books can be defined. Use the \"New book\" button
to create more address books. Each address book is stored in a file
called .xfbook.<name>, where <name> is the name of the address
book. The files are placed in the configuration directory (usually ~/.xfmail/).

Addresses can be copied from one address book to another.
In order to do this, select the address you want to copy
and then click with the right mouse button over the desired
address book name in the list at the left.

In addition you can copy (append) addresses to aliases inside one
address book. It's done in the same way as copying to the address
book, but instead of clicking on the address book name, click
on alias entry.

You can speed up the search for a particular address in the address book by
typing part of it in the input field. The first address that matches the
contents of the input field will be selected. To find the next address that
matches the same expression press the \"down arrow\" button to the right of
the input field.

All entries in the address book are sorted alphabetically, but only
the address itself is used as the sort criteria, and not the person's
name or comments. I.e. \"(Allmighty) <xpert@wizard.com>\" will be
displayed after \"Zero cool <anywhere@universe.com>\" .

You can choose a particular address by double-clicking it (clicking with
middle mouse button or pressing Enter will also work). When adding
recipients in the message editor window, the address book window will not
close after you select one address.  This way you can add as many addresses
as you want without opening the address book many times. After you have
finished adding all of the recipients you want, press the Ok button (or hit
Esc) and the address book will be closed.

You can add a PGP id to every address by entering it in the PGP input field.
Lookup opens a lookup dialog that reads the PGP keyring database. If you
plan to sign messages with different keys, add all relevant addresses to the
address book and lookup their keys from the key lookup dialog. When
composing a message, you can then change the From: line, and XFMail will
search the address book for a matching key for signing the message.

See PGP Key Id Lookup^PGPKeyIdLookup

Button overview (from top to bottom and from left to right):

 - New book
     Creates a new address book. All addresses are by default stored
     in the file: <configdir>/.xfbook.<book name>.

 - Del Book
     Deletes the selected address book. The default address book
     cannot be deleted.

 - Save book
     Saves the contents of the currently opened address book into
     a file.

 - Refresh
     Rescans the address book file and displays all address
     books found.

 - Import
    Allows you to import addresses and aliases from other e-mail
    clients. Currently supported are .mailrc from standard unix
    mail utility, and Pine's .addressbook.

 - Ok
     Closes the address book (you can use Esc instead).

 - Add
     Adds the address from the input line to the address book.

 - Delete
     Deletes the selected address.

 - Modify 
     Changes the selected address to the address specified in the
     input field. If the selected address is an alias then the
     entered text will be treated as an alias name. If the input
     field was blank and an alias was selected, and you pressed
     this button then you will be asked if you want to convert
     the selected alias to a regular address entry.

@C1@b     WARNING!!! If you answer yes, then all members of the alias
@C1@b     except for the first will be lost.

 - PGP Id
     Opens a PGP key id lookup dialog.
     See PGP Key Id Lookup^PGPKeyIdLookup

 - New alias
     Creates a new alias in the opened address book. You will be asked
     to enter the alias name. The Alias name should be unique in every address
     book, can contain only letters and digits, and it cannot be
     longer than 16 characters. After you have entered the name, the alias
     editor window will be displayed. Each alias should have at least
     one member. An alias can contain other aliases' names as members.
     They will be expanded by the message editor or forward/resend rules.
     Alias members can also have a PGP id. You can lookup in the PGP
     keyring database by using the Lookup button.

 - Members
     If the selected entry is an alias, the window with the list
     of alias members will be displayed so you can edit the list.
     If the selected entry is not an alias you will be asked if
     you want to convert it. If your answer is yes then the alias
     editor window will be displayed, otherwise the address will
     be left unchanged.

The To, Cc, and Bcc selector allows you to choose the format of the
recipient address when adding addresses in the message editor.

%PGPKeyIdLookup

@N@C4@c@b@lLookup PGP id

This dialog looks up your PGP keyring database and shows all keys
found in your public keyring file in the browser. The name XFMail is 
looking for is shown in the PGP user field. Clicking on an address 
shows the associated PGP id in the PGP id field. Double clicking on a 
line or pressing the Ok button will return the selected PGP id to the 
calling dialog; pressing the Cancel button cancels the dialog.

%Create-Folder

@N@C4@c@b@lCreate Folder

This dialog is used for creating folders that can later be
accessed and used by XFMail. First select the folder type.
(you can create an IMAP folder only if a connection to the server
is already established).

For MH folders, the folder name should be a string 2-16 characters
long without spaces or any control characters. If everything is
ok, the new directory will be created under ~/Mail/.

For MBOX folders, the full path of the mailbox file should be supplied.
If the file does not exist it will be created. Use the 'File' button
to select the filename.

For IMAP folders, the folder name can be any string supported by the
server.

If you want to create a subfolder of an already existing folder, use
the Create Subfolder dialog^Create-Subfolder

%Create-Subfolder

@N@C4@c@b@lCreate Subfolder

To create a subfolder, select the Create-Subfolder option from the Folder
pulldown menu.  You will be prompted for the subfolder name, which will be
created as a child of the current folder in folder tree.
Subfolder path will contain full path of the new subfolder in the tree.
Hierarchy delimiter is usually '/' , but for IMAP folders it can sometimes
be different (like '.' for Cyrus IMAP server).

Created subfolder will inherit some of the options of the parent folder
(like color, sort order, default From, and some options).

Note that only MH and IMAP folders can have subfolders and
MH folders can also have MBOX folders as subfolders.

%Signature

@N@C4@c@b@lSignature editor

You can edit your signatures (the text that is placed at the bottom
of every message) using the signature editor. XFMail supports multiple
signatures. The signature used for a specific message is determined
according to user-specified rules.

When XFMail starts up for the first time it looks for a 
~/.signature file and if it exists XFMail uses it as the default
signature. If not, XFMail creates (or uses an existing)
~/.signature.xfmail as the default signature.

Signatures can be added using the \"Add signature\" button and
deleted using \"Delete signature\". You cannot have more than 16
signatures and you cannot delete the default signature. Each
signature should have a unique name (2 - 16 characters).

There are three ways signatures can be inserted by XFMail
(which are controlled by the Add option)
 - Don't add
    The signature is not added automatically, but you can add it
    manually from the message editor.

 - Before
    The signature is added when the message is created
    (i.e. right before editing)

 - After
    The signature is added immediately after you finish editing and
    press the Send button. In this case the signature with the best
    matching rule will be used (the default signature will be used
    if there are no matching rules).

A list of available signatures is displayed inside the browser in the
upper left corner of the signature editor. Click on the signature
name to open it.

Every signature can have a rule associated with it. A rule consists
of a field name which should be checked and a regular expression
which should match the field's contents. For example, if you want to 
use a signature \"xfmail\" when sending mail to
xfmail@burka.netvision.net.il type \"To\" in the \"Field\" input
and \"xfmail@netvision.net.il\" in \"Text\".

The signature can contain some special variables which will be
expanded when the signature is added to the message. Possible
variables are:

 $d - The current date
 $t - The current time
 $m - Your e-mail address (from the Configuration)
 $f - Replaced by the output of a user specified program.  The
      program is defined in the signature editor.  Fortune is the
      default program.
 $$ - Replaced by a single $

NOTE: Signatures longer than 5 lines are often considered wasteful.

After you finish editing your signatures, press the Save Changes
button (second from the left) to update the signature file, or
the Exit button if you want to leave the file unchanged.

Button functions overview (from left to right) :

 - Exit
    Exit signature editor without saving

 - Save changes
    Save changes to the signature file

 - Add signature
    Create new signature. You will be prompted for signature name
    and file.

 - Delete signature
    Deletes currently displayed signature. The default signature cannot 
    be deleted

 - Help
    Displays help about the signature dialog

Options overview :

 - Add
    Chooses how XFMail will attach a signature to a message

 - Execute
    Location of the user specified program whose output will take
    the place of the $f macro in the signature. \"fortune\" is the
    default program.

 - Prefix with '-- '
    XFMail will put '-- ' before the signature.

Rule parameters :

 - Field
    Specifies which field should be matched for signature rules

 - Text
    The regular expression to be matched for signature rules

Note: options are global for all signatures, rules however are assigned
per signature.

%Config

@N@C4@c@b@lConfiguration

Contents:

General^Config-Misc
Timers^Config-Timers
View^Config-View
Edit^Config-Edit
Keymap^Config-Keymap
Send^Config-Send
SMTP Account List^Config-SMTP
Configuring SMTP Accounts^Config-SMTPacct
Receive^Config-Receive
POP^Config-POP
Smart POP^Config-SPOP
IMAP^Config-IMAP
NEWS^Config-NEWS
LDAP^Config-LDAP

Display^Config-Display
Faces^Config-Faces
Reply/Forward^Config-repfwd
Charset^Config-Charset
Default Encoding^Config-Int
MIME^Config-MIME
Spellchecker^Config-Ispell
Header^Config-Header
PGP^Config-PGP

Appearance^Config-Appearance
Folders^Config-Folders
Messages^Config-Messages

You can customize XFMail using the Config dialog(s). Each
tab presents a different configuration window.

 - Ok
    Closes the configuration dialog. All changes are saved
    to <configdir>/.xfmailrc.
    Note: if you have the XFMAILRC environment variable set
    (or you used -cfgfile <file> command line switch) then
    XFMail will use <configdir>/$XFMAILRC (or <configdir>/<file>) instead.
    <configdir> is usually ~/.xfmail/ , but you can set it to another
    value by setting the XFMAILDIR environment variable or by
    using -cfgdir <dir> command line switch.

    XFMail will also read system-wide confuiguration file /etc/xfmailrc
    on startup (if exists). Settings from this file will be overrided
    by those from .xfmailrc.

 - Help
    Displays the help window for the opened configuration dialog.

 - Cancel
    Closes the configuration dialog. Any changes that were made
    are lost.

 - Defaults
    Restores the default values for all fields of the selected
    configuration dialog.

Note: in some dialogs you will be asked to fill names of the programs
that will be executed later (like external editor, speller, etc.). 
XFMail can only execute binaries or shell scripts. You can supply
as many parameters as you want, but you cannot use any shell directives
or variables in these command lines. i.e. command lines
'/bin/prog1;/bin/prog2' , '/bin/prog1 < file1' are illegal, but
'/bin/prog1 file1 file2 file3' can be used.

%Config-Misc

 - General
    Miscellaneous variables that affect XFMail's work
     - Mail directory
         Where all the folders reside. By default it's ~/Mail.

     - Cache directory
         Where all cache DBM files will be stored. By default
         it's ~/.xfmail/.cache. You don't need to change
         this unless your home directory is located on NFS server
         and access to it is slow.

     - Print command
         Command used to send output to the printer.
         $p is replaced by printer name (see below)
         $f is replaced by name of file which should be printed
         $$ is replaced by single $ character

         By default XFMail will use lpr (or lp) program installed
         on your system.

     - Printer name
         Name of the printer you want to use (as specified in 
         /etc/printcap).

     - From field
         The From: field in all messages that you will send.
         By default it's \"First Last\" <username@hostname.domainname>
         NOTE: on some machines domainname is not set properly so
         you will need to change this parameter manually.

         Multiple From addresses can be specified, separated by comma.
         In this case first address will be the default, and all others
         can be selected through special menu in message editor.

     - Organization (optional)
         Your organization. If desired, leave this field blank.

     - Reply-To (optional)
         Put the e-mail address that you want all replies to
         your messages to use (ONLY if it differs from your main 
         e-mail address as defined in From).

     - Start iconized
         Start XFMail as an icon.

     - Set window placement
         If this option is set, XFMail will decide where to place windows
         on the screen by itself, otherwise this task will be left
         to the window manager.

     - Open log on startup
         XFMail will bring up the log window immediately after its startup.
         It's useful if you want to check out an initial POP connection or
         do other debugging.

     - Show tooltips
         Tooltips will be shown when you move the mouse pointer over
         buttons.

     - Empty trash on exit
         Trash folder(s) will be emptied on exit.
         Note: this includes trash folders on IMAP servers.

     - Confirm exit
         You will be asked whether or not you want to exit XFMail
         every time you press an Exit button.

     - Log errors
         Append various XFMail error messages to log.
         (invoked by Log option of Misc menu).

     - Log network activity
         All network related messages will be appended to the log
         (connect/disconnect, DNS resolving, etc...)

     - Set Message-ID
         If set, XFMail will generate Message-ID: header.
         If not, this job will be left to sendmail (or other e-mail
         agent used).

     - Set Sender
         If set, XFMail will generate Sender: header.

     - Cache folders with more than <x> messages.
         Folders that have more than specified number of messages
         (default is 512) will be automatically cached.
         Caching can be enabled separately in each folder through
         Options dialog (invoked from Folders menu).

%Config-POP

 - POP
    Post office protocol (POP) definitions. This allows you to
    retrieve mail from a POP server anywhere on the network.

    - Host
       POP server name. You can use the DNS name or the IP.

    - Port
       POP port. You can specify port number or service
       name from /etc/services. The default is pop3 (usually 110).

    - Username
       Your username on the POP server

    - Password
       Your password on the POP server. Warning! This field is
       \"hidden\". You will see spaces instead of the characters
       you type.

    - Delete From Server
       If selected, XFMail will delete retrieved messages
       from POP server after they have been retrieved.

    - Don't mark retrieved
       Retrieved messages will be marked as unretrieved on
       the POP server.

    - Use POP2
       Only a minimal set of POP commands will be used.  Try this
       if POP fails for some reason.

    - Use APOP
       Attempt to use APOP authentication mechanism (if supported by
       the server). In this case Password acts as an APOP secret.

    - Store password
       Stores your POP password in the configuration file
       so you will not need to enter it every time you start 
       XFMail.

@C1@b       WARNING! WARNING! This is a VERY insecure option.
@C1@b       Your password will be stored in the configuration file
@C1@b       as is, without ANY encryption. Make sure that no one else
@C1@b       has read/write access to the file (use chmod to change this).

    - Log session
       Logs all POP negotiation in XFMail internal log.

The right side of this dialog is for Smart POP configuration; see
Config Smart POP.^Config-SPOP

%Config-SPOP

 - Smart POP

    This sophisticated feature allows you to control POP message
    retrieving.

    Warning!! Most of these features will work only on a POP server
    that fully supports POP3D protocol (like the QUALCOMM server).

    - If message is bigger than
       If a message is larger than this specified amount (in kilobytes),
       special action will be taken. -1 means that message
       will be retrieved as usual, and 0 means the action will be
       taken for every message.

     - Retrieve only header
        Only the header of a big message will be retrieved. This is
        useful if you are connected through a slow modem link. You can
        retrieve the message body later when you try to open it.

     - Skip it
        Message will be left on the server.

    - Check if retrieved
       This option allows you not to retrieve the same message more
       than once if you decided to keep your message on the server.
       This is useful if you read your mail from different locations.

     - By Status
        XFMail will check the message status and will retrieve the
        message only if it marked as unread.

     - By UID
        XFMail will store UIDs of every retrieved message in a special
        file and check every new message UID against this file.
        This option should be used with care since XFMail will
        \"remember\" only the last 3000 messages retrieved and then the
        UID file will be truncated.

    - To check status (Obtain UID)
        Tells XFMail how to get the status of a message on the
        POP server.

     - Get Header
        XFMail will fetch the message header in order to obtain the
        message status. This is slow.

     - Use XLST
        XFMail will issue XTND XLST command.

@C1@b        WARNING!! This command is not part of the RFC and most POP
@C1@b        servers do not support it, but it is faster.

%Config-View

 - View
    Controls how the message will be viewed on the screen

     Configuration for external programs
     - External editor
        Specifies location of an external editor. $f specifies the file name to
        send to the editor. If it is not specified, the file name will be
        added at the end of the command line.

     - External viewer
        You can use an external viewer for a message if it is too big
        or has a special format. $f specifies the file name to send
        to the viewer. If it is not specified, the file name will be
        added at the end of the command line.

     - URL viewer
        HTML browser which should be launched when you double-click
        over a URL. If it's not specified then the handler from
        the text/html MIME type will be used.
        %s will be replaced by URL.

     - FTP program
        Path to FTP transfer program. It will be used with ftp://
        URLs and with some type of MIME messages.

     Viewer properties
     - Switch folders
        If this option is set then 'previous unread' and 'next unread'
        buttons will look in other folders for unread messages.

     - Exit after Move/Delete
        After you delete or move the displayed message, the viewer
        window will be closed instead of going to the next message.

     - Show preview pane
        If set , additional message preview pane will be displayed
        in the main window. XFMail should be restarted in order for this
        option to take effect.

     - Use internal viewer.
        Whenever the external viewer would be invoked XFMail will
        run its special internal mini-viewer which is sufficient
        in most cases.

     - Show Header
        Display the message header. You can also toggle this inside
        the message view window.
        - with
           controls the color the header will be marked with.

     - Mark included
         All lines in displayed message which start with the 'reply'
         prefix will be marked.
        - with
           controls the color the lines will be marked with.

     - Highlight URLs
         All ftp and http URLs, and also e-mail addresses will be
         highlighted in message text.
        - with
           sets highlighting color.

     - Wrap Line
        The maximum line length in the view window, before it wraps to
	the next line.  80 is the standard width.

     - Confirm reading
        Defines how to send a confirmation message after you view
        a message which requests a read confirmation.
   
        - Always
           Confirmation message is sent to the sender without any
           notification (default).

        - Ask
           Asks you if you want to send the confirmation message.

        - Never
           Never send a confirmation message.

     Double-clicking on parts of the text may cause the following response:

     - if the text is a URL or WWW address then URL browser will be started.
       XFMail will treat text as a URL if:
       - it starts with http:// or https://   (highlighted)
       - it looks like a host address and starts with www.
       - it looks like a host address. in this case you will have to
          confirm launching the URL browser.

     - If the text is FTP location FTP program will be executed.
        (confirmation is always required).
        FTP location is anything which starts with ftp:// (highlighted)

     - If the text is a mail address, XFMail will open compose window
        with selected address in the recipient list. (highlighted)
        (confirmation is always required).

     Items which have (highligted) near them, will be marked with different
     color if 'Highlight URLs' option is set.

     Editor properties^Config-Edit

%Config-Edit

 - Editor Properties
    Controls internal editor parameters.

     - Keymap
        Opens keymap editor window.

     - Wrap line
        The maximum line length in the edit window. Lines longer than
        this limit will be wrapped.

     - Paste at cursor position
        If set pasted text will be inserted at cursor position
        and not at mouse pointer.

     - Enable word wrap
        XFMail will try to wrap lines between words, so the text
        will be more readable.

%Config-Receive

 - Receive
    How to retrieve mail from your mailboxes or POP/IMAP accounts.
    You can have many accounts of each type defined. XFMail will
    scan each account every time it attempts to retrieve new mail.

    XFMail supports three different types of mail accounts:

     Spool
       retrieves new mail from the local spool file.

     POP
       retrieves new mail from a remote POP server.

     IMAP
       Defines connection to IMAP server.

     - Add
      Adds new mail account.

     - Delete
      Deletes selected account.

     - Edit
      Displays edit dialog for selected account.

     Account options:

      - Save all addresses
         Addresses of the sender and recipients of each message retrieved
         from this account will be appended to the default address book.

      - Don't notify
         Mail retrieved from this account will not cause new mail notification.

      - Disabled
         Account is disabled and XFMail will not retrieve mail from it.

      - Mark read
         All messages retrieved from this account will be marked as read.

      - Ignore by timer
         This account will be skipped when automatic mail retrieve
         (set by timer) will occur.
         This account will be checked only if you initiate mail retrieve
         manually.

      - Download to Preview
         This allows previewing messages for a certain amount of time
         (set in the Timers configuration page) without them becoming
         marked as \"read\" on the server.

    Global options:

     - Locking
        Those two options sets the method XFMail uses in order to 
        lock the mailbox.
        Note: those options affect not only spool folder, but all
        folders of type \"MBOX\".

@C1@b       WARNING!!! Deselecting both options will disable locking
@C1@b       completely. This can result in folder corruption and even
@C1@b       mail loss!!! Make sure that at least one of the selected
@C1@b       locking options actually works on your system.

        - Dotlock
           XFMail will attempt to create file <folder>.lock
           (where <folder> is a path of your folder (spool)) in order
           to lock the folder. This locking method will not work if you
           don't have write permissions in the directory where the
           folder resides.

        - Kernel lock
           XFMail will use flock() (or lockf() , depends on the OS)
           system call for folder locking. This locking method is
           supposed to work if your OS supports file locking.
           However it can fail if the folder is located on NFS
           filesystem, and rpc.lockd is not running
           (or not functioning properly).

        Note: If 'Kernel lock' is selected XFMail will always fail
        to access the mailbox if it fails (even if dotlock succeeded).
        However if both 'Dotlock' and 'Kernel lock' are selected and
        'Dotlock' fails because of lack of write permissions in folder's
        directory , XFMail will procede normally.

     - Check mail on Startup
        Check for new mail immediately on application startup.

     - Show results
        If selecting \"Retrieve Mail\", show a popup that informs you, how
        many messages were received.

     - Global Password Encryption 
        (This option is only available if XFMail is compiled to use the
        libmcrypt encryption library).   Selecting this option will allow
        all your Mail Receiving Account Passwords (and any SMTP
        account passwords) to be encrypted with a \"Passphrase\" you will 
        be prompted for when you first select this option, and
        each time you subsequently start XFMail.  To change the
        Passphrase, deselect, then reselect, Global Password Encrytion
        and enter a new \"Passphrase\".

@C1@b       WARNING! XFMail does not store this \"Passphrase\"and if 
@C1@b       you enter it incorrectly when XFMail starts, all the stored 
@C1@b       passwords may become corrupted, and will need to be 
@C1@b       re-entered using the account configuration dialogs.

     Sound settings:

     - No sound
        No sound will be played.

     - Beep
        Produce a beep sound after new mail is received.

     - Sound file (AU)
        Play the specified *.au file through the audio system.
        Make sure that /dev/audio exists and is properly 
        configured.

     - Sound command
        Run specified command in order to play sound.

%Config-Spool

     Defines properties of local mailbox account.

     - Spool file
        Location of the mailbox

     - Leave messages in spool
        If selected, all messages will be left in the spool file
        even after they are retrieved by XFMail. Useful if you want
        to share your spool with other e-mail clients.

     - Rewrite spool periodically
        If this option is set, XFMail will rewrite your spool mailbox
        in order to store changes.
        If this option is not set, you will be asked to save changes
        at the end of the session , or when you close the spool mailbox.

        Note: this option has no effect if \"Leave messages in spool\"
        is not set.

%Config-Send

 - Send

    Controls SMTP and sendmail parameters.

    First you need to specify a message sending method:

    - Sendmail
       XFMail will execute the sendmail program every time it wants
       to send mail. Check that your sendmail is properly configured,
       and its path is correct.

    - POP
       XFMail will try to send mail through your POP server using
       XTND XMIT command.

@C1@b       WARNING! This command is not part of RFC
@C1@b       and most POP servers do not support it.

        You need to specify the name of POP account which will be used
        for sending e-mail in the box at the right of this option.

    - SMTP Host(s)
       Host name of your mail gateway. This can be a DNS name ,
       an IP address, or the name of a SMTP host account you have
       configured (see below).
       
       Multi SMTP Host configuration:

       [[mailfrom+smtpserver,][...]],defaultsmtpserver 
       
       Below is an example that uses the smtp server of smtp.lan.my.com
       for all mails from ast@my.com and smtp server smtp.mail.yahoo.com for
       all mails from private@yahoo.com.

       If the from field of the mail doesn't match any of these addresses the
       default smtp server localhost is used.

       Note that the address match is done on substring basis so \"ast@my.com\"
       matches \"A.  Steinmetz <ast@my.com>\".

       ast@my.com+smtp.lan.my.com,private@yahoo.com+smtp.mail.yahoo.com,localhost

    - Configure SMTP Host Accounts
       This button opens a dialog for maintaining a list of SMTP Host 
       Accounts,  usually for SMTP servers that require authentication.  
       If you use \"Multi SMTP Host configuration\", you may 
       also wish to create a list of  SMTP Host Accounts so you can refer to 
       them in the SMTP Hosts box by a short account name of your choosing, 
       instead of their full DSN name or IP address, and also enable/disable 
       them.
       
    - Port
       The SMTP port number.  Default is smtp (usually 25).

    - Sendmail path
       The location of sendmail program (or any other program
       used to deliver e-mail on your system).

    - Options
       Parameters passed to mail delivery program. You don't need
       to change this if you're using sendmail.

    - DSN options
       Parameters passed to mail delivery program when DSN is used.
       Read sendmail documentation for more details.

    - Send on bg
       Invoke sendmail in the background.

    - Send offline
       Instead of immediate sending, messages will stay in the outbox
       until they are sent by the Send All timer or the send button.

    - Bcc to myself
       Every sent message will be Bcc'ed to the author.

    - Save to 'sent mail'
       Every sent message will be copied to the 'sent_mail' folder unless an
       outgoing rule is matched.

    - SMTP log
       Log SMTP protocol negotiation in XFMail logger.

    - Use DSN
       Enable use of Delivery Status Notification extension
       of ESMTP protocol. Make sure that your SMTP gateway
       (or sendmail program) supports this option before enabling it.

%Config-SMTP

 - SMTP Server Accounts
    In this dialog, you can maintain a list of a SMTP server accounts:

    - Add  
       Creates a new account, and prompts for a short name used by XFMail 
       to identify it, then opens the configuration dialog.

    - Edit
       Allows you to modify the configuration of the selected account.
       
    - Delete 
       Deletes the selected account.

    - Account disabled
       Toggles a setting that disables/enables the selected account.
       (A disabled account is skipped when the main SMTP Hosts list is
       processed.)

%Config-SMTPacct

  - SMTP account configuration.

    - Host
        Specify the hostname of the SMTP server by DNS name or IP 
        address. If you set up a secure tunnel (e.g., by using the 
        \"stunnel\" program) from a local port on  your computer to 
        the remote secure SMTP server, you should enter the local 
        host name (usually \"localhost\" or 127.0.0.1).
      
    - Port
        The port or service name to use (the default SMTP port is 25).
        Some secure SMTP servers may use a special port for authenticated 
        SMTP, but this is now discouraged.   If you set up a secure tunnel 
        from your computer to the server, enter the local port number that 
        you connected the tunnel to, not the port used by the remote SMTP
        server.

    - Server requires Authentication
        Select this if the Server requires Authentication.   If it is not
        selected, the Username/Password entries will not be saved.
        If you do not provide Username/Password, a popup box will ask for 
        them each time you connect to the Server.
    
    - Use Username/Password from POP/IMAP receive account.
        If the Username and Password required by the SMTP server are
        identical to those used by one of your POP or IMAP mail receiving
        accounts, select this button, and enter the short name you used to
        identify the POP/IMAP account in the Receive dialog.

     - Username
     - Password
        If the Username/Password are NOT taken from a POP/IMAP 
        account, enter them here.

     - Save Password.
        Save the password 
        (in the hidden .xfmsmtp_accts file in your .xfmail directory).  
@C1@b       WARNING! WARNING This is a VERY insecure option, unless 
@C1@b       you enable global password encryption (in the Receive dialog).

%Config-Appearance

 - Appearance
    Allows you to change the look of different windows and dialogs 
    in XFMail. You can change the font, font size, background and
    foreground colors.

    You can add/remove different fonts using this dialog.  The top
    part of the dialog will show some sample text in the chosen font.

    The bottom part is divided into three panes:

    - the rightmost pane lets you select the element you want to
      customize. Not all elements allow changing of all attributes
      and not all attributes affect the elements' look the same way.

      For charset elements (us-ascii and below) you can change only
      font and font size. They will be used by the message viewer and
      editor when displaying the appropriate MIME messages. The colors
      of the message viewer and editor are set via the \"Message
      viewer\" and \"Message editor\" elements.
      \"Message Viewer\" also controls colors of the preview pane (if shown).

      For the \"Folder browser\", \"Message browser\", \"Folder
      chooser\", and \"Address book\" elements, foreground color
      affects only the color of the selection bar and not the text
      itself.

    - The middle pane allows you to choose the font size.

    - The leftmost pane selects the font associated with the
      element. There are 16 fonts in the list which cannot be
      deleted. You can add more fonts using the \"Add\" button. Press
      \"Add\" and then enter the full X11 font name in the input box.
      Up to 16 user-specified fonts can be added.
      The \"Delete\" button will delete the last font in the list.
      A font cannot be deleted if it's used by one of the elements.

%Config-Display

 - Display.
    This dialog has two parts.

    The left part defines the message pane sort order, sort type,
    and the size of the various message information line parts.

     - Size
        Sort by the size of the message.

     - Rcv Time
        Sort by the time the message was received.

     - Snd Time
        Sort by the time the message was sent.

     - Recipient
        Sort by recipient of the message.

     - Subject
        Sort by subject.

     - Author
        Sort by author's e-mail address (From field).

     - Priority
        Sort by message priority (Low, Normal, High, etc...)

     - No Sort
        Do not sort the messages.

     - Ascend
        Ascending sort order.

     - Descend
        Descending sort order.

     - Thread
        Thread folder (hierarchically).

   You can define the length of each part of the message line (for
   a description of the parts, see the section entitled \"The Message
   Pane\"). A zero length means that specific part will not be
   displayed at all in the pane.

   Colors of different folder types can be changed as well by
   clicking on colored boxes inside 'Color of' frames.
   In addition the color of each folder can be changed through
   'Folder options' dialog.

   The right part of this dialog defines the appearance of the
   folder list in the same manner as the message list.

%Config-Faces

 This dialog deals with configuring the faces support:

 - Faces Config
      Controls the display of faces and picons.  There is support
      for the X-Face: message header and a picons database.

   - Picons path
      The path to your picons database.

   - My Face
      The location of the author's face icon. This icon should be
      in xbm format and with dimensions of 48x48. If it is specified
      and exists, it will be automatically attached to every outgoing
      message. And also it will be displayed below this input field.
      You can create xbm files with the bitmap program that comes
      with most distributions of X.

   - Display faces
      If selected, XFMail will display faces on the message view
      dialog, otherwise the XFMail logo will be displayed.

   - Update database
      If XFMail receives a face that does not exist in the
      picons database it will try to update the database.
      Note: you should have write permission in the database
      directory.

   - Check bitmap first
      If a picons database contains both xpm and xbm icons for 
      a specific e-mail address, xbm will be used.

%Config-Timers

 - Timers
      Controls different timers.

    - Retrieve mail every
       How frequently new mail should be retrieved (either from
       the spool , POP or IMAP).

    - Send all every
       XFMail will periodically try to send unsent messages from
       the outbox folder.

    - Empty trash/Expire every
       The trash folder will be emptied this often (set to 0 to
       disable the auto-empty feature).
       In addition all messages which has been expired will be deleted.

    - Autosave every
       Your unfinished messages will be periodically saved.

    - Send IMAP NOOP every
       Sets how frequently NOOP command will be sent if you're
       connected to IMAP server. NOOP keeps the connection alive
       and also polls server for new messages and changes.

    - Forget PGP passphrase every
       XFMail remembers the PGP passphrase so you will not have to
       enter it every time.
       This timer will cause XFMail to forget the passphrase if it was
       not used in specified amount of time.

       Set this timer to 0 if you want the passphrase to be forgotten
       immediatly after it was entered.
       (you'll have to enter it every time in this case).

       Set time to the maximal value (180) if you want the passphrase to be
       remembered permanently.
@C1@b       WARNING! WARNING! This is a VERY insecure option.
@C1@b       Make sure that no one has access to XFMail while it's running.

    - Mark message as read after previewing for
       Previewed message will loose its unread status after specified
       amount of seconds.
       Setting the timer to 0 will cause the message to become unread
       immediatly.
       Setting the timer to 60 (max. value) will cause previewed message
       to retain its unread status indefinitely.

    - Only when iconized
       The timers will be activated only if the application is iconized.
       This is useful if you don't want to be interrupted when you
       read or edit e-mail.
       This option affects only Retrieve ... , Send ... and Empty ...
       timers.

%Config-MIME

 - MIME
      Acts as a mailcap file. As such, this dialog defines MIME types
      and subtypes and associates them with external programs and file
      extensions.  Some types are handled internally. The MIME database
      is stored in the <configdir>/.xfmime file. System-wide MIME
      database is stored in /etc/xfmime. The first input box is where
      you enter the MIME type, and the second is where you enter the
      MIME subtype.  The third input box should contain the extension
      that this MIME type usually carries.  The last input box is the
      external program to associate the MIME type with.  For example,
      the program used to view attached graphics files. File argument
      can be specified by %s. If it's not specified file name will be
      appended to the command name.

      A */* entry defines the default attachment viewer. By default
      XFMail uses its internal text viewer for that purpose.

   - Add/Modify
      Adds new mailcap entry, or changes associated information for 
      an existing entry. Entries that are handled internally cannot
      be changed.

   - Delete
      Deletes a MIME type entry. Internally handled entries cannot
      be deleted.

   - Save
      Saves all entries to your <configdir>/.xfmime file.

%Config-repfwd

 - Reply/Forward
     This dialog customizes the look of replies and forwarded messages.

   - Precede with (reply)
      Defines a string that will be prepended to the original message in
      the reply. The following variables are recognized in the reply
      string:
      
      %f - The from field of the original message
      %i - The message-ID of the original message
      %s - The subject of original message
      %t - The time when the original message was sent
      %d - The date when the original message was sent
      %n - Replaced with a CR (carriage return)
      %% - Replaced with %

   - Include original
      Defines how the original message should be included in your reply.

      - no auto include
         Original message is not included at all. You can manually
         include it from inside the message editor instead.

      - indented
         A prefix is added before every line of the original message,
         usually, this is a > character.

      - not indented
         The original message is included as is.

   - Prefix with
      Defines a prefix that should be added before every line of the
      original message in a reply if the \"indented\" method is
      selected.

   - Exclude myself
      Excludes your e-mail address from the reply list.  This works only
      if your e-mail address in the list matches the From field as
      defined in the Misc configuration dialog.

   - and
      You can specify a comma-separated list of e-mail addresses
      which will also be excluded from the reply address list.
      This is useful if you have many different e-mail addresses
      which are being forwarded to a single mailbox.

   - Include all recipients
      If the message has more than one recipient:

      - Never
       Include only sender and omit all other recipients.

      - Always
       Always include all recipients in reply.

      - Ask
       You will be asked whether or not to include all recipients
       every time you reply to or forward a message.

   - Include attachments
      If the message contains MIME attachment(s):

      - Never
       Only the text part of a MIME message will be included in the reply.

      - Always
       Copy all MIME attachments to the reply message.

      - Ask
       You will be asked every time you try to reply to such a message.

   - Keep original charset end encoding
      Your reply will have the same character set end encoding as the
      original message.

   - Keep in original folder
      Your reply message, after it's been sent, will be stored in the same
      folder as the original message.

   - Save all addresses i reply to
      From address of every message you reply to, will be saved to the
      address book.

   - Precede with (forward)
      The string that will precede a forwarded message. It may contain
      the same variables as the Reply string.

   - Include header
      Controls which part of the original mail header will be included
      in a forwarded message.

      - do not include
         The header is not included.

      - short
         A short header set will be included (From, To, Cc and
         Subject fields).

      - full
         XFMail will precede a forwarded message with all of the
         header information from the original message.

      - MIME
         Include the whole original message as a MIME attachment.

%Config-Charset

 - Encoding
    This dialog allows you to setup MIME parameters which are
    responsible for language definitions.  In this manner, you can
    view messages written in other languages.

    - Default Encoding
      You can choose an encoding method that will be applied
      to the message body, Subject, and all addresses before the 
      message is sent.

    - Encode header
      If this option is set, XFMail will try to encode Subject
      and address lines in the message header which contain 8-bit
      characters with RFC1522 MIME encoding.
      Note: many e-mail clients don't understand RFC1522.

    - Default character set
      Chooses the character set to be used in MIME headers
      and also by the message viewer/editor. You need to assign
      a language specific font to the charset in the Appearance
      dialog in order to make it display correctly.

%Config-IMAP

 - IMAP
     IMAP server configuration.  This allows you to store folders
     on a remote machine.

     - Host
        The IMAP server host name (or IP address).

     - Port
        The IMAP server port number (or service name). Typically
        IMAP is on port 143, and IMAP-SSL on port 993.  You may
        need to check with your service provider.

     - Username
        Your IMAP username.

     - Password
        Your IMAP password.

     - List extra
        A space separated list of folder hierarchies. XFMail will
        LIST every hierarchy when it connects to the IMAP server. If
        this field is left blank then the default \"\" hierarchy will
        be used. Each hierarchy name can be prefixed by special flags
        which affect the way XFMail will deal with the hierarchy.
        Flags are separated by comma, and separated from the string
        by ':' . Currently two flags are supported:
        - LSUB
           LSUB command instead of LIST will be used. Needed
           when you have subscribed folders and you want them to
           appear in the list of your IMAP folders.

        - NOSCAN
           Folders which belong to this hierarchy will not be rescanned
           on startup. Useful if rescan of folders of some specific type
           is slow.

        Example: if you want to read your newsgroups with Washington
        university IMAP server, use the following string:
            LSUB,NOSCAN:\"{my.news.server/nntp}#news.\"
        (replace my.news.server with your newsserver DNS name).
        If you want to access your XFMail MH folder from remote system
        and Washington IMAP server is installed on the system on which your
        folders are located, put \"#mh/\" (without the quotes) into this
        field.

     - Autoconnect
        XFMail will connect to an IMAP server at startup.

     - Store password
        Your IMAP password will be stored in the configuration
        file.

@C1@b        WARNING! This is a very insecure option! Make sure
@C1@b        that no one else has read/write access to your .xfmailrc.

     - Use trash
        When the deletion of an IMAP message is requested it will be
        moved to the remote trash folder instead.

     - Cache messages between sessions
        If IMAP folder is cached , the cache file will not be deleted
        after you disconnect from the IMAP server, so next time you
        connect the rescan will be much faster.
        Use this option carefully since XFMail can not always determine
        if the message has been changed on the server.

     - Log session
        Log all IMAP negotiation in XFMail's internal log.

     - Don't expunge automatically
        XFMail will not automatically issue EXPUNGE command on folder close.
        You can expunge messages manually by either selecting 'Expunge'
        option in 'Folder' menu, or by right-clicking on delete button.

     - Retrieve mail
        XFMail will attempt to retrieve new messages from INBOX on the
        IMAP server.

@C1@b        WARNING! Usage of this option is highly discouraged.
@C1@b        It's better to access your IMAP messages directly on the server
@C1@b        than retrieve them to your local system.

     - Single quotes delimit strings
        RFC 2060 states that quoted strings are separated with double
        (\") quotes, but there might be some servers that don't follow
        this standard and use single (') quotes to delimit quoted
        strings. If XFMail gives error messages about parsing IMAP
        responses than try this option. If this option helps, please
        report your IMAP server details to the XFMail developers so
        that we can determine if this is an actual problem.

     - Use SSL
        Have XFMail negotiate an SSL session with this IMAP server.  

@C1@b        NOTE!  If you use this option, you may need to change the port.
@C1@b        Please see the above note about the port option.

%Config-NEWS

  XFMail can post messages to USENET newsservers, by using NNTP protocol.

@b@i  Note: reading news is not implemented in this release

  - NNTP Host (News server)
     Your newsserver (hostname or IP)

  - Port
     Newsserver (NNTP) port. In most cases it's 119.

  - Username
  - Password
     Fill those fields if your newsserver requires authorization

  - Authorization required.
     Some newsservers require username and/or password to log in.
     Most servers request the username/password through NNTP protocol
     and this option should not be selected. However some servers require
     user-initiated authorization. In this case you should select this
     option.

  - NNTP log
     Log NNTP negotiation through XFMail logger

  - Store password
       Stores your NNTP password in the configuration file
       so you will not need to enter it every time you start 
       XFMail.

@C1@b       WARNING! WARNING! This is a VERY insecure option.
@C1@b       Your password will be stored in the configuration file
@C1@b       as is, without ANY encryption. Make sure that no one else
@C1@b       has read/write access to the file (use chmod to change this).

%Config-LDAP

  -LDAP Config
    LDAP (Lightweight Directory Access Protocol)

     - LDAP Host
         Enter the URL (Domain-style name or IP number) of the 
         LDAP server you wish to connect to.  An example would be
	 directory.vt.edu.

     - Port
         Specify the port used by the LDAP server on the host.
         (usually 389)

     - Server Root
         Specify the default base DN to use when performing LDAP
         operations.  The base must be specified as a 
         Distinguished Name in LDAP format like  ou=people,dc=vt,dc=edu.

     -Maximum Reponses to be Collected
         This will limit the number of results the LDAP server
         will attempt to report.
  
%Config-PGP

  - PGP Config
     PGP (Pretty Good Privacy) configuration.

     Note: Some PGP operations will require a pass phrase. The pass phrase
     will be stored in memory in encrypted form.
     For more details check Timers^Config-Timers

     - PGP program
        The location of the PGP program binary. You should install
        PGP version 2.6, 5.0 or GnuPG 0.9.5 or later in order to use 
        XFMail's PGP support.

        Note: if you're using PGP-5.0 you should specify the location
        of the 'pgp' program. XFMail assumes that pgpk, pgpv, pgps
        and pgpe are located in the same directory.

     - Alternate Keyring
        Specifying an alternative keyring allows PGP to lookup public keys
        not only in your own public keyring. You must enter the full
        path to the alternative keyring file here.

     - PGP Key Server
        XFMail also is able to lookup keys from one of the key servers, that
        support HKP (Horowitz Key Protocol).
        HKP was introduced in PGP-5.0 and it's implemented as a subprotocol
        of HTTP. The following did work last time I checked:

          wwwkeys.pgp.net
          wwwkeys.ch.pgp.net
          wwwkeys.de.pgp.net
          wwwkeys.dk.pgp.net
          wwwkeys.nl.pgp.net
          wwwkeys.eu.pgp.net

        (All these servers listen on port 11371 and answer requests of the
        form \"GET /pks/lookup?op=get&search=0x<Key Id>\\r\\n\")

     - PGP User ID
        If your user name doesn't match your PGP User ID, you
        should enter your PGP User ID or the keyID (with
        preceding 0x) here, with which you plan to sign your 
        messages.

        See also Address Book^AddressBook

     - Autosign
        Selecting this option will cause XFMail to sign every
        outgoing message with your PGP signature.
        Note: this option can be switched on/off for every message
        in the message editor.

     - Use alternate Keyring
        Enables use of an alternative public keyring file.

     - Use PGP Key Server
        Enables PGP keyserver lookup.

     - PGP method
        There are a few different standards for using PGP with e-mail.
        XFMail supports three of them:

        - Text
          Only the textual part of the message will be signed/encrypted.
          The message format will be unchanged and the encrypted/signed part
          will be presented exactly as created by the PGP program itself.
          This is the simplest method. Such messages can be simply
          handled as any PGP encrypted/signed file.

        - application/pgp
          The encrypted/signed text will be wrapped in an application/pgp
          MIME part. Message format will be changed accordingly and
          the textual part will no longer be visible. It can be
          manipulated by MIME functions instead.
          This method was widespread, until RFC2015 appeared.
          It can handle only text messages (parts).

        - Multipart
          The whole message will be encrypted (signed) and converted
          to multipart/encrypted or multipart/signed as specified
          in RFC2015. This is the best method, unfortunately not
          many e-mail agents support it yet.

%Config-Int

  This dialog has two parts:

  - Charsets
         Displays information about MIME character sets known to
         XFMail. The information displayed consists of:

         - Character set name
            The name of the charset. Matched against the \"charset\"
            parameter in the Content-Type MIME header field.

         - Character set description
            Short description. Usually indicates with which language
            the charset is being used.

         - Alias of
            Each character set can have an alias. Charset aliases
            are necessary if you receive a lot of e-mails with unknown
            (to XFMail) charsets.

         - Size
            Font size used when displaying text with this charset.

         - Style
            Type of font used when displaying text with this charset.
            For the list of available styles see the end of the
            \"Advanced XFMail Customization\" chapter.

     Buttons:

     - Add alias
        Allows you to create an alias for the selected charset.

     - Delete alias
        Deletes the selected alias.

  - Encoding (control MIME language parameters)^Config-Charset

%Config-Folders

 This dialog controls some folder-specific options.
 The options (along with some other folder information) are stored
 in <configdir>/.xfmfolders file. Information about IMAP folders is
 stored in <configdir>/.xfmfolders-imap .

 Options:

  - Sort by
  - Order
     Same as in 'Display' dialog.

  - Don't count unread messages
     Unread messages from this folder will not be counted in the total
     number of unread messages (as displayed in main window title).

  - Don't move to trash
     When you delete a message from a folder with this option set the
     message will be deleted immediately instead of being moved to
     trash.

@C1@b     WARNING: this option is dangerous!! After you have deleted a 
@C1@b     message there is no way to restore it.

  - Display with color
     Color to display the folder with in the folder pane.

  - Cache messages
     Internal DBM cache will be used to speed up folder rescan.

  - Check periodically
     XFMail will check if the folder has been modified, and if yes,
     it will retrieve all the new messages. The check will be performed
     every time new mail is retrieved.

  - Display recipient
     First member of the To address list will be displayed instead
     of From.

  - Delete messages older than
     Enables message expiration. All messages older than a specified
     number of days, will be automatically deleted. Set the value
     to -1 if you want to disable expiration in this folder.
     Expired messages will be deleted either by Empty trash/Expire
     timer, or when you open the folder.
     You can set 'never expires' option on any message in order to
     protect it from being expired.

  - Don't validate messages
     If set, and folder is cached, XFMail will not check if cache
     information for each message is valid. This significantly
     speeds up folder rescan time, especially for folders located
     on NFS filesystems.

@C1@b     WARNING: make sure that folder is not modified/accessed by
@C1@b     any other application, otherwise information displayed
@C1@b     in message pane can be incorrect!!

     Setting this option only makes sense for MH folders.

  - Description
     Short description of folder functionality.

  - Alias
     Alternative folder name (can contain spaces) which will
     be used in folder pane instead of folder's true name.

  - Default From:
     'From:' e-mail address which will be used instead of one defined
     in 'General' dialog.
     The address will be used when you create a message and such
     folder is your current folder, or when you reply to a message
     located in such folder.
  - Default To:
     Similar to Default From:, except will fill in the To: address
     in the new message. Only has an effect for new messages, not
     replies or forwarded messages.

  'Set default' button restores default color and sort order.

%Config-Messages

 This dialog is just a more convenient way to set some message
 options.

 - Unread
    Message is unread.

 - Signed
    Signed (signature attached).

 - Forwarded
    Was forwarded to other recipient.

 - Replied
    Reply to the message was sent.

 - Marked
    Marked (with color and + in message list).

 - Never expires
    If set, this option prevents the message from expiring.

%Config-Keymap

 This dialog allows remapping of most keyboard functions of the
 internal editor. The configuration is stored in <configdir>/.xfmkeymap 
 (only information about remapped keys is stored).

 Each input box contains a comma-separated list of keys bound to a specific
 editor function. You can have up to 4 keys in the list. The correct name
 of any key can be obtained by pressing the key in the 'Test' input box. 

 The 'Set default' button will reset mappings for the currently selected
 function to the default.

%Config-Ispell

 This dialog controls the behavior of an ispell session. The Language
 section determines the language with which ispell is driven. 

 - Use default language
    ispell will use the default language for spell checking

 - Use alternate language
    ispell will use the language specified in the input field. If the
    language isn't installed, ispell will complain at the start of spell
    checking.

 The Global Options control parameters that aren't directly connected with
 the ispell session itself.

 - Path to ispell program
    The full path to the ispell program (defaults to /usr/bin/ispell).

 - Ignore cited text
    Cited text (text that is marked as included) isn't spell checked if
    this button is checked.

 The Ispell Options section allows you to set some command line switches to
 ispell.

 - Treat run-together words as legal
    Words like \"helloall\" aren't treated as an error; should be set for
    languages (like german), where it is not unusual to build new words by
    composition of other words. \"Wolkenkratzer\" for example is only
    recognized as a composed word.

 - Use latin1 input encoding
    Use formatter latin1; allows umlaut characters to be recognized. This
    option isn't valid for english text.

 - Use alternate personal dictionary
    If you want to use a personal dictionary, check this button and enter
    the path to your dictionary. At the end of a spell session, the
    dictionary will be saved.

 - Extra special chars allowed in words:
    This option  may be used to specify characters other than
    alphabetics which may also appear in words. For instance, specifying
    \"&\" will allow \"AT&T\" to be picked up.

%Config-Header

 You can define up to 16 additional header fields, that will be
 added to any message sent by XFMail.
 Contents string can contain %d and %t for date and time respectively.
 You cannot use here any headers with special meaning (like To, From, ...),
 but Cc, and Bcc can be used. In that case the Contents should
 represent a correct, comma-separated address list.
 Defining a Subject field will create a default subject for all messages.

 In addition you can define fields with name SubjectX where X is a digit
 from 0 to 9. Those subjects will appear in Subject pop-up menu in the
 message editor.

 It's strongly recommended that only headers with names starting with
 X- be defined here.

%Rules

@N@C4@c@b@lFiltering rules

 XFMail can perform certain actions on incoming and imported mail
 messages according to a list of rules. Each rule specifies a regular
 expression that should match a specified field in the message header.
 If the expression matches then the action associated with the rule
 will occur.  Incoming messages are checked against the rules in the
 order they are listed in the dialog.

 You can change the order of the rules by using the two arrow buttons
 located at the right of the rules list.

 Input fields:

 - Rule Name
    The name of the rule. Each rule must have a unique name.

 - Text
    The regular expression (or substring if XFMail was compiled without
    the regexp library) to match.

    If Flags was chosen as the message part to search in,
    then you can enter flag names as specified in the
    Search dialog^Search

    If message part is an address (To/Cc/Bcc/Sender/Recipients)
    the text will be compared with different address parts separately
    (first with address itself, then name and then comment)
    without the parentheses (either () or <> ).
    This means that text like <user@somewhere.com> will NOT
    match the address: Joe User <user@somewhere.com>
    (however text: user@somewhere.com will match).

 - In
    The field in the message header to check for a match using the
    regular expression (you can choose a field name from a list of
    common names at the right of the input field).

 Rule actions:

 - Move
    Name of the folder to move to if the message matches the rule

 - Forward
    Where the message will be forwarded. The $sender and $from macros
    will be replaced by the corresponding value from the original message.
    You can specify a comma separated recipient list. Alias names can be
    used.

 - Resend
    Like forward, but the message will be unchanged
    (except for recipients list).

 Forward and Resend recipient lists can contain newsgroups. Newsgroup
 name should be prefixed with '#news.'.
 Example: xfmail@Burka.netvision.net.il,#news.comp.mail.mime
 will send message to XFMail mailing list and post it to comp.mail.mime .

 - Respond
    The incoming message will be deleted and a reply will be sent
    to the sender. You need to specify a file name that will be used
    as the message body. If the first line of the specified file
    starts with 'Subject: ', then its contents will be used
    as a subject for the reply (any % directives can appear in this
    line as defined in the Reply/Forward configuration dialog).
    Otherwise the subject will be \"I'm on vacation (RE: %s)\"

 - Execute
    If the received message matches the rule, the specified command
    will be executed with the received message as standard input..

 - Discard
    Delete the message.

 Rule type:
 - Incoming
    Applied on all incoming messages.

 - Outgoing
    Applied on all messages being sent by XFMail.

 - Special
    Rules of this type will be used to move messages
    when you click with the right mouse button over the 'move'
    button in the message viewer.

 Rule options:

 - Case sensitive
    Toggles whether or not the regular expression is case sensitive.

 - Keep messages
    If the \"respond\", \"forward\" or \"execute\" rule matches,
    XFMail will keep the original message instead of deleting it.
    The message will be moved to a folder according to existing rules
    (or to the inbox if there are no rules which match this message).

@C1@b    WARNING!! If you do not select this option, the message will be
@C1@b    lost after executing a rule of the types mentioned above.

 - Save addresses
    When a new message matches a rule with this option set, all addresses
    from the From, To, Cc and Bcc fields will be added to the address book.
    If this option is not set then the addresses from matching messages
    will not be saved even if the global option \"Save All Addresses\"
    is set.

 - Mark read:
    Matching message will not be marked as unread.

 - Don't notify
    New messages that match rules with this option set, will not
    trigger new mail notification (as configured in 'Receive' dialog).
    Note: if during one 'retrieve new mail' session new messages
    match different rules in which this option is set differently,
    the notification will still take place.

 - Log
    When the rule matches, an appropriate line will be added
    to XFMail's log.

 - Modify message
    Used only with \"Execute\" rules. If set then standard output
    of the specified program will be used as a replacement of the
    original message.

@C1@b    WARNING!! Your program should produce a valid message
@C1@b    and return exit status of 0, otherwise this option
@C1@b    will not work, and may even cause damage to the message.

  Buttons:

 - Add
    Add a new rule.

 - Delete
    Delete the selected rule.

 - Modify
    Modify the selected rule.

 - Folder
    Choose a folder to move the matching messages to.

 - Addr 
    Choose an address from an address book to forward the matching
    messages to.

 - File
    Allows you to choose either the file to be used by 'respond' or
    the script to be used by the 'execute' rule.

 - Load
    Load rules from <configdir>/.xfmrules.

 - Save
    Save rules to <configdir>/.xfmrules.

 - New
    Clears all input fields.

 - Ok
    Exit the rules dialog.

%Viewmsg

@N@C4@b@l@cView Message

You can view any message by double-clicking on it or by selecting it
and pressing the view button (or choosing the view option from the menu). You
cannot view a message that is already being viewed or edited (i.e.
a locked message). Also, you can't view/edit more than 15 messages at
at a time. The view window consists of a menu, a button bar, a set of
header information fields, and the message body browser.

If the message body is located on the POP server you will be asked
if you want to retrieve it each time you open that message.

Using the Appearance configuration dialog, you can customize the
fonts, font sizes, and background and foreground colors used by the
message viewer. XFMail will use the settings for the character set
of the displayed message. If XFMail cannot determine the character
set in the message, the default (Message Viewer) settings will be
used. The background and foreground colors apply to all character
sets and cannot be set on a per-language basis.

Custom fonts are also supported in the Subject and From fields.
When displaying those fields XFMail will check if they are encoded
in RFC1522 MIME format and display them properly according to the
charset definition. This will not work with multibyte character
sets (like Korean or Japanese).

The recipient list will also be decoded, but font changes will
not be applied to it, so there is a chance that addresses
will appear as an unreadable sequence of 8-bit characters.

The MIME attachment line at the bottom will inherit its settings
from the main window. This means that if the attachment name uses
the same language as the message body, it will be displayed correctly.
The MIME attachment area can be resized by dragging the separation bar
between the text and MIME areas.

In the message body browser you can navigate with the normal cursor keys:
PgUp, PgDown, CTRL+Home, CTRL+End, etc. Use CTRL+F and CTRL+G to search for
text.

 Overview of button pad functions (from left to right):

 - Exit viewer
    Corresponds to the File/Exit menu.

 - Previous unread message
    Displays the next message that is unread and located in the folder
    before the current displayed one (according to the sort order).
    It does nothing if such a message does not exist.

 - Previous message
    Displays the previous message in the folder.

 - Next message
    Displays the next message in the folder.

 Note: if you're viewing a message which is a part of a digest
 XFMail will attempt to switch to next/previous message inside the
 digest (and not in the folder).

 - Reply to message
    Generates a reply to the currently displayed message.
    Clicking with right mouse button generates reply only to sender.
    If some part of the text is selected, then only selected text will
    be included in reply message.

 - Forward message
    Forwards the currently displayed message.
    If some part of the text is selected, then only selected text will
    be included in forward message.
 
 - Move to another folder
    Moves the message to another folder and displays the next message.
    If there is no next message, the view window is closed.
    If clicked with the right mouse button, XFMail will try to match
    the message against 'Special' rule and, if successful,
    will apply the rule on the message. If there is no match then
    the list of folders will be displayed. 

 - Delete
    Deletes the displayed message (i.e. moves it to the trash folder).
    The next message is displayed or if it does not exist, the window
    is closed.

 - External viewer
    Launches an external viewer on the displayed message. By default,
    only the body of the message is shown.  If you click with the
    right mouse button, the external editor will show the whole
    message. The message header will also be shown if the \"Show Header\"
    option in the message menu is enabled.

 - Print
    Print the message using the configured print command.

 - Abort
    Same as abort button in the main window.

 - Help
    Displays this text

 Menu overview:

 - File

   - Exit
      Exit (close) view window.

 - Message

   - Show Header
      Displays the entire message header in the body window.

   - Save From Field
      Adds From address to the currently selected address book.

   - Uudecode
      Uudecodes the message if it contains uuencoded parts.

   - Save All Addr
      Saves all e-mail addresses from the recipients list into the
      currently selected address book.

   All other entries perform the same functions as they do in
   the main menu.

 - Attachment

   - Save
      Save a MIME attachment to a file.

   - Save all
      Save all MIME attachments which exist in the message.
      You will be prompted for filenames if those are not defined
      inside the attachment(s).

   - View
      View the attachment using the internal or external viewer as defined
      in the MIME-types configuration dialog.

   - View as
      Brings up MIME selection dialog. Will view the attachment with the
      viewer of MIME type selected.

   - Print
      Print the attachment.  This is supported only for the text/*
      and message/* MIME-types.

 - PGP

  XFMail does not have PGP support built into it.  As such, you must
  have PGP 2.6, 5.0 or greater installed to use these functions.

   - Decode
      Decodes the current message. If the message is encoded with your
      public PGP key, then you can decode it with your private
      key. In this case, XFMail will ask you to enter your pass phrase
      here, if you haven't entered it in the last two hours (this is
      a security feature).

   - Verify
      Verifies the signature of the current message. If the message
      was signed, you can check that the message originates from the
      sender and that the message hasn't been modified. To verify the
      sender, you need the public key of the sender in your key ring
      file.

   - Extract key
      If the message contains the PGP key of a person, you can use
      this item to extract the key from the message and add it to your
      public key ring file.

   PGP honors all environment variables it knows about (except for
   the language option).

 - Language
    Displays the message using fonts associated with the chosen
    charset (charset fonts can be customized in the Appearance
    dialog). The initial charset is chosen by examining the
    message's MIME headers.

 - Help

   - Contents
     Display this help file.

 For more information about the displayed message press F1 (or click
 with the right mouse button over the text).

 The header information fields display the indicated information
 about the message header.

 The icon in the upper right corner can appear as:

  - A face XBM, if the message contains an X-Face header
    and display faces is turned on.

  - An icon from the picons database, if one exists for that user.

  - The XFMail logo. It will be displayed if either the message does
    not have a face or a picon or if display faces is turned
    off. If the message is unread, the full mailbox logo is displayed
    in place of the standard XFMail logo. (How can this happen? :-)

 The displayed date is taken from message's Date: header.
 
 The message browser shows the message body. You can copy text from
 the editor by dragging the mouse cursor over the text.

 If the message contains any MIME attachments they will be displayed
 below the text browser window. Information for every attachment 
 contains:

 - An attachment number

 - The MIME Type/Subtype

 - The encoding scheme (\"unknown\" if unsupported)

 - The character set (\"unknown\" if unsupported)

 - The file name (if the name= parameter exists in Content-Type)

 - The length (if the SizeOnDisk= parameter exists in Content-Type)

 - The description (if Content-Description exists)

 Double-click on the attachment to view it.  You must define a viewer
 for the MIME type in the MIME configuration dialog for this to work.
 If you double-click over the attachment which does not have a defined
 viewer you will be asked if you want to use the default viewer
 (one assigned to */* entry in MIME config.)
 Pressing the right mouse button over the attachment will bring up the 
 attachment pop-up menu.

%Editmsg

@N@C4@b@l@cEdit Message

The Edit window allows you to change the contents of a message and
some of the message header fields. Starting from version 1.0
XFMail has extended the internal message body editor with vertical
and horizontal scrollbars, cut/copy/paste, text search, line and
word wrapping and more.

For a list of keybindings see the Config Misc->View/Edit->Keymap dialog.

An external editor can be configured using the Misc->View/Edit dialog.

The internal editor uses the same method for choosing fonts and colors
as the viewer does. The \"Message Editor\" setting in the Appearance
configuration dialog will be used. By default, XFMail will try to
match the character set and use its corresponding settings.

You should be able to use 8-bit characters in the message body and
in the Subject and From lines as well. In this case quoted-printable
encoding is recommended (see the \"International\" configuration
dialog). XFMail will check if the Subject or From lines use 8-bit
characters and will try to encode them according to the RFC1522 MIME
standard and character set/encoding you are using. This feature was
not tested extensively and may cause some problems.

The editor window looks very similar to the view window.
It appears when:

 - You create a new message (all new messages are created in the outbox
   folder).

 - You pressed reply or forward buttons either in the main window or
   in the view window.

 - You choose \"Bounce\" from the main menu.

 - You choose to edit a message.

Overview of button pad (from left to right):

 - Exit
    Stop editing without sending. You will be asked if you want
    to save the message to the drafts folder or delete it.

 - Send
    Send the message using the default send method. You must specify
    at least one recipient before sending.

 - Insert file
    Allows you to choose a file that will be inserted into the 
    message at the current cursor position.
    Right-click will insert file with header and footer lines.

 - Include original
    Inserts the original message if the edited message is a reply.
    Pressing with the left mouse button will insert the message indented
    and a right click will include it as is.

 - Add signature
    Add your signature to the message. A left click will add the
    default signature (or the best matching), and a right click will
    bring up the signature pop-up menu.

 - External editor
    Run the external editor on the message.
    If you click with right mouse button the whole message
    (with headers and MIME attachments) will be passed to the
    external editor.

@C1@b    WARNING! Make sure that a valid message is produced after
@C1@b    you finish your editing changes! Also don't rename the file.

 - Spell check
    Run the defined spell checker on the message.

 - Attach
    Attach a file as a MIME attachment.

 - Abort
    Stop any network operation.

 - Help
    Displays this help file.

 Header editor overview:
 
 - From
    The From field. You can configure it via the Config/Misc dialog, and
    it contains your e-mail address.
    If you have more than one e-mail address, you may enter multiple comma 
    separated addresses in this field of the Config/Misc dialog.  When
    composing mail, click on the From: label to pop up a window for choosing
    from among the multiple e-mail addresses.

 - Subject
    The subject of the message. A new message will initially have no 
    subject. The subject for replies and forwards will be generated
    automatically from the original subject.
    Clicking on the subject label will open a menu of predefined subjects.
    See Config Extra Headers for more details^Config-Header.

 - To/Cc/Bcc/Nn/Fcc
    Type the recipient's e-mail address in this field and press Enter or
    TAB.  The address will be added to the recipients list below. You can
    choose from To, Cc, and Bcc for the prefix. If you want to enter many
    addresses at the same time, separate them with commas.  If one of the
    entered addresses matches one of the alias names in the address book, it
    will be replaced with the alias member(s) list.
    'Nn' allows you enter newsgroups names (comma-separated).
    'Fcc' allows entering comma-separated list of folders. The message
     will be copied to each folder after it was sent.
    If you want to use folder choosing dialog instead of entering
    folder names manually, type ! as the folder name and press Enter.

 Address book editor buttons:

  - Address
     Allows you to choose an address from your address book(s). To add 
     an address or an alias to the recipient list, double click on it. 
     After you have added all of the addresses you want press Ok.

  - Delete
     Delete the selected address in the recipient list.

   Double-clicking over an address will bring up the address modifcation
   dialog.

 Special checkbuttons:

  - Confirm Delivery
     Modifies the message header so that the recipient's SMTP agent
     will send a confirmation message after a successful delivery
     (not all agents support this feature).

  - Confirm Reading
     Requests the recipient's e-mail client to send a confirmation
     after this message was read by the recipient.
     NOTE: this is a very non-standard option (it's not in RFC822)
     and it will work only for XFMail, Chameleon, some Microsoft
     clients and maybe others.

  - Auto sign
     If set, signature will be automatically appended to the message
     before you send it (if the message was not signed before).

  - PGP sign
     You can turn PGP autosign feature on/off using this button
     (it overrides PGP autosign in the 'PGP' configuration).

  - Priority
     Changes the message's priority. Four different values are allowed:
     Low, Normal, High and Very High.

 Editor menu

  - File

   - Send
      Send the message (Same as pressing the Send button).

   - Queue
      Leave the message in outbox, so it can be sent later
      (either manually or by Send timer).

   - Exit
      Exit the editor (Same as pressing the Exit button).

 - Edit

   - Insert file
      Insert a file (the same as pressing the Insert file button).

   - Uuencode file
      Uuencode and insert a file.

   - Save to file
      Save message text (without header) to selected file.
      If you want to save message with full header and attachments
      use 'Save' button in the main window.

   - Append to file
      Append message text (without header) to selected file.
      File will be created if it does not exists.

   - Sign message
      Add your signature to the message (the same as pressing the Add
      signature button).

   - Quote original
      Inserts the original message if the edited message is a reply
      (the message is inserted with indentation).

   - Spelling check
      Run spell checking on the edited message.

 - Attachment

   - Add
      Adds a new MIME attached file.

   - Delete
      Delete the selected MIME attachment.

   - Edit
      Edit the selected MIME attachment.

 - PGP

   - Sign
      Sign the current message with your private PGP key. Everyone
      having your public PGP key can thus determine that you were the
      sender of the message and that the message hasn't been modified.
      If you have not yet done so, you must enter your PGP passphrase here.
      Note: If you are using pgp-2.6.2ui and signing, and a message appears 
      to \"encrypt\" it, you might want to add a line
      \"Clearsign = on\" to your pgp config.txt configuration file.

   - Encode
      Encode the current message with the public PGP key of all
      recipients of the message. XFMail looks for all recipients that
      are listed with a To: or Cc: destination in the recipient
      window. If PGP can't find all of the public keys needed in your
      key ring file, the message will not be encoded.

   - Sign and Encode
      Sign and encode the current message as described above.

   - Add Key
      Add the public key of a user to the message. XFMail asks
      you to enter the user ID from your key ring file for which 
      PGP should try to extract the key.

   - Decode
      Decode the current message. If the message is encoded with your
      public PGP key, then you can decode it with your private
      key. Therefore, XFMail will ask you to enter your pass phrase
      here, if you haven't done so recently.

   - Verify
      Verify the signature of the current message. If the message was
      signed, you can check that the message originates from the
      sender and that the message hasn't been modified. You therefore
      need the public key of the sender in your key ring file to
      verify the message.

   PGP will honor all environment variables it knows about (except for
   the language variable). And, of course, you must have PGP installed
   to use any of these functions.

 - Language
    Displays the message using fonts associated with the chosen charset
    (charset fonts can be customized in the Appearance dialog). The
    initial charset is chosen by examining the message's MIME headers.

 - Encoding
    Will change MIME encoding of the edited message.
    Supported encodings are 8-bit, 7-bit and Quoted-printable.
    (BASE64 is supported, but it's not used for outgoing mail).
    Default message encoding can be set in the 'International' configuration
    dialog.

 - Feelings
    Inserts some \"smiling\" character sequences into the text.
    Not really useful.

    - Happy
       :-)

    - Sad
       :-(

    - Wink
       ;-)

 - Help

   - Contents
      Opens this help window.

%attach

@N@C4@c@b@lCompose new attachment

When you choose the Add option in the Attachment menu or press the
Attach button on the button bar, XFMail displays the New Attachment
dialog.

 - File
    The name of the file to be attached. You can use the choose button
    at the right to select the file name from a listbox.

 - Description
    The description of the file being attached. You can leave this
    blank.

 - Type and Subtype
    The MIME type and subtype of the file to be attached.  You can
    choose from any of the types that were defined in the MIME
    configuration dialog.

 - Character set
    Select chacter set to be used with your attachment. Setting
    character set makes sence only for text/* attachments.

 - Encoding
    Allows you to change the type of encoding that will be applied
    to the file. 

    - Base64
     The default encoding--highly recommended for ALL types of attached
     files.

    - Quoted-printable
     May be used only on text files that have unusual charsets etc.
     This setting is not recommended for sending binary files.

    - 7bit
     Recommended for text files. Converts the attachments to regular
     US-ASCII text. Don't use this to send binary files.

    - 8bit
     No encoding. The attachment will be added as is, without any
     modification. If you are sending a binary file make sure that your
     SMTP agent supports 8 bit characters in the message body. This
     type of encoding is not recommended.

 NOTE: XFMail will try to guess the right MIME type/subtype and
 encoding type based on the file extension. Also the description
 field will be initialized to the file name. XFMail's guess is not
 always the best one. It is highly recommended to review all the
 parameters before pressing Done.

%Select-Mcap

@N@C4@c@b@lSelect MIME viewer

If XFMail can not handle MIME attachment of selected type it will
display selection dialog with all known MIME viewers. You can either
select one from the list, or enter new viewer program in the input
box below (the format is the same as in MIME configuration dialog).

If the dialog was displayed as a result of 'View as' option, then the
selected viewer will not overwrite the main MIME viewer of this type.

The selected viewer will be used only with the message you're currently
viewing and it will not be stored permanently in .xfmime database.

Use MIME configuration dialog in order to add permanent entries to the
database.

%Search

@N@C4@c@b@lSearch dialog

XFMail allows you to search for specific messages using the search
dialog. This dialog is invoked when selecting the Folder/Search option
from the main window menu.

This dialog gives you the ability to change some options that will
affect the search:

 - In all folders
    Search will be performed in all folders instead of just the
    currently open folder.

 - Case sensitive
    Case sensitive search (upper and lower case matter).

 - Mark folders
    Folders with found messages will be marked with different color.

 - Message part
    Here you can enter a comma-separated list of message parts which
    will be scanned. The parts can be either one of the items in
    the choice list located at the right of this input box, or the name of
    a header field (like X-Mailer).

 - Text (regular expression)
    Text or regular expression to search for in specified message part.
    If Flags was chosen as the message part then you can search for
    the following strings:

    Signed - message with attached signature
    Unread - unread message
    Marked - marked message
    VeryHigh - message with 'Very High' (1) priority
    High - message with 'High' (2) priority
    Normal - message with 'Normal' (3) priority
    Low - message with 'Low' (4 or 5) priority
    Answered - answered message
    Forwarded - Forwarded message
    PgpSigned - message signed by PGP
    PgpEncrypted - message encrypted with PGP
    NoExpire - message protected from expiration

In order to start searching, type the text (or a regular expression)
and press 'Search...'. If you want to exit the search dialog press Ok without
typing an expression.

During the search any found messages will be displayed inside the browser.
The search process can be aborted by pressing the 'Stop' button in the main
window.

After the search is finished, XFMail will display the results of the
search and the number of messages and folders the text was found in.

You can double-click on any message (or select and press View button)
inside the search browser, and it will be opened.

Select button will cause all found messages in currently opened folder
to be selected. Useful if you want to move/delete the found messages.

All of the messages that were located and all of the folders that
contain these messages will be marked with a dark red color. Folders
will be unmarked after you open and close them. In order to unmark
messages use the Messages/Unmark option.

%Spellchecker

@N@C4@c@b@lThe Spell Checker Interface

The spell checker interface consists of a number of buttons, an output field
labeled with \"Word\", that shows the spell checked word, an input field
labeled with \"Suggestion\", where you can correct the spelling of that word
and a browser that shows suggestions to correct the spelling of any misspelled
(or unrecognized) words.

The buttons:

- Replace
   Replaces the word in the text with that from the suggestion input field.
   You can also press Return or Tab.

- Ignore
   Ignores spelling of the word and continues spell checking.

- Ignore every time
   Ignores spelling of the word for the rest of the running session.

- Insert in dict
   Inserts the word into the personal dictionary.
   Brings up this help.

- Help
   This text.

- Options
   Brings up the configuration dialog.
   See Config Ispell^Config-Ispell

- Ok
   Closes the dialog.

%XFDefaults

@N@C4@c@b@lAdvanced XFMail Customization

XFMail uses some reasonable default fonts/colors (and other parameters)
when it displays various dialogs. Sometimes these defaults should be
changed (for example if you have a very low-resolution or b&w screen).

To change those settings you should create a file called .xfdefaults
in your ~/.xfmail/ directory. XFMail reads this file on startup.
System-wide /etc/xfdefaults configuration file can be used as well
(settings from this file have lower preference than those from .xfdefaults).

Lines starting with # are ignored. Each setting line should look like:
<setting name>=<value> . Some settings can have only two values - true
or false. In this case, 1 represents true and 0 represents false.

Recognized setting names are:

 - Depth

    The preferred visual depth of buttons, menus, etc.

 - VisualClass

    The preferred visual class.
    0 - StaticGray
    1 - GrayScale
    2 - StaticColor
    3 - PseudoColor
    4 - TrueColor
    5 - DirectColor

 - DoubleBuffer

    Enable XFMail to simulate double buffering.

 - ButtonFontSize

    The default button label font size.

 - MenuFontSize

    The default font size of menu labels.

 - ChoiceFontSize

    The default font size of the choice control and its label.

 - BrowserFontSize

    The browser label and text font size (does not work on folder
    and message browsers or the viewing browser).

 - InputFontSize

    The default font size of input boxes.

 - LabelFontSize

    The label font size of all other objects.

 - PopUpFontSize
 
    The font size used in pop-up menus.

 - PopUpFontStyle

    The font used in pop-up menus
    (See the list of available styles below).

 - PopUpBgCol
 - PopUpFgCol

    The Menu background and foreground colors
    (See the list of available colors below).

 - PopUpCursor

    The type of cursor to be used in menus.
    The number represents cursor type as defined in cursorfont.h

 - PrivateMap

    XFMail will force a private colormap if appropriate.

 - SharedMap

    XFMail will force a shared colormap.

 - StandardMap

    XFMail will force the standard colormap.

 - BorderWidth

    The height of various controls. (looks really great with -3).

       Available font styles:

 0 - helvetica-medium-r
 1 - helvetica-bold-r
 2 - helvetica-medium-o
 3 - helvetica-bold-o
 4 - courier-medium-r
 5 - courier-bold-r
 6 - courier-medium-o
 7 - courier-bold-o
 8 - times-medium-r
 9 - times-bold-r
10 - times-medium-o
11 - times-bold-o
12 - charter-medium-r
13 - charter-bold-r
14 - charter-medium-i
15 - Symbol

You can add new fonts using the Appearance configuration dialog.
Each new font will get a sequential number starting from 16.

    Available colors:

 0 - black
 1 - red
 2 - green
 3 - yellow
 4 - blue
 5 - magenta
 6 - cyan
 7 - white
 8 - tomato
 9 - indian red
10 - slate blue
11 - RGB(161,161,161)   - main background color
12 - RGB(41,41,41)
13 - RGB(89,89,89)
14 - RGB(204,204,204)
15 - RGB(222,222,222)
16 - RGB(191,191,191)   - secondary background color
17 - RGB(110,110,110)
18 - pale green
19 - dark gold
20 - orchid
21 - dark cyan
22 - dark tomato
23 - wheat
24 - dark orange
25 - deep pink
26 - RGB(128,255,0)
27 - dark violet
28 - spring green
29 - dodger blue

If necessary you can redefine any color in the above list by using
MapColor setting. The format is

MapColor=<color number> <r> <g> <b>

Where <color number> is the number of the color in the above table
you want to redefine, and <r> <g> <b> are the RGB values of the desired
color (you can use program like xcolorsel to get those numbers).


%What-New
See the ChangeLog file in the documents directory or the root of the tarball.

