fix segfault in prefs_matcher.c
[claws.git] / doc / manual / en / sylpheed-16.html
index c33a0b90d99c392d721a05955813aef1c9ef878d..fbcffec482ac9aa055844e8f5d2fd3d22eaf2bda 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>Sylpheed User's Manual: Reference</TITLE>
+ <TITLE>Sylpheed User's Manual: Customization (General Setup)</TITLE>
  <LINK HREF="sylpheed-17.html" REL=next>
  <LINK HREF="sylpheed-15.html" REL=previous>
  <LINK HREF="sylpheed.html#toc16" REL=contents>
 <A HREF="sylpheed-15.html">Previous</A>
 <A HREF="sylpheed.html#toc16">Contents</A>
 <HR>
-<H2><A NAME="s16">16. Reference</A></H2>
+<H2><A NAME="s16">16. Customization (General Setup)</A></H2>
 
-<P>In this section you will find a few pieces of information that might be handy in making Sylpheed more clear for you in respect to the used shortcut keys, and a layout of the format of the address book.
-<H2><A NAME="ss16.1">16.1 Short-Cut Key List</A>
+<P>Sylpheed offers you several ways to customize it's interface for your personal use.
+<P>
+<H2><A NAME="ss16.1">16.1 General Setup Window</A>
 </H2>
 
-<P>Shortcuts to the File menu:
-<UL>
-<LI>Alt-F: open FILE menu</LI>
-<LI>Alt-P: print</LI>
-<LI>Alt-W: close</LI>
-<LI>Alt-Q: exit</LI>
-</UL>
+<P>For making changes to Sylpheed's interface, you need to open the "common preferences" in the Configuration menu.
+<P>In here you will find a tabbed window that offers the following possibility to customize Sylpheed.
+<H2><A NAME="ss16.2">16.2 Description of Each Entry</A>
+</H2>
 
-Shortcuts to the Edit menu
+<P>In the third tab, "Compose", the following settings can be changed:
+<P>
+<P>
+<P>
+<P>
 <UL>
-<LI>Alt-E: open EDIT menu</LI>
-<LI>Ctrl-C: copy</LI>
-<LI>Ctrl-A: select all</LI>
-<LI>Ctrl-S: search</LI>
+<LI>Quoting the original text of a message</LI>
+<LI>Define the quoting character that is put in front of each line of text.</LI>
+<LI>Define the text that is placed in front of the quoted text</LI>
+<LI>An optional signature separator. This is a combination of characters that are placed in front of a signature text.</LI>
+<LI>Whether or not to insert the signature automatically</LI>
+<LI>Define if the account that recieved the message should automatically be used as the account from which the reply is sent. This also influences the signature to be selected.</LI>
+<LI>Set the position of the line where wrapping should occur.</LI>
+<LI>Select if the quoted text should be wrapped also.</LI>
+<LI>Indicate if e-mail text should be wrapped or not. If you choose not to select wrapping, then the lines you wrote will not be chopped up by carriage return/line feed characters.</LI>
 </UL>
 
-Shortcuts to the View menu
+In the fourth tab, "Display", you can set or unset the following options:
+<P>
+<P>
+<P>
+<P>
 <UL>
-<LI>Alt-V: open VIEW menu</LI>
+<LI><CODE>Font.</CODE> You can set the font that is used to display the messages.</LI>
+<LI><CODE>Translate header name.</CODE> This options changes the behaviour of the different headers.</LI>
+<LI><CODE>Unread number.</CODE> This toggles the display of the number of unread messages next to each mailbox.</LI>
+<LI><CODE>Display recipient.</CODE> With this option you can tell Sylpheed to show the recipient in the summary view when you are the one who sent the message.</LI>
+<LI><CODE>Enable horizontal scrollbar.</CODE> This option enables or disables showing the horizontal toolbar beneath the summary view. With the bar disabled, you cannot scroll to the right to see extremely long message subjects.</LI>
+<LI><CODE>Expand threads.</CODE> If you disable this options and you have enabled the Threaded view through the Summary menu, threads are shown as collapsed lines with a '+' sign in front of them. Enable this option to show all the messages in a thread.</LI>
+<LI><CODE>Display unread with bold font.</CODE> If you enable this checkbox, messages in the summary view that have not been read yet are shown in a bold font. Unchecking this option will of course show all messages in the default font.</LI>
+<LI><CODE>Date format.</CODE> This option puts you in charge of the way the date of an e-mail message is shown. You can click the "..." button to open a new window. In there you see the codings that you can use to format the date. As you change the codings, an example is shown beneath the coding sequence of how your date will look.</LI>
+<LI><CODE>Set display item.</CODE> This button allows you to select the specific columns that will be shown in the summary view.</LI>
 </UL>
 
