summaryrefslogtreecommitdiffstats
path: root/manual/en/syl_012.sgml
blob: d61e3632e17bd3349e2d8a9542564d6fe6a31f65 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
<sect>Address Book
<p>

<figure loc="here">
	<ph vspace="1cm">
	<img src="snapshots/address_book.png">
</figure>

<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.

<sect1>Adding and Deleting Addresses

<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>
<figure loc="here">
	<ph vspace="1cm">
	<img src="snapshots/address_book_basic.png">
</figure>
<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>
<figure loc="here">
	<ph vspace="1cm">
	<img src="snapshots/address_book_address.png">
</figure>
<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>
Deleting an address is equally simple. Find the address, 
click it once, and press the Delete button.

</sect1>

<sect1>Folders and Groups
<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 <tt>myGroup</tt>, create the entries
for all your workmates in this folder. Now you can create one
groupe named <tt>jokes</tt> that includes all but the boss
to use when sending your daily jokes, another one named
<tt>team</tt> that includes everybody for the usual group
(serious) communication, and a third group named
<tt>reports</tt> 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>
<figure loc="here">
	<ph vspace="1cm">
	<img src="snapshots/address_book_group.png">
</figure>

</sect1>

<sect1>Combination with Message Composition Window
<p>
You can either enter the first letters of an address
(or alias) in the <tt>To:</tt> or <tt>Cc:</tt> 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 <tt>To:</tt>
and <tt>Cc:</tt> 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 <tt>To:</tt> or <tt>Cc:</tt> 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 <tt>jokes</tt>
group when sending you morning jokes, and the <tt>reports</tt>
one when sending your weekly reports...

</sect1>

<sect1>Using your PDA addressbook (with Jpilot)
<p>
Sylpheed can optionally use your PDA addressbook. This option is
available if you have compiled Sylpheed with the support of Jpilot.
For more details regarding the compilation of Sylpheed with (or without)
optional features, see the 
<ref id="compile_sylpheed" name="compilation section">.

<p>
Sylpheed uses the Jpilot side copy of your address book, so you do
not need to put your PDA on the craddle to find an address (but do
not forget to synchronize).

<p>
In order to use your PDA's addressbook in Sylpheed, open the addressbook
window, select the <it>JPilot</it> icon in the left tree view,
use the <it>File -> New Jpilot</it> menu entry and choose a name for
this addressbook.
Define the name of the Jpilot addressbook file (usually in:
<tt>~/.jpilot/AddressDB.pdb</tt>) and press <it>OK</it>.
You can use one (or more) of the custom fields to store alternate
Email addresses for the same person.

<p>
Now you can browse your PDA addressbook. Sylpheed only has read
access to this addressbook, so you can't modify your PDA addressbook
from Sylpheed.

</sect1>

<sect1>LDAP server connection
<p>

### FIXME: write this part.

</sect1>

</sect>