1 files changed, 475 insertions, 0 deletions
diff --git a/manual/en/sylpheed-8.html b/manual/en/sylpheed-8.html
new file mode 100644
index 0000000..564f5a3
--- /dev/null
+++ b/manual/en/sylpheed-8.html
@@ -0,0 +1,475 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<HTML>
+<HEAD>
+ <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
+ <TITLE>Sylpheed User's Manual: Sylpheed configuration</TITLE>
+ <LINK HREF="sylpheed-9.html" REL=next>
+ <LINK HREF="sylpheed-7.html" REL=previous>
+ <LINK HREF="sylpheed.html#toc8" REL=contents>
+</HEAD>
+<BODY>
+<A HREF="sylpheed-9.html">Next</A>
+<A HREF="sylpheed-7.html">Previous</A>
+<A HREF="sylpheed.html#toc8">Contents</A>
+<HR>
+<H2><A NAME="s8">8. Sylpheed configuration</A></H2>
+<P>All the configuration settings of Sylpheed are accessible from
+the <I>Configuration</I> menu and consist of common settings
+(<I>Common preferences</I>, <I>Filter settings</I>, 
+<I>Template</I> and <I>actions</I>) and account specific
+settings.
+<P>With Sylpheed, there is no limit to the number of accounts
+you can create. You can create new accounts for each of your
+mail account, but also to change the default behaviour of 
+Sylpheed. As folders can be attached to accounts, the account
+specific part of the configuration automatically change based
+on the current folder (you can have a different signature when
+replying to messages from different folders).
+<P>
+<H2><A NAME="ss8.1">8.1 Common preferences</A>
+</H2>
+<P>The Common Preferences, found in the Configuration menu, controls
+the window layout and the different options of the graphical
+interface of Sylpheed. Depending on some compile time switches
+(and on the availability of some extra libraries), some tabs
+may be included (or not) in your version of Sylpheed. These tabs
+are not listed here but are described (or will be described) in
+the sections covering the optional features they control (like the
+<I>Privacy</I> tab for the GnuPG interface).
+<P>
+<H3>Receive tab</H3>
+<P>In here you can set up how to receive messages.
+<P>
+<P>
+<P>
+<P>
+<UL>
+<LI>You can define a special program to pick up messages from 
+the default unix mailbox. Usually this is not used, but 
+you can use it. Actually, this information may be wrong. 
+If someone knows better, please let me know.</LI>
+<LI><I>Local spool</I> lets you define where your local mailbox is 
+located. You can also tell Sylpheed whether or not to 
+filter the incoming messages from that mail spool file.
+The spool directory defined here is used by all the accounts
+of the <I>local</I> type, by default it is set to the
+standard UNIX mailbox location.</LI>
+<LI><I>Autocheck new mail</I>. When you check this option, Sylpheed 
+will check if there is new mail on the set interval.</LI>
+<LI><I>Check new mail on startup</I> means that Sylpheed will 
+immediately look for new mail on all the selected accounts 
+when it loads.</LI>
+<LI><I>Update all local folders after incorporation</I>
+Well, if you know the use of this option, feel free to
+write this part...</LI>
+<LI>In the news section you can specify how many articles 
+should be downloaded when opening a newsgroup.</LI>
+</UL>
+<H3>Send tab</H3>
+<P>In here you can set up how to send messages.
+<P>
+<P>
+<P>
+<P>
+<UL>
+<LI>You can choose to use an external program (like sendmail) for
+sending mail. By default no external program is necessary
+and Sylpheed can directly send the outgoing messages to a
+SMTP server.</LI>
+<LI>The sent messages can be saved in the outbox (<I>Sent</I> 
+folder), the name of the outbox folder can be specified
+for each account (see the account setting section).</LI>
+<LI>The outgoing codeset selection can be changed to force
+the definition of the character set used in sent mails.
+The default and recommended value is <I>automatic</I>,
+so Sylpheed determines the codeset when sending each
+message.</LI>
+</UL>
+<H3>Compose tab</H3>
+<P>Controls the composition window's behaviour..
+<P>
+<P>
+<P>
+<P>
+<UL>
+<LI>You can change the signature separator and choose to insert
+it automatically (unless your signature file already contains
+this separator). Leave it as it is by default (unless you really
+need to change it, and are ready to face a religion war), a lot
+of mail clients rely on this separator to cut the signature when
+quoting mails, and this one is accepted as the standard one.</LI>
+<LI>If you hate the editor that comes with Sylpheed, you can choose
+to automatically start an editor of your choice when composing
+new messages (the editor can be defined in the <I>Other</I> tab).</LI>
+<LI>The <I>wrap</I> settings defines how Sylpheed will wrap long
+lines. You can choose to wrap quoted messages, wrap as you type,
+or wrap when sending. You can also change the maximum line length.</LI>
+<LI>The <I>reply</I> settings let you control the way you will reply
+to mails. If <I>Automatically select account(...)</I> is set,
+the account used when replying to a message is automatically
+selected based on the folder the original message is in (as you
+where already told, accounts can be attached to folders).
+If <I>Quote message when replying</I> is selected, when hiting
+the <I>Reply</I> button, the composition window pops up and is
+filled with either the complete message you are replying to (if
+nothing is selected in the body of this message) or the selected
+part of its body. When this option is not selected, the composition
+window is always empty, and you must cut-and-paste the parts of
+the original message you want to quote manually.</LI>
+</UL>
+<H3>Quote tab</H3>
+<P>In here you can control the quotation of your replies and forwarded
+messages.
+<P>
+<P>
+<P>
+<P>
+<UL>
+<LI>You can individually define the quotation mark that appears
+at the beginning of each quoted line when replying and forwarding
+a message.</LI>
+<LI>You can also define the text that appears before and after the 
+quotation. The format of the quotation contains placeholders for
+parts of the original message that are explains in the window
+that appears when hiting the <I>Description of symbols</I>
+button.</LI>
+</UL>
+<H3>Display tab</H3>
+<P>In here you can control the display options of Sylpheed.
+<P>
+<P>
+<P>
+<P>
+<UL>
+<LI>You can change the font used to display the messages. Pressing
+the button next to the font name field will open the font selection
+window, then you can select among all the available fonts.</LI>
+<LI>Turning on the translation of the header fields will change the
+content of the header summary (between the summary and the message
+pane), and use the localized header fields name based on the
+selected language (selected by the 'LANG' environment variable).
+This setting will only take effect the next time you will start
+Sylpheed.</LI>
+<LI>Selecting <I>Display unread next to folder name</I> will add
+the number of unread messages next to the folder name in the
+folder pane (so you can minimize the width of the folder pane
+and hide the unread column).</LI>
+<LI>You can also control the content of the summary pane. If you choose
+to display the recipient name for the mail you send, in the <I>From</I>
+column, for any mail you have sent, the name of the recipient will
+appear preceded by an arrow (the characters sequence: -->).
+The <I>Expand threads</I> controls the initial state of the message
+threads when opening a folder (expanded of collapsed).
+The <I>Set display item of summary</I> button opens a selection
+window that contains all the available items to display in the
+left column, the currently selected items in the right column.
+Items can be added or removed using the two arrows that appears
+between the columns. Using the <I>up</I> and <I>down</I> buttons
+on the right side of the window, you can change the display order
+of the selected item in the summary window (from left to right).</LI>
+</UL>
+<H3>Message tab</H3>
+<P>The message tab controls the message window options.
+<P>
+<P>
+<P>
+<P>
+<UL>
+<LI>The message text can use colours to highlight the different levels
+of quotation and URIs. The colours can be changed by using the
+colours selection dialog that pops up when pressing the <I>Edit</I>
+button next to the <I>Enable coloration of messages</I> toggle.</LI>
+<LI>The dispaly of the header summary between the summary and message
+panes can also be turned on and off (<I>Display header pane above message 
+view</I> dialog).</LI>
+<LI><I>Display short header on message view</I> and the <I>Edit</I>
+button next to it, control the inclusion of some header fields
+in the message view. If the message coloration has been turned on,
+the addresses that appear in the header part of the message view
+are highlighted as URIs.</LI>
+<LI>The <I>Line space</I> setting controls the lines spacing of the
+message view.</LI>
+<LI><I>Leave space on head</I>. Checking this box will make the 
+start of new lines (unwrapped, where the writer has pressed 
+the Enter/Return key) indent a few pixels. This can be useful 
+to read larger e-mails.</LI>
+<LI><I>Scroll half page</I>. When enabled, the text in the message 
+view will only scroll half a page instead of a whole page when 
+pressing the space bar.</LI>
+<LI><I>Smooth scroll</I>. Enabling this box will make the text 
+in the message view scroll in a smooth, sliding way. For the 
+eye this can be pleasing, it is a personal preference.</LI>
+<LI>Select the <I>Resize attached image</I> if you wnat all the
+images (attachment) to be resized to fit in the message window.</LI>
+</UL>
+<H3>Interface tab</H3>
+<P>The interface tab controls the Sylpheed's Graphical User Interface
+behaviour.
+<P>
+<P>
+<P>
+<P>
+<UL>
+<LI>The <I>Open message when cursor keys are pressed</I> toggles controls
+the opening of the messages while you go through them in the summary
+pane using the cursor (up and down arrows) keys. If this toggle is on,
+each time you press the <I>down</I> (or <I>up</I>) key in the the
+summary window, the current message changes and the content of the
+message view changes to the content of the newly selected message.
+Otherwise, the content of the message view does not change unless you
+press enter (then the message view contains the content of the selected
+message).
+This does not change the behaviour of the left mouse button (always selects
+and open the pointed message).</LI>
+<LI><I>Open first unread message when entering a folder</I> if selected,
+when opening a folder, the message view will contain the first unread
+message of this folder (or the latest message in the order the folder
+uses for sorting messages). If not selected, the message view remains
+empty until a message is selected (by changing the current message with
+the cursor keys or with the left mouse button).</LI>
+<LI><I>Only marks message  read when open in new window</I> leaves the
+selected message unread (but display it in the message view) until you
+open it in a new window (double click the left mouse button).</LI>
+<LI>If <I>Execute immediately when moving or deleting messages</I> is not
+selected, a new button appears in the button bar marked <I>Execute</I>.
+When deleting or moving messages, they are first marked as deleted or
+moved but Sylpheed does not move or delete them until you press the 
+<I>Execute</I> button (or the <I>Execute</I> entry of the 
+<I>Tools</I> menu).</LI>
+<LI>The <I>Receive dialog</I> settings controls the dialog that pops
+up (if you have set <I>Show receive dialog</I> to <I>always</I>)
+when receiving new mails.
+The default is to open a pop up window upon reception error unless
+you select the <I>Dont't pop up error dialog (...)</I> toggle.</LI>
+<LI><I>The Set key bindings</I> button when pressed, opens a selection
+window that contains a list of pre-defined key bindings (<I>Mew</I>, 
+<I>Mutt</I>, <I>Old Sylpheed</I>) to change all the key bindings
+at once. The key bindings can also be changed one by one as described in</LI>
+</UL>
+<H3>Other tab</H3>
+<P>The other tab contains the settings that does not fit the
+previous categories.
+<P>
+<P>
+<P>
+<P>
+<UL>
+<LI><I>Web browser</I>. Here you can enter the name of your favorite 
+web browser (Netscape, Opera, Mozilla, Lynx etc.). Add the %s parameter 
+to the command so Sylpheed knows it has to provide the text you clicked 
+on as the URL that the browser has to visit.
+The arrow next to the text field can be used to display a scrolling
+list of predefined URL browsing command lines.</LI>
+<LI><I>Printing</I>. Here you can define the program that should be used 
+to print. Default is lpr, and the %s is the name of the temporary file 
+that Sylpheed creates for lpr to print.
+When using the <I>File->Print</I> menu entry to print the selected
+message, a text window pops up to allow you to change the command
+used to print.</LI>
+<LI><I>External editor</I>. You can select an external editor to write 
+your e-mails with, for example vi, emacs or gedit. Note that for 
+text-based editors like vi, you need to define a terminal window, 
+e.g. <CODE>xterm -e vi %s</CODE>. Otherwise there is no place that the 
+editor will be able to show up. Here too, the %s parameter is the 
+name of a temporary file that is created by Sylpheed.</LI>
+<LI><I>Add address to destination (...)</I> when selected,
+double clicking an e-mail address (in the address book,
+when the composition window is opened) can be used to add 
+this address to the <I>To:</I> field.</LI>
+<LI>Confirming if you want to exit Sylpheed (or just exit quietly).</LI>
+<LI>Cleaning the trashbox when exiting Sylpheed.</LI>
+<LI>Have Sylpheed ask you to clean the trash before it is done.</LI>
+<LI>Warn you when exiting Sylpheed when there are still messages 
+queued to be sent.</LI>
+</UL>
+<H2><A NAME="ss8.2">8.2 Setting up an account/changing an account</A>
+</H2>
+<P>In order to set up an account in Sylpheed, in the <I>Configuration</I>
+menu you select <I>Create new account</I>. If you want to change the 
+settings of an existing account and this account is the current
+one, in the <I>Configuration</I> menu select <I>Preferences for 
+current account</I>, otherwise select <I>Edit accounts...</I>.
+There you select the account you want to change. After that you press 
+<I>edit</I>. Then a dialog appears in which you can enter or update 
+the following areas:
+<P>
+<P>
+<H3><A NAME="Basic"></A> Basic tab</H3>
+<P>
+<P>
+<P>
+<P>
+<P>In the "Basic" tab you name the account. This is to make identifying 
+the account easier. The name is then used in the <I>Change current account</I>
+part of the <I>Configuration</I> menu, or in menu found in the lower 
+right corner of the main window (used to quickly switch to another account).
+<P>Choose a name that tells something about the account, like the 
+name of the ISP, mailbox or news-server you are setting up.  
+You can select this account to be the default account ("Usually used").
+The default account can also be defined from the <I>Edit accounts</I>
+window (toggle the <I>D</I> column next to the account name).
+<P>Enter your name and e-mail address, and if you have one, the 
+organization that you use Sylpheed for.
+In the Protocol box you select the type of service that this 
+account will be using. The flavors you can choose are: <I>POP3 normal</I>, 
+<I>POP3 APOP auth</I>, <I>IMAP4</I>, <I>NNTP news</I> or <I>None (local)</I>.
+<P>For POP3 and IMAP services you can then specify the server where 
+your mail is stored. Details about this name, and also the name 
+that goes into the field for <I>SMTP server (send)</I> should be given 
+to you by your ISP.
+<P>For a local unix mailbox, the <I>Server for receiving</I> is disabled, 
+since the mail will be received for you.
+<P>The fields for <I>User ID</I> and <I>Password</I> will also be
+disabled for accounts that do no deal with POP3 or IMAP services.
+Otherwise you can enter the login name and password for the e-mail
+server with your ISP here. Usually these are the same as your login 
+name and password to access the dial-in service, but this is 
+not standard. If in doubt, contact the helpdesk of your ISP.
+<P>
+<H3>Passwords:</H3>
+<P>The password is not printed in the entry field (replaced by stars) but
+is stored in plaintext in the Sylpheed configuration files. The Sylpheed
+configuration directory (&nbsp;/.sylpheed) is only readable by 'owner', and
+not by 'group' and 'other', do not change these access rights.
+<H3><A NAME="Receive"></A> Receive tab</H3>
+<P>
+<P>
+<P>
+<P>
+<P>The <I>Receive</I> tab is only used for POP3 accounts. Here you
+specify if the mails that were successfully retrieved should be removed 
+from the server. You can also tell Sylpheed to get all the 
+messages there, not only the ones you already received (in case 
+you leave your messages on the server).
+You can choose to leave the messages on the server during a selectable
+number of days (then remove them).
+<P>You can also define a limit for the size of the messages to
+download. Any message bigger than this limit will not be
+downloaded.
+<P>You can also choose to filter messages on receiving, if not
+set, the messages are only filtered when you use the filter
+entry of the Tools menu.
+<P>The default inbox defines the folder that receives the incoming
+(and not filtered) messages for this account.
+You can define a different folder as inbox for each of your
+accounts.
+<P>If the <I>Get all checks for messages on this account</I> is turned
+off, when using the <I>Get all</I> menu entry (or toolbar button)
+this account will not be checked. To check for new mails for
+this account, you must select the account, then use the <I>Get</I>
+toolbar button (or menu entry).
+<H3><A NAME="Send"></A> Send tab</H3>
+<P>
+<P>
+<P>
+<P>
+<P>In the <I>Send</I> tab you can define the settings that apply 
+to sending mails.
+<P>You can choose to add the date field to the messages you send,
+generate a unique message identifier, or add custom header
+fields.
+<P>
+<H3>X-face pictures:</H3>
+<P>The user defined header field should be set up to contain your
+X-face picture.
+Thanks to Jeff Dairiki, you can have a complete online course in this. 
+Visit 
+<A HREF="http://www.dairiki.org/xface/">this page</A> for the details.
+<P>If your SMTP server needs authentication, define the user ID and
+password to use in this tab. You can also choose to first authenticate with
+POP3 before sending.
+<P>
+<H3><A NAME="Compose"></A> Compose tab</H3>
+<P>
+<P>
+<P>
+<P>
+<P>In the <I>Compose</I> tab you can define your signature file, 
+choose to always copy someone when sending mails (you can
+choose to always copy your boss, or yourself), and define the
+Reply-To field for the current account.
+<H3><A NAME="Privacy"></A> Privacy tab</H3>
+<P>This tab is only available when Sylpheed has been compiled
+with GPGME and GNUPG (for signature and encryption).
+<P>
+<P>With this tab you can choose the keys to use when signing
+or encrypting mails for this account.
+<H3><A NAME="Advanced"></A> Advanced tab</H3>
+<P>The Advanced tab contains some settings you normally do
+not need to change (unless you really know what you are
+doing).
+<P>
+<P>
+<P>
+<P>
+<P>You can change the default SMTP or POP3 ports used when
+connecting to your mail server, define a domain name to
+use when sending a mail. Some ISP (or mail relays) reject
+mails without a valid domain name.
+<P>The default folders for the sent messages, drafts and
+trash can be defined here. If not changed the current account
+will use the default folders.
+<H3>Attaching accounts to folders</H3>
+<P>Pressing the right mouse button over a folder (in the folder pane), 
+and selecting the <I>Properties</I> entry will open the folder properties
+form. In this form, in the <I>General</I> tab you can see (but not modify)
+the folder name and the corresponding directory path (relative to the mail
+directory). In the <I>Compose</I> tab:
+<P>
+<P>
+<P>
+<P>you can select the account, choose to apply this setting also to
+the sub-folders.
+You can also force the address used when sending mail (to force a mailing
+list address, for example), choose to send a copy of the sent mails
+to a list of addresses different from the default one defined for the
+selected account.
+<H3>Using accounts in the real life</H3>
+<P>Accounts can, of course be used to retrieve mails from different ISPs,
+separate your personal and professional messages, but also to make your
+life easier.
+You can define different accounts just to change your address (as sender),
+your signature, change the sent folder, etc...
+Here is a summary of the account specific settings, feel free to
+find your own use for them:
+<P>
+<UL>
+<LI>Sender name, address and organization. Signature, extra header
+fields.</LI>
+<LI>Leave or remove message from server (usefull for debug).</LI>
+<LI>Incoming mails filtering and size limit.</LI>
+<LI>Default field (<I>Reply-To</I>:, <I>Cc:</I>, <I>Bcc:</I>).</LI>
+<LI><I>Draft</I>, <I>Trash</I> and <I>Sent</I> folders.</LI>
+</UL>
+<P>By attaching accounts to folders, you can control all these settings
+on a folder basis, but you can also change the <I>To:</I>, <I>Cc:</I>, 
+<I>Bcc:</I>, and <I>Reply-To:</I> for each folder (overrides the account
+settings).
+<P>
+<HR>
+<A HREF="sylpheed-9.html">Next</A>
+<A HREF="sylpheed-7.html">Previous</A>
+<A HREF="sylpheed.html#toc8">Contents</A>
+</BODY>
+</HTML>