Changeset View
Changeset View
Standalone View
Standalone View
doc/docbook-reference.docbook
- This file was added.
1 | <appendix id="docbook-reference"> | ||||
---|---|---|---|---|---|
2 | | ||||
3 | <appendixinfo> | ||||
4 | | ||||
5 | <authorgroup> | ||||
6 | | ||||
7 | <author> | ||||
8 | <firstname>David</firstname> | ||||
9 | <othername>C.</othername> | ||||
10 | <surname>Bryant</surname> | ||||
11 | <affiliation><address><email>davidbryant@gvtc.com</email></address></affiliation> | ||||
12 | </author> | ||||
13 | | ||||
14 | <!-- TRANS:ROLES_OF_TRANSLATORS --> | ||||
15 | | ||||
16 | </authorgroup> | ||||
17 | | ||||
18 | <copyright> | ||||
19 | <year>2019</year> | ||||
20 | <holder>David C. Bryant</holder> | ||||
21 | </copyright> | ||||
22 | | ||||
23 | <legalnotice>&CCBYSA4Notice;</legalnotice> | ||||
24 | | ||||
25 | <date>2019-08-26</date> | ||||
26 | <releaseinfo>5.10.3 (Applications 18.12.3)</releaseinfo> | ||||
27 | | ||||
28 | <abstract> | ||||
29 | <para>&kaddressbook; is a very complicated program with lots of built-in features. | ||||
30 | Some of the more advanced features of &kaddressbook; are documented in this appendix, | ||||
31 | primarily to keep the main document from getting too large and unwieldy. | ||||
32 | </para> | ||||
33 | </abstract> | ||||
34 | | ||||
35 | <!--TODO Note to self: add more keywords later. --> | ||||
36 | <keywordset> | ||||
37 | <keyword>KDE</keyword> | ||||
38 | <keyword>KAddressBook</keyword> | ||||
39 | <keyword>kdepim</keyword> | ||||
40 | <keyword>Email</keyword> | ||||
41 | </keywordset> | ||||
42 | | ||||
43 | </appendixinfo> | ||||
44 | | ||||
45 | <title>&kaddressbook; Advanced Features Reference Section</title> | ||||
46 | | ||||
47 | <sect1 id="placeholder"> | ||||
48 | <title></title> | ||||
49 | <para></para> | ||||
50 | </sect1> <!-- Force a page break after Table of Contents. dcb --> | ||||
51 | | ||||
52 | <sect1 id="file-new-group"> | ||||
53 | <title>The New Group Dialog</title> | ||||
54 | | ||||
55 | <para>When you invoke the <guibutton><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/> | ||||
56 | </imageobject></inlinemediaobject>New Group</guibutton> function, a dialog will begin, as shown below.</para> | ||||
57 | | ||||
58 | <para> | ||||
59 | <screenshot id="screenshot-new-group"> | ||||
60 | <screeninfo>A screenshot of &kaddressbook;'s <quote>New Group</quote> dialog.</screeninfo> | ||||
61 | <mediaobject> | ||||
62 | <imageobject> | ||||
63 | <imagedata fileref="addressbook101.png" format="PNG"/> | ||||
64 | </imageobject> | ||||
65 | <textobject> | ||||
66 | <phrase>A screenshot of &kaddressbook;'s <quote>New Group</quote> dialog.</phrase> | ||||
67 | </textobject> | ||||
68 | <caption> | ||||
69 | <para>&kaddressbook;'s <quote>New Group</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>New | ||||
70 | ></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/> | ||||
71 | </imageobject></inlinemediaobject>New Group</guimenuitem></menuchoice> function.</para> | ||||
72 | </caption> | ||||
73 | </mediaobject> | ||||
74 | </screenshot> | ||||
75 | </para> | ||||
76 | | ||||
77 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
78 | | ||||
79 | <para>Use the <quote>Add To:</quote> drop-down box to choose the address book to which the new group should be added. Use the | ||||
80 | <quote>Name</quote> field to give the new group a name. Enter e-mail addresses, or portions of email addresses, in the blue | ||||
81 | <quote>+</quote> area. A list of potential matches will appear. Select an item in the list that pops up, and a new name | ||||
82 | will be added to the list. Continue adding individual contacts to the list until it is complete, then click the | ||||
83 | <guibutton> ✔ OK </guibutton> button to add this group to your address book. If you want to delete a name from | ||||
84 | the list, click the <inlinemediaobject><imageobject><imagedata fileref="list-remove.png" format="PNG"/></imageobject> | ||||
85 | </inlinemediaobject> icon to the right of that particular name. If you need to make changes to the group later, simply select | ||||
86 | the group and use the <quote>Edit</quote> menu, or the <quote>Edit Contact</quote> button on the toolbar, to open a substantially | ||||
87 | similar dialog that will let you make the desired changes.</para> | ||||
88 | | ||||
89 | <para>The &kmail; program provides an alternative method of creating a new group in &kaddressbook;. After you have addressed an e-mail | ||||
90 | message to several people, you are given the option of adding a new group to your address book, as shown below.</para> | ||||
91 | | ||||
92 | <para> | ||||
93 | <screenshot id="screenshot-new-group-via-kmail"> | ||||
94 | <screeninfo>A screenshot of &kmail;'s <quote>New Group</quote> dialog.</screeninfo> | ||||
95 | <mediaobject> | ||||
96 | <imageobject> | ||||
97 | <imagedata fileref="addressbook102.png" format="PNG"/> | ||||
98 | </imageobject> | ||||
99 | <textobject> | ||||
100 | <phrase>A screenshot of &kmail;'s <quote>New Group</quote> dialog.</phrase> | ||||
101 | </textobject> | ||||
102 | <caption> | ||||
103 | <para>&kmail;'s <quote>New Group</quote> dialog after choosing the <guibutton> Save List... | ||||
104 | </guibutton> function.</para> | ||||
105 | </caption> | ||||
106 | </mediaobject> | ||||
107 | </screenshot> | ||||
108 | </para> | ||||
109 | | ||||
110 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
111 | | ||||
112 | <para>After addressing a message to a group of people, clicking the <guibutton> Save List... </guibutton> | ||||
113 | button to the right of the address input area will cause the illustrated dialog box to appear. Give the list a name | ||||
114 | and left click the <guibutton> Save List </guibutton> button. Another dialog box will pop up, asking you | ||||
115 | to select an address book. Make your selection, and a new group will be created for you.</para> | ||||
116 | | ||||
117 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
118 | | ||||
119 | </sect1> | ||||
120 | | ||||
121 | <sect1 id="file-print-preview"> | ||||
122 | <title>The Print-Preview Dialog</title> | ||||
123 | | ||||
124 | <para>&kaddressbook;'s <quote>Print Preview</quote> function lets you tailor a hard-copy of your address book | ||||
125 | data just about any way you want.</para> | ||||
126 | | ||||
127 | <para> | ||||
128 | <screenshot id="screenshot-print-preview-a"> | ||||
129 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</screeninfo> | ||||
130 | <mediaobject> | ||||
131 | <imageobject> | ||||
132 | <imagedata fileref="addressbook120.png" format="PNG"/> | ||||
133 | </imageobject> | ||||
134 | <textobject> | ||||
135 | <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase> | ||||
136 | </textobject> | ||||
137 | <caption> | ||||
138 | <para>&kaddressbook;'s <quote>Print Preview</quote> dialog. You may select one or more entire | ||||
139 | address books, or just a smattering of individual contacts.</para> | ||||
140 | </caption> | ||||
141 | </mediaobject> | ||||
142 | </screenshot> | ||||
143 | </para> | ||||
144 | | ||||
145 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
146 | | ||||
147 | <para>The first step is to select the contacts to be included in the printout. If you wish to print just a | ||||
148 | smattering of individual contacts, you must choose the contacts to be printed before invoking the | ||||
149 | <menuchoice><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png" | ||||
150 | format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice> dialog. If you wish | ||||
151 | to select all your contacts, or all the contacts in a particular address book, you can do it here. Click | ||||
152 | <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject> | ||||
153 | </inlinemediaobject>Next</guibutton> when you have made your selection. A new screen will appear.</para> | ||||
154 | | ||||
155 | <para> | ||||
156 | <screenshot id="screenshot-print-preview-b"> | ||||
157 | <screeninfo>A second screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</screeninfo> | ||||
158 | <mediaobject> | ||||
159 | <imageobject> | ||||
160 | <imagedata fileref="addressbook121.png" format="PNG"/> | ||||
161 | </imageobject> | ||||
162 | <textobject> | ||||
163 | <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase> | ||||
164 | </textobject> | ||||
165 | <caption> | ||||
166 | <para>The second screen in &kaddressbook;'s <quote>Print Preview</quote> dialog. You may choose a sort field | ||||
167 | and a sort direction (up or down). You may also choose among seven different print layouts.</para> | ||||
168 | </caption> | ||||
169 | </mediaobject> | ||||
170 | </screenshot> | ||||
171 | </para> | ||||
172 | | ||||
173 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
174 | | ||||
175 | <para>Here you can choose a sort field (any one of the 47 named fields in the contact record), the | ||||
176 | direction of the sort, and any one of seven different report formats. When you click <guibutton> | ||||
177 | <inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject> | ||||
178 | </inlinemediaobject>Next</guibutton>, you will be given a chance to tailor the color scheme to | ||||
179 | be used.</para> | ||||
180 | | ||||
181 | <para> | ||||
182 | <screenshot id="screenshot-print-preview-c"> | ||||
183 | <screeninfo>A third screenshot of &kaddressbook;'s <quote>Pint Preview</quote> dialog.</screeninfo> | ||||
184 | <mediaobject> | ||||
185 | <imageobject> | ||||
186 | <imagedata fileref="addressbook122.png" format="PNG"/> | ||||
187 | </imageobject> | ||||
188 | <textobject> | ||||
189 | <phrase>A third screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase> | ||||
190 | </textobject> | ||||
191 | <caption> | ||||
192 | <para>The third screen in &kaddressbook;'s <quote>Print Preview</quote> dialog. You may select a | ||||
193 | color scheme here.</para> | ||||
194 | </caption> | ||||
195 | </mediaobject> | ||||
196 | </screenshot> | ||||
197 | </para> | ||||
198 | | ||||
199 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
200 | | ||||
201 | <para>Here is a picture of the completed report. It is now ready for printing.</para> | ||||
202 | | ||||
203 | <para> | ||||
204 | <screenshot id="screenshot-print-preview-d"> | ||||
205 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Pint Preview</quote> dialog.</screeninfo> | ||||
206 | <mediaobject> | ||||
207 | <imageobject> | ||||
208 | <imagedata fileref="addressbook123.png" format="PNG"/> | ||||
209 | </imageobject> | ||||
210 | <textobject> | ||||
211 | <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase> | ||||
212 | </textobject> | ||||
213 | <caption> | ||||
214 | <para>&kaddressbook;'s <quote>Print Preview</quote> after the report has been generated and | ||||
215 | is ready to print. You may select alternative print orientations (landscape or portrait) and | ||||
216 | launch the print task from this window.</para> | ||||
217 | </caption> | ||||
218 | </mediaobject> | ||||
219 | </screenshot> | ||||
220 | </para> | ||||
221 | | ||||
222 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
223 | | ||||
224 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
225 | | ||||
226 | </sect1> | ||||
227 | | ||||
228 | <sect1 id="configure-ldap-server"> | ||||
229 | <title>The Configure LDAP Dialog</title> | ||||
230 | | ||||
231 | <para>Here is a picture of the first configuration screen that appears when you choose either the | ||||
232 | <guibutton>Configure LDAP Servers...</guibutton> button in the <menuchoice><guimenu>File</guimenu> | ||||
233 | <guisubmenu>Import ></guisubmenu><guimenuitem>Import from LDAP Server...</guimenuitem> | ||||
234 | </menuchoice> dialog or the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject> | ||||
235 | <imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject>Configure | ||||
236 | &kaddressbook;...</guisubmenu></menuchoice> menu item.</para> | ||||
237 | | ||||
238 | <para> | ||||
239 | <screenshot id="screenshot-ldap1"> | ||||
240 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</screeninfo> | ||||
241 | <mediaobject> | ||||
242 | <imageobject> | ||||
243 | <imagedata fileref="addressbook131.png" format="PNG"/> | ||||
244 | </imageobject> | ||||
245 | <textobject> | ||||
246 | <phrase>A screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</phrase> | ||||
247 | </textobject> | ||||
248 | <caption> | ||||
249 | <para>&kaddressbook;'s <quote>Configure LDAP Server</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import | ||||
250 | ></guisubmenu><guimenuitem>Import from LDAP Server...</guimenuitem></menuchoice> function and left clicking the | ||||
251 | <guibutton>Configure LDAP Servers...</guibutton> button.</para> | ||||
252 | </caption> | ||||
253 | </mediaobject> | ||||
254 | </screenshot> | ||||
255 | </para> | ||||
256 | | ||||
257 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
258 | | ||||
259 | <para>If you have already configured one or more <acronym>LDAP</acronym> servers, use this screen to select the servers | ||||
260 | that should be queried when you search for a name or email address. Use the <guibutton>Add host...</guibutton> button to | ||||
261 | add a new server to the list of available <acronym>LDAP</acronym> hosts. Use the <guibutton>Edit host...</guibutton> | ||||
262 | button to reconfigure a server that's already on the list, and the <guibutton>Remove host</guibutton> button to | ||||
263 | delete an entry you don't need any more. The <guibutton><inlinemediaobject><imageobject><imagedata fileref="edit-undo.png" | ||||
264 | format="PNG"/></imageobject></inlinemediaobject>Reset</guibutton> button can be used to undo the last <quote>Add</quote> | ||||
265 | or <quote>Remove</quote> action performed. The <quote>Defaults</quote> button is inoperative in release 5.10.3. The rest | ||||
266 | of the buttons (OK, Apply, Cancel) have their ordinary functions: apply changes and exit, apply changes and stay here, | ||||
267 | and exit the dialog without making any changes, respectively.</para> | ||||
268 | | ||||
269 | <para> </para> <!-- add more white space @dcb --> | ||||
270 | | ||||
271 | <para>When you choose either the <guibutton>Add host...</guibutton> button or the <guibutton>Edit host...</guibutton> | ||||
272 | button, the following dialog will appear.</para> | ||||
273 | | ||||
274 | <para> | ||||
275 | <screenshot id="screenshot-ldap2"> | ||||
276 | <screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</screeninfo> | ||||
277 | <mediaobject> | ||||
278 | <imageobject> | ||||
279 | <imagedata fileref="addressbook132.png" format="PNG"/> | ||||
280 | </imageobject> | ||||
281 | <textobject> | ||||
282 | <phrase>A second screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</phrase> | ||||
283 | </textobject> | ||||
284 | <caption> | ||||
285 | <para>&kaddressbook;'s <quote>Configure LDAP Server</quote> dialog after left clicking either the | ||||
286 | <guibutton>Add Host...</guibutton> or the <guibutton>Edit Host...</guibutton> button.</para> | ||||
287 | </caption> | ||||
288 | </mediaobject> | ||||
289 | </screenshot> | ||||
290 | </para> | ||||
291 | | ||||
292 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
293 | | ||||
294 | <para>The first four fields (<quote>User:</quote>, <quote>Bind DN:</quote>, <quote>Realm:</quote>, and | ||||
295 | <quote>Password:</quote>) will all be grayed out unless authentication is required. Obtain these credentials | ||||
296 | from the LDAP server's administrator. Enter the appropriate URI in the <quote>Host:</quote> field. The default | ||||
297 | values for <quote>Port:</quote>, <quote>Size limit:</quote>, &etc; will work OK for most users. You can use the | ||||
298 | <guibutton>Query Server</guibutton> button to set up the <quote>DN:</quote> field. I have no idea what the | ||||
299 | <quote>Filter:</quote> field is for. If you figure it out, please let me know (davidbryant AT gvtc.com).</para> | ||||
300 | | ||||
301 | <para>Use the <quote>Security</quote> section to specify the encryption method to use: <quote>No</quote> for | ||||
302 | an unencrypted connection, <glossterm linkend="gloss-tls"><acronym>TLS</acronym></glossterm> for Transport Layer | ||||
303 | Security, or <glossterm linkend="gloss-ssl"><acronym>SSL</acronym></glossterm> for Secure Socket Layer. Use the | ||||
304 | <quote>Authentication</quote> options to specify what level of authentication the server requires: | ||||
305 | <quote>Anonymous</quote> for no name or password at all, <quote>Simple</quote> if <quote>Bind DN</quote> and | ||||
306 | <quote>Password</quote> must be given, and <glossterm linkend="gloss-sasl"><acronym>SASL</acronym></glossterm> | ||||
307 | (Simple Authentication and Security Layer) for the whole schmear (four data items). If <quote>SASL</quote> is | ||||
308 | chosen, use the <guibutton>Query Server</guibutton> button to set the advanced options for this host.</para> | ||||
309 | | ||||
310 | <para> </para> <!-- add more white space @dcb --> | ||||
311 | | ||||
312 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
313 | | ||||
314 | </sect1> | ||||
315 | | ||||
316 | <sect1 id="import-csv-data"> | ||||
317 | <title>The Import CSV File Function</title> | ||||
318 | | ||||
319 | <para>When you choose the <menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu> | ||||
320 | <guimenuitem>Import CSV file...</guimenuitem></menuchoice> function, you will be presented with a dialog. | ||||
321 | After you click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-open.png" format="PNG"/> | ||||
322 | </imageobject></inlinemediaobject></guibutton> button and choose the file to be imported, the screen will | ||||
323 | look like this.</para> | ||||
324 | | ||||
325 | <para> | ||||
326 | <screenshot id="screenshot-import-csv"> | ||||
327 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</screeninfo> | ||||
328 | <mediaobject> | ||||
329 | <imageobject> | ||||
330 | <imagedata fileref="addressbook103.png" format="PNG"/> | ||||
331 | </imageobject> | ||||
332 | <textobject> | ||||
333 | <phrase>A screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</phrase> | ||||
334 | </textobject> | ||||
335 | <caption> | ||||
336 | <para>&kaddressbook;'s <quote>Import CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import | ||||
337 | ></guisubmenu><guimenuitem>Import CSV file...</guimenuitem></menuchoice> function and selecting the file to be imported.</para> | ||||
338 | </caption> | ||||
339 | </mediaobject> | ||||
340 | </screenshot> | ||||
341 | </para> | ||||
342 | | ||||
343 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
344 | | ||||
345 | <para>Use the <quote>Delimiter</quote> section of this dialog to specify which separator character defines the end of a field in the | ||||
346 | chosen input file. If quote marks are used to delimit fields with embedded separator characters, you may specify the style (single | ||||
347 | or double quote) used via the <quote>Text quote:</quote> drop-down box. If the input file contains dates, use the <quote>Date format:</quote> | ||||
348 | field to define the way dates have been encoded. The default is yyyy-mm-dd. If that's the wrong format, hover your cursor over the | ||||
349 | <quote>Date format:</quote> box and a handy set of formatting instructions will be displayed. If the input file is not UTF-8 encoded, | ||||
350 | use the <quote>Text codec:</quote> drop-down box to specify the binary encoding scheme to use. If the first row of the file contains | ||||
351 | column headers, check the <quote>Skip first row of file</quote> box to avoid importing the column headers as data. Use the | ||||
352 | <quote>Undefined</quote> boxes at the top of each column to specify which data fields are to be imported, and where they should be | ||||
353 | stored, as shown below.</para> | ||||
354 | | ||||
355 | <para> | ||||
356 | <screenshot id="screenshot-import-csv-2"> | ||||
357 | <screeninfo>A second screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</screeninfo> | ||||
358 | <mediaobject> | ||||
359 | <imageobject> | ||||
360 | <imagedata fileref="addressbook104.png" format="PNG"/> | ||||
361 | </imageobject> | ||||
362 | <textobject> | ||||
363 | <phrase>A second screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</phrase> | ||||
364 | </textobject> | ||||
365 | <caption> | ||||
366 | <para>&kaddressbook;'s <quote>Import CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import | ||||
367 | ></guisubmenu><guimenuitem>Import CSV file...</guimenuitem></menuchoice> function, selecting the file to be imported, and | ||||
368 | beginning to define the fields to be imported.</para> | ||||
369 | </caption> | ||||
370 | </mediaobject> | ||||
371 | </screenshot> | ||||
372 | </para> | ||||
373 | | ||||
374 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
375 | | ||||
376 | <para>If you wish the contents of the current column to be imported, choose a destination from the list of field names appearing beneath the | ||||
377 | blue <quote>Undefined</quote> box. See <link linkend="export-csv-data">the next section</link> for a list of the pre-defined fields. Use the | ||||
378 | horizontal scrollbar near the bottom of the dialog to view all the columns in the input file. When your selections are complete, click the | ||||
379 | <guibutton> ✔ OK </guibutton> button. If you have defined multiple address books, you will be asked to specify which address | ||||
380 | book is to be used. &kaddressbook; will then import the selected data as new contacts.</para> | ||||
381 | | ||||
382 | <para>If you intend to import additional datasets in the same format sometime in the future, you may click the <guibutton>Save template...</guibutton> | ||||
383 | button (cf. the first illustration in this section) to save the selections you have made. You will be prompted to give the template a name. | ||||
384 | Later, when you import another file with the same layout, you can save time by clicking the <guibutton>Apply template...</guibutton> button.</para> | ||||
385 | | ||||
386 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
387 | | ||||
388 | </sect1> | ||||
389 | | ||||
390 | <sect1 id="export-csv-data"> | ||||
391 | <title>The Export CSV File Function</title> | ||||
392 | | ||||
393 | <para>When you invoke the <menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export | ||||
394 | CSV file ...</guimenuitem></menuchoice> function, a dialog box appears.</para> | ||||
395 | | ||||
396 | <para> | ||||
397 | <screenshot id="screenshot-export-csv"> | ||||
398 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Export CSV File</quote> dialog.</screeninfo> | ||||
399 | <mediaobject> | ||||
400 | <imageobject> | ||||
401 | <imagedata fileref="addressbook100.png" format="PNG"/> | ||||
402 | </imageobject> | ||||
403 | <textobject> | ||||
404 | <phrase>A screenshot of &kaddressbook;'s <quote>Export CSV File</quote> dialog.</phrase> | ||||
405 | </textobject> | ||||
406 | <caption> | ||||
407 | <para>&kaddressbook;'s <quote>Export CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Export | ||||
408 | ></guisubmenu><guimenuitem>Export CSV file ...</guimenuitem></menuchoice> function.</para> | ||||
409 | </caption> | ||||
410 | </mediaobject> | ||||
411 | </screenshot> | ||||
412 | </para> | ||||
413 | | ||||
414 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
415 | | ||||
416 | <para>You may select all your contact data, or just a portion of it. When you press the <guibutton> ✔ OK </guibutton> button, | ||||
417 | you will be allowed to choose the name of the generated file, and the directory in which it will be written. The output file will contain the | ||||
418 | following forty-seven (47) output fields, in this order, left to right. This list of field names is included as the first record in the file.</para> | ||||
419 | | ||||
420 | <para>Formatted Name | Honorific Prefixes | Given Name | Additional Names | Family Name | Honorific Suffixes | Nick Name | Birthday | Anniversary | | ||||
421 | EMail (preferred) | EMail (2) | EMail (3) | EMail (4) | Home Address Street | Home Address Post Office Box | Home Address City | Home Address State | | ||||
422 | Home Address Zip Code | Home Address Country | Home Address Label | Business Address Street | Business Address Post Office Box | Business Address City | | ||||
423 | Business Address State | Business Address Zip Code | Business Address Country | Business Address Label | Home Phone | Business Phone | Mobile Phone | | ||||
424 | Home Fax | Business Fax | Car Phone | ISDN | Pager | Mail Client | Title | Role | Organization | Note | Homepage | Blog Feed | Profession | Office | | ||||
425 | Manager | Assistant | Spouse</para> | ||||
426 | | ||||
427 | <para>All fields are formatted as character class data. Dates (Birthday and Anniversary, if present) are coded as | ||||
428 | yyyy-mm-dd (Year, Month, Day).</para> | ||||
429 | | ||||
430 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
431 | | ||||
432 | | ||||
433 | </sect1> | ||||
434 | | ||||
435 | <sect1 id="view-change-columns"> | ||||
436 | <title>The Change Number of Columns Function</title> | ||||
437 | | ||||
438 | <para>When you open the <menuchoice><guimenu>View</guimenu></menuchoice> menu, the following screen appears.</para> | ||||
439 | | ||||
440 | <para> | ||||
441 | <screenshot id="screenshot-view-menu-appendix"> | ||||
442 | <screeninfo>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</screeninfo> | ||||
443 | <mediaobject> | ||||
444 | <imageobject> | ||||
445 | <imagedata fileref="addressbook82.png" format="PNG"/> | ||||
446 | </imageobject> | ||||
447 | <textobject> | ||||
448 | <phrase>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</phrase> | ||||
449 | </textobject> | ||||
450 | <caption> | ||||
451 | <para>&kaddressbook;'s <quote>View</quote> menu after choosing the <menuchoice><guimenu>View</guimenu></menuchoice> | ||||
452 | menu on the main Menubar.</para> | ||||
453 | </caption> | ||||
454 | </mediaobject> | ||||
455 | </screenshot> | ||||
456 | </para> | ||||
457 | | ||||
458 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
459 | | ||||
460 | <para>Not happy with the hum-drum three column layout appearing above? Jazz things up a little with this minimalist approach.</para> | ||||
461 | | ||||
462 | <para> | ||||
463 | <screenshot id="screenshot-view-menu-appendix-2"> | ||||
464 | <screeninfo>A screenshot of &kaddressbook;'s single panel layout.</screeninfo> | ||||
465 | <mediaobject> | ||||
466 | <imageobject> | ||||
467 | <imagedata fileref="addressbook110.png" format="PNG"/> | ||||
468 | </imageobject> | ||||
469 | <textobject> | ||||
470 | <phrase>A screenshot of &kaddressbook;'s single panel layout.</phrase> | ||||
471 | </textobject> | ||||
472 | <caption> | ||||
473 | <para>&kaddressbook;'s <quote>Simple (one column)</quote> layout. Only the basic contact | ||||
474 | data are visible.</para> | ||||
475 | </caption> | ||||
476 | </mediaobject> | ||||
477 | </screenshot> | ||||
478 | </para> | ||||
479 | | ||||
480 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
481 | | ||||
482 | <para>Notice that the information about which address books exist and are in use is not visible when this <quote>Simple</quote> | ||||
483 | layout is in effect. Only the contacts from the address books that were selected before choosing this view are displayed.</para> | ||||
484 | | ||||
485 | <para> </para> <!-- add more white space @dcb --> | ||||
486 | | ||||
487 | <para>If the <quote>Simple</quote> layout does not appeal to you, you may want to try the <quote>Two columns</quote> style.</para> | ||||
488 | | ||||
489 | <para> | ||||
490 | <screenshot id="screenshot-view-menu-appendix-3"> | ||||
491 | <screeninfo>A screenshot of &kaddressbook;'s double panel layout.</screeninfo> | ||||
492 | <mediaobject> | ||||
493 | <imageobject> | ||||
494 | <imagedata fileref="addressbook111.png" format="PNG"/> | ||||
495 | </imageobject> | ||||
496 | <textobject> | ||||
497 | <phrase>A screenshot of &kaddressbook;'s double panel layout.</phrase> | ||||
498 | </textobject> | ||||
499 | <caption> | ||||
500 | <para>&kaddressbook;'s <quote>Two columns</quote> layout. The list of address books is | ||||
501 | stacked on top of the alphabetized contact list.</para> | ||||
502 | </caption> | ||||
503 | </mediaobject> | ||||
504 | </screenshot> | ||||
505 | </para> | ||||
506 | | ||||
507 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
508 | | ||||
509 | <para> At &kde;, our motto is "Be Free!" We aim to give you maximum flexibility when it comes to tailoring | ||||
510 | and configuring our software to suit your tastes. We toyed with the idea of adding even more views to | ||||
511 | &kaddressbook; (Four columns! Five!), but eventually concluded that enough is enough.</para> | ||||
512 | | ||||
513 | <para> </para> <!-- add more white space @dcb --> | ||||
514 | | ||||
515 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
516 | | ||||
517 | </sect1> | ||||
518 | | ||||
519 | <sect1 id="settings-configure-shortcuts"> | ||||
520 | <title>The Configure Shortcuts Option</title> | ||||
521 | | ||||
522 | <para>When you first select the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject> | ||||
523 | <imagedata fileref="input-keyboard.png" format="PNG"/></imageobject></inlinemediaobject>Configure Shortcuts...</guisubmenu> | ||||
524 | </menuchoice> option, this is what you will see.</para> | ||||
525 | | ||||
526 | <para> | ||||
527 | <screenshot id="screenshot-config-shortcut1"> | ||||
528 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</screeninfo> | ||||
529 | <mediaobject> | ||||
530 | <imageobject> | ||||
531 | <imagedata fileref="addressbook112.png" format="PNG"/> | ||||
532 | </imageobject> | ||||
533 | <textobject> | ||||
534 | <phrase>A screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</phrase> | ||||
535 | </textobject> | ||||
536 | <caption> | ||||
537 | <para>&kaddressbook;'s <quote>Configure Shortcuts</quote> dialog. Use the <quote>Search</quote> field, or the | ||||
538 | vertical scrollbar, to locate the action for which a new keyboard shortcut is to be defined.</para> | ||||
539 | </caption> | ||||
540 | </mediaobject> | ||||
541 | </screenshot> | ||||
542 | </para> | ||||
543 | | ||||
544 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
545 | | ||||
546 | <para>The &kaddressbook; actions for which keyboard shortcuts have already been defined are clearly marked in the | ||||
547 | <quote>Shortcut</quote> column. You may either assign additional shortcuts via the <quote>Alternate</quote>, | ||||
548 | <quote>Global</quote>, and <quote>Global Alternate</quote> columns in this table, or assign a new shortcut to | ||||
549 | an action for which no keyboard shortcut has as yet been defined. Select the action to be configured by clicking | ||||
550 | its name, as illustrated above. </para> | ||||
551 | | ||||
552 | <para> </para> <!-- add more white space @dcb --> | ||||
553 | | ||||
554 | <para>When you left-click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/> | ||||
555 | </imageobject></inlinemediaobject>None</guibutton> button, its name will change to <quote>Input...</quote>; you can then | ||||
556 | record the combination of keystrokes you wish to assign to the selected action. (Hover the cursor over the <guibutton> | ||||
557 | <inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject>None</guibutton> | ||||
558 | button to view a handy hint about this procedure.) The program will note which keys you have pressed, and record the new | ||||
559 | keyboard shortcut, as illustrated below. If you choose a combination that conflicts with an existing shortcut assignment, | ||||
560 | you will see an error message, and you will be prompted to make a different selection. You may use the <guibutton><inlinemediaobject> | ||||
561 | <imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button to | ||||
562 | erase your selection.</para> | ||||
563 | | ||||
564 | <para> | ||||
565 | <screenshot id="screenshot-config-shortcut2"> | ||||
566 | <screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</screeninfo> | ||||
567 | <mediaobject> | ||||
568 | <imageobject> | ||||
569 | <imagedata fileref="addressbook113.png" format="PNG"/> | ||||
570 | </imageobject> | ||||
571 | <textobject> | ||||
572 | <phrase>A second screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</phrase> | ||||
573 | </textobject> | ||||
574 | <caption> | ||||
575 | <para>&kaddressbook;'s <quote>Configure Shortcuts</quote> dialog after a new keyboard shortcut has | ||||
576 | been entered, but before the new configuration has been saved.</para> | ||||
577 | </caption> | ||||
578 | </mediaobject> | ||||
579 | </screenshot> | ||||
580 | </para> | ||||
581 | | ||||
582 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
583 | | ||||
584 | <para>Click the <guibutton> ✔ OK </guibutton> button to save your changes. Click on | ||||
585 | <guibutton> ⦸ Cancel </guibutton> to exit without saving your changes. Click | ||||
586 | <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-revert.png" format="PNG"/> | ||||
587 | </imageobject></inlinemediaobject>Defaults</guibutton> to restore &kaddressbook;'s default set of | ||||
588 | keyboard shortcuts. Choose <guibutton> Manage Schemes >> </guibutton> to integrate | ||||
589 | your custom assignments into a larger scheme of shortcut assignments; see the <quote>Customizing KDE | ||||
590 | Software</quote> chapter in the <quote>Fundamentals</quote> handbook for more details.</para> | ||||
591 | | ||||
592 | <para>You may select the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-print.png" | ||||
593 | format="PNG"/></imageobject></inlinemediaobject>Print</guibutton> button to produce a hard-copy version | ||||
594 | of the keyboard shortcut assignments. Here is a sample from the printed table.</para> | ||||
595 | | ||||
596 | <para> | ||||
597 | <screenshot id="screenshot-config-shortcut3"> | ||||
598 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Print</quote> output.</screeninfo> | ||||
599 | <mediaobject> | ||||
600 | <imageobject> | ||||
601 | <imagedata fileref="addressbook114.png" format="PNG"/> | ||||
602 | </imageobject> | ||||
603 | <textobject> | ||||
604 | <phrase>A screenshot of &kaddressbook;'s <quote>Print</quote> output.</phrase> | ||||
605 | </textobject> | ||||
606 | <caption> | ||||
607 | <para>An excerpt from &kaddressbook;'s printed list of keyboard shortcuts.</para> | ||||
608 | </caption> | ||||
609 | </mediaobject> | ||||
610 | </screenshot> | ||||
611 | </para> | ||||
612 | | ||||
613 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
614 | | ||||
615 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
616 | | ||||
617 | </sect1> | ||||
618 | | ||||
619 | <sect1 id="settings-configure-toolbars"> | ||||
620 | <title>The Configure Toolbars Option</title> | ||||
621 | | ||||
622 | <para>Here is a picture of the screen that appears when you click on the <menuchoice><guimenu>Settings</guimenu> | ||||
623 | <guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject> | ||||
624 | </inlinemediaobject>Configure Toolbars...</guisubmenu></menuchoice> menu item.</para> | ||||
625 | | ||||
626 | <para> | ||||
627 | <screenshot id="screenshot-config-toolbars"> | ||||
628 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure Toolbars</quote> dialog.</screeninfo> | ||||
629 | <mediaobject> | ||||
630 | <imageobject> | ||||
631 | <imagedata fileref="addressbook130.png" format="PNG"/> | ||||
632 | </imageobject> | ||||
633 | <textobject> | ||||
634 | <phrase>A screenshot of &kaddressbook;'s <quote>Configure Toolbars</quote> dialog.</phrase> | ||||
635 | </textobject> | ||||
636 | <caption> | ||||
637 | <para>&kaddressbook;'s <quote>Configure Toolbars</quote> dialog. Actions that are already displayed | ||||
638 | on the Toolbar appear in the large window on the right. Actions in the left-hand window may be | ||||
639 | added to the Toolbar, as explained below.</para> | ||||
640 | </caption> | ||||
641 | </mediaobject> | ||||
642 | </screenshot> | ||||
643 | </para> | ||||
644 | | ||||
645 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
646 | | ||||
647 | <para>Use either one of the <quote>Filter</quote> fields to restrict the range of choices displayed in the corresponding | ||||
648 | window. Select an action in the left-hand window (as shown above) if you wish to add it to the Toolbar. Left click the | ||||
649 | <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject></inlinemediaobject> | ||||
650 | </guibutton> button to add the item to the list in the right-hand window (and thence to &kaddressbook;'s Toolbar). If you | ||||
651 | want to delete an item from the Toolbar simply reverse the procedure: highlight the item to be deleted from the right-hand | ||||
652 | window and click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-previous.png" format="PNG"/></imageobject> | ||||
653 | </inlinemediaobject></guibutton> button. The selected item will be removed from the Toolbar.</para> | ||||
654 | | ||||
655 | <para>You may tailor the order in which selected items appear on the Toolbar by using drag and drop within the right-hand | ||||
656 | window. The order of items on the Toolbar, left to right, corresponds with the order in the window, top to bottom. You may | ||||
657 | make additional changes to the appearance of the Toolbar by using the <guibutton><inlinemediaobject><imageobject><imagedata | ||||
658 | fileref="change-icon.png" format="PNG"/></imageobject></inlinemediaobject>Change Icon...</guibutton> button to alter the icon | ||||
659 | associated with a particular action. Similarly, you may change the description of each item on the Toolbar by clicking the | ||||
660 | <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject> | ||||
661 | </inlinemediaobject>Change Text...</guibutton> button.</para> | ||||
662 | | ||||
663 | <para>Use the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-revert.png" format="PNG"/></imageobject> | ||||
664 | </inlinemediaobject>Defaults</guibutton> button to restore the default Toolbar settings. Choose <quote>OK</quote> to | ||||
665 | save your changes and exit the dialog, <quote>Apply</quote> to apply your changes while keeping the dialog open, or | ||||
666 | <quote>Cancel</quote> to exit the dialog without saving your changes. (See the <quote>Customizing KDE Software</quote> | ||||
667 | chapter in the <quote>Fundamentals</quote> handbook for a more detailed explanation of this procedure.)</para> | ||||
668 | | ||||
669 | <para> </para> <!-- add more white space @dcb --> | ||||
670 | | ||||
671 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
672 | | ||||
673 | </sect1> | ||||
674 | | ||||
675 | <sect1 id="settings-configure-kaddressbook"> | ||||
676 | <title>The Configure &kaddressbook; Option</title> | ||||
677 | | ||||
678 | <para>When the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" | ||||
679 | format="PNG"/></imageobject></inlinemediaobject>Configure &kaddressbook;...</guisubmenu></menuchoice> option is selected, this | ||||
680 | screen will appear.</para> | ||||
681 | | ||||
682 | <para> | ||||
683 | <screenshot id="screenshot-config-general"> | ||||
684 | <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo> | ||||
685 | <mediaobject> | ||||
686 | <imageobject> | ||||
687 | <imagedata fileref="addressbook133.png" format="PNG"/> | ||||
688 | </imageobject> | ||||
689 | <textobject> | ||||
690 | <phrase>A screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase> | ||||
691 | </textobject> | ||||
692 | <caption> | ||||
693 | <para>&kaddressbook;'s <quote>Configure Contact Actions</quote> dialog. These features are still | ||||
694 | experimental, and not yet entirely operational.</para> | ||||
695 | </caption> | ||||
696 | </mediaobject> | ||||
697 | </screenshot> | ||||
698 | </para> | ||||
699 | | ||||
700 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
701 | | ||||
702 | <para>The first dialog that appears supports experimental features that have not yet been completely implemented. | ||||
703 | You may select from several different options under the headings <quote>Show Address</quote>, <quote>Dial Phone | ||||
704 | Number</quote>, or <quote>Send SMS</quote>, but there isn't yet any software to do anything with the options you | ||||
705 | choose.</para> | ||||
706 | | ||||
707 | <para> </para> <!-- add more white space @dcb --> | ||||
708 | | ||||
709 | <para>The next option, <quote>LDAP Server Settings</quote>, is the same dialog that is documented in the preceding | ||||
710 | section entitled <link linkend="configure-ldap-server"><quote>The Configure LDAP Dialog</quote></link>.</para> | ||||
711 | | ||||
712 | <para> | ||||
713 | <screenshot id="screenshot-config-ldap"> | ||||
714 | <screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo> | ||||
715 | <mediaobject> | ||||
716 | <imageobject> | ||||
717 | <imagedata fileref="addressbook134.png" format="PNG"/> | ||||
718 | </imageobject> | ||||
719 | <textobject> | ||||
720 | <phrase>A second screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase> | ||||
721 | </textobject> | ||||
722 | <caption> | ||||
723 | <para>&kaddressbook;'s <quote>LDAP Server Settings</quote> dialog. This dialog, and its child, are documented | ||||
724 | in <link linkend="configure-ldap-server">a preceding section</link> of this appendix.</para> | ||||
725 | </caption> | ||||
726 | </mediaobject> | ||||
727 | </screenshot> | ||||
728 | </para> | ||||
729 | | ||||
730 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
731 | | ||||
732 | <para>The final set of options for configuring &kaddressbook; appears when you select <quote>Plugins</quote>.</para> | ||||
733 | | ||||
734 | <para> | ||||
735 | <screenshot id="screenshot-config-plugins"> | ||||
736 | <screeninfo>A third screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo> | ||||
737 | <mediaobject> | ||||
738 | <imageobject> | ||||
739 | <imagedata fileref="addressbook135.png" format="PNG"/> | ||||
740 | </imageobject> | ||||
741 | <textobject> | ||||
742 | <phrase>A third screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase> | ||||
743 | </textobject> | ||||
744 | <caption> | ||||
745 | <para>&kaddressbook;'s <quote>Plugins</quote> dialog. There are ten plugins all together. Seven of them | ||||
746 | have been activated by default, as shown above.</para> | ||||
747 | </caption> | ||||
748 | </mediaobject> | ||||
749 | </screenshot> | ||||
750 | </para> | ||||
751 | | ||||
752 | <para> </para> <!-- add more white space after screenshot @dcb --> | ||||
753 | | ||||
754 | <para>The actions supported by the seven default <quote>Plugins</quote> are documented in preceding sections of this | ||||
755 | manual. The <quote>Import Export <glossterm linkend="gloss-gmx"><acronym>GMX</acronym></glossterm></quote> and | ||||
756 | <quote>Import/Export <glossterm linkend="gloss-ldif"><acronym>LDIF</acronym></glossterm></quote> actions will appear | ||||
757 | as part of the <menuchoice><guimenu>File</guimenu></menuchoice> menu when activated. The <quote>Check <glossterm | ||||
758 | linkend="gloss-gravatar">Gravatar</glossterm></quote> item will appear in the <menuchoice><guimenu>Tools</guimenu> | ||||
759 | </menuchoice> menu when it is activated. Notice that &kaddressbook; must be stopped and restarted before any changes | ||||
760 | to the <quote>Plugins</quote> will take effect. </para> | ||||
761 | | ||||
762 | <para> </para> <!-- add more white space @dcb --> | ||||
763 | | ||||
764 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
765 | | ||||
766 | </sect1> | ||||
767 | | ||||
768 | <sect1 id="credits-and-licenses"> | ||||
769 | <title>Credits and Licenses</title> | ||||
770 | | ||||
771 | <para> | ||||
772 | &kaddressbook; | ||||
773 | </para> | ||||
774 | | ||||
775 | <para> | ||||
776 | Copyright © 2007–2019 KAddressBook authors <email>montel@kde.org</email> | ||||
777 | </para> | ||||
778 | | ||||
779 | <para> | ||||
780 | Documentation Copyright © 2019 David C. Bryant <email>davidbryant@gvtc.com</email> | ||||
781 | </para> | ||||
782 | | ||||
783 | <!-- TRANS:CREDIT_FOR_TRANSLATORS --> | ||||
784 | | ||||
785 | <!-- License for new documents after 2017-07-27 (or relicensed) --> | ||||
786 | | ||||
787 | &underCCBYSA4; <!-- CC BY-SA 4.0: do not remove --> | ||||
788 | | ||||
789 | <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para> | ||||
790 | | ||||
791 | </sect1> | ||||
792 | | ||||
793 | </appendix> |