fix segfault in prefs_matcher.c
[claws.git] / doc / manual / en / sylpheed-11.html
index 9d3bcc39f0966b3f00427fac5a1aee6ae8f353d3..8c94876b6c81e1e471dd3c78f3a44a63b634f453 100644 (file)
 <HR>
 <H2><A NAME="s11">11. Address Book</A></H2>
 
-<P>In the address book, accessible through Alt-A, the Addressbook button, or through the tool menu, you store e-mail addresses of the people and places you want to write more often.
 <P>
 <P>
+<P>
+<P>
+<P>In the address book, accessible through Shift-Ctrl-A, 
+the Addressbook button, or through the "Tools" menu, you 
+store e-mail addresses of the people and places you want 
+to write more often.
+<P>If the options have been compiled into Sylpheed, the
+address book can connect to a LDAP server for address
+lookup, and you can use the address book stored on your
+Palm PDA.
+<P>
 <H2><A NAME="ss11.1">11.1 Adding and Deleting Addresses</A>
 </H2>
 
-<P>Adding an address to the address book is quite easy too. Rightclick the folder or group you want to add the address to, select "new address" and fill in the dialog that comes up. You can also directly click the Add button in the address book window, and the dialog comes up. In this case the address is moved into the folder/group that is selected at the moment of adding.
-<P>Deleting an address is equally simple. Find the address, click it once, and press the Delete button.
+<P>Adding an address to the address book is quite easy too. 
+Rightclick the folder or group you want to add the address 
+to, select "new address" and fill in the dialog that comes 
+up. You can also directly click the Add button in the 
+address book window, and the dialog comes up. In this 
+case the address is moved into the folder/group that is 
+selected at the moment of adding.
+<P>
+<P>
+<P>
+<P>In the "Basic data" tab, you can fill the first
+and last name and provide a nickname. The "Display name"
+will be used by the "Name" column of the address book
+window.
+<P>
+<P>
+<P>
+<P>
+<P>In the "E-Mail address" tab, fill the address field
+and use the "Add" button to add the address to the list.
+An alias can also be assigned to this address and used
+when searching for an address.
+Several addresses can be assigned to the same person
+in your address book by repeating the sequence described
+above. The addresses can then be sorted by using the 
+"Move up" and "Move down" buttons. The address on the top
+will be the first one listed in the address book main window.
+<P>
+<P>Deleting an address is equally simple. Find the address, 
+click it once, and press the Delete button.
 <P>
 <H2><A NAME="ss11.2">11.2 Folders and Groups</A>
 </H2>
 
-<P>The address book, like the mail folders, can be expanded into an entire tree of sections. For this you right-click on the folder where you want to add a new folder, and select "new folder". Then you can enter a descriptive name for the folder, click Ok, and your folder is created.
-<P>In this same way you can create a new group in a folder. Right-click on the folder, select "new group", enter a name for it, and that's it.
+<P>You can use groups and folders to organize your address
+book into categories, hierarchies and aliases.
+The folders are used to generate a hierarchical organization
+and contain the actual addresses, while the groups are
+used to group together addresses that lives in separate
+folders.
+<P>Sounds complicated, so let's see an example: consider
+your workmates, they are arnaud (arnaud@company.com),
+sandra (sandra@company.com), xavier (xavier@company.com)
+and the chief, helene (helene@company.com). You can
+create a folder named <CODE>myGroup</CODE>, create the entries
+for all your workmates in this folder. Now you can create one
+groupe named <CODE>jokes</CODE> that includes all but the boss
+to use when sending your daily jokes, another one named
+<CODE>team</CODE> that includes everybody for the usual group
+(serious) communication, and a third group named
+<CODE>reports</CODE> that includes the boss, and the one working 
+with you on some projects for the weekly reports.
+<P>To generate this kind of addresses organization
+you only need to create the entries once, then when
+creating groups you can select among the existing entries
+to fill the groups.
+<P>The address book, like the mail folders, can be expanded 
+into an entire tree of sections. For this you right-click 
+on the folder where you want to add a new folder, and 
+select "new folder". Then you can enter a descriptive 
+name for the folder, click Ok, and your folder is created.
+<P>In this same way you can create a new group in a folder. 
+Right-click on the folder, select "new group", enter a name 
+for it, and that's it.
+<P>The group settings window pops up in order to fill the group
+with addresses. Use the two arrows to add to or remove from
+the group the selected address.
+Once the group contains the list of addresses you want it to
+contain, click the "OK" button to close the window.
+<P>
+<P>
 <P>
 <H2><A NAME="ss11.3">11.3 Combination with Message Composition Window</A>
 </H2>
 
-<P>Open the address-book through one of the available ways (toolbar, shortcut key).
-Finding an e-mail address: enter part of the start of the name or the address you are looking for and press the TAB key. A dropdown list will appear with the selections that have been found to match. Select one and press enter. After that you can use the To:, Cc: or Bcc: buttons to add the address to an e-mail, if you are writing one. Otherwise these buttons are greyed out and not functional.
+<P>You can either enter the first letters of an address
+(or alias) in the <CODE>To:</CODE> or <CODE>Cc:</CODE> field
+of the composition window and press the TAB key to
+let Sylpheed do the completion or open the address book,
+select addresses from there and use the <CODE>To:</CODE>
+and <CODE>Cc:</CODE> buttons to copy the selected addresses
+into the corresponding fields of the composition window.
+<P>When using the completion mode, when one or more address
+matches the start you have entered, a dropdown list appears.
+Select the correct address from this list and press enter
+to complete the composition window's field.
+<P>In completion mode, the search is made on the E-mail
+address and on the alias. The other fields of the
+address book entry are not used (name, nickname,...).
+<P>When the address book is opened, if you select a group,
+using the <CODE>To:</CODE> or <CODE>Cc:</CODE> buttons will
+copy all the addresses of the selected group into the
+corresponding field of the composition window.
+<P>Using our previous example, you can select the <CODE>jokes</CODE>
+group when sending you morning jokes, and the <CODE>reports</CODE>
+one when sending your weekly reports...
+<P>
 <HR>
 <A HREF="sylpheed-12.html">Next</A>
 <A HREF="sylpheed-10.html">Previous</A>