-Shortcuts to the Message menu
+Next to these options, there is the message tab, in which you can set the following choices:
+<P>
+<P>
+<P>
+<P>
 <UL>
-<LI>Alt-M: open MESSAGE menu</LI>
-<LI>Alt-I: check mail for current account</LI>
-<LI>Shift-Alt-I: Check mail for all accounts</LI>
-<LI>Alt-N: compose new message</LI>
-<LI>Alt-R: reply to message</LI>
-<LI>Ctrl-Alt-R: reply to sender (contrary to reply to e.g. mailing list)</LI>
-<LI>Shift-Alt-R: reply to all (includes all addresses in To: and Cc:)</LI>
-<LI>Ctrl-F: forward message</LI>
-<LI>Shift-Ctrl-F: forward message as attachment</LI>
-<LI>Alt-O: move message</LI>
-<LI>Alt-D: delete message</LI>
-<LI>Shift-Ctrl-N: open message in new window</LI>
-<LI>Ctrl-U: view message source</LI>
-<LI>Ctrl-H: show all message headers</LI>
+<LI><CODE>Enable colorization.</CODE> When you enable this option, you can define with what colors the message text and the quotings will be displayed.</LI>
+<LI><CODE>Display 2-byte alphabet and numeric with 1 character.</CODE> This option is necessary for double-byte languages as Japanese and Chinese.</LI>
+<LI><CODE>Display header pane above message view.</CODE> Enabled, this option shows the From, To and Subject headers from the selected e-mail in a separate area over the message view.</LI>
+<LI><CODE>Display short headers on message view.</CODE> This option lets you select all the headers that will be shown in the message view window. There are options to enable all, no or selected headers.</LI>
+<LI><CODE>Line space.</CODE> This option lets you select how many pixels of space Sylpheed has to show between the lines of text in the message view window.</LI>
+<LI><CODE>Leave space on head.</CODE> 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><CODE>Scroll half page.</CODE> 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><CODE>Smooth scroll.</CODE> 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>
 </UL>
 
-Shortcuts to the Summary menu
+The tab "Interface" allows even more customization of Sylpheed. This tab features:
+<P>
+<P>
+<P>
+<P>
 <UL>
-<LI>Alt-S: open SUMMARY menu</LI>
-<LI>Alt-X: execute (pending commands, only useful when commands are not executed immediately)</LI>
-<LI>Alt-U: update view</LI>
-<LI>Alt-G: go to other folder</LI>
-<LI>Ctrl-T: thread view</LI>
-<LI>Shift-Ctrl-T: unthread view</LI>
+<LI>Opening the first unread message when you enter a folder.</LI>
+<LI>Automatically move focus to the inbox after new mail was received.</LI>
+<LI>Immediate execution of commands like delete, move or copy.</LI>
+<LI>Influence the way the "receive" dialog box behaves when new mail is retrieved (Always, When a window is active, Never).</LI>
+<LI>Double clicking an e-mail address can be used to put that address in a new e-mail.</LI>
+<LI>Confirming if you want to exit Sylpheed.</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>
 
-Shortcuts to the Tool menu:
+Finally there is the "Other" tab. In here you can define the programs you want as helper applications for Sylpheed.
+<P>
+<P>
+<P>
+<P>
 <UL>
-<LI>Alt-T: open tool menu</LI>
-<LI>Alt-A: open addressbook</LI>
-<LI>Alt-L: open logfile</LI>
+<LI><CODE>The web browser.</CODE> 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.</LI>
+<LI><CODE>Printing.</CODE> 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.</LI>
+<LI><CODE>External editor.</CODE> 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>
 </UL>
-<H2><A NAME="ss16.2">16.2 Data Format of Address Book</A>
-</H2>
-
-<P>The addressbook is located in &nbsp;/.sylpheed. It is named addressbook.xml.
-The general format of the addressbook is:
-<P>&lt; addressbook &gt;
-<P>&lt; common_address &gt;
-<P>&lt; group name="Common addresses" &gt;
-<P>&lt; item &gt;
-<P>&lt; name &gt; Paul &lt; /name &gt;
-<P>&lt; address &gt; paul@nlpagan.net &lt; /address &gt;
-<P>&lt; remarks &gt; Writes Sylph. manual &lt; /remarks &gt;
-<P>&lt; /item &gt;
-<P>&lt; /group &gt;
-<P>&lt; /common_address &gt;
-<P>&lt; /addressbook &gt;
-<P>
 <HR>
 <A HREF="sylpheed-17.html">Next</A>
 <A HREF="sylpheed-15.html">Previous</A>