[kaddressbook] /: Adding new .docbook for KAddressBook, draft version
Yuri Chornoivan
null at kde.org
Sun Sep 29 07:15:21 BST 2019
Git commit 24d6489eaa17a6a32bdfa6b35cc8f683abbed13b by Yuri Chornoivan, on behalf of David Bryant.
Committed on 29/09/2019 at 06:15.
Pushed by yurchor into branch 'master'.
Adding new .docbook for KAddressBook, draft version
Summary:
I have written the first two chapters of documentation for KAddressBook, and I'm asking for feedback
BUG: 409998
Test Plan: ? I'm new, so I don't know.
Reviewers: #documentation, #kde_pim, yurchor
Reviewed By: yurchor
Subscribers: ltoscano, mlaurent, yurchor, lueck, ognarb, kde-pim, kde-doc-english
Tags: #kde_pim, #documentation
Differential Revision: https://phabricator.kde.org/D22799
M +3 -0 CMakeLists.txt
A +- -- doc/KDE_logo.png
A +- -- doc/address-book-new.png
A +- -- doc/addressbook00.png
A +- -- doc/addressbook10.png
A +- -- doc/addressbook100.png
A +- -- doc/addressbook101.png
A +- -- doc/addressbook102.png
A +- -- doc/addressbook103.png
A +- -- doc/addressbook104.png
A +- -- doc/addressbook110.png
A +- -- doc/addressbook111.png
A +- -- doc/addressbook112.png
A +- -- doc/addressbook113.png
A +- -- doc/addressbook114.png
A +- -- doc/addressbook120.png
A +- -- doc/addressbook121.png
A +- -- doc/addressbook122.png
A +- -- doc/addressbook123.png
A +- -- doc/addressbook130.png
A +- -- doc/addressbook20.png
A +- -- doc/addressbook30.png
A +- -- doc/addressbook31.png
A +- -- doc/addressbook32.png
A +- -- doc/addressbook33.png
A +- -- doc/addressbook34.png
A +- -- doc/addressbook35.png
A +- -- doc/addressbook40.png
A +- -- doc/addressbook50.png
A +- -- doc/addressbook51.png
A +- -- doc/addressbook52.png
A +- -- doc/addressbook53.png
A +- -- doc/addressbook54.png
A +- -- doc/addressbook55.png
A +- -- doc/addressbook60.png
A +- -- doc/addressbook61.png
A +- -- doc/addressbook70.png
A +- -- doc/addressbook71.png
A +- -- doc/addressbook72.png
A +- -- doc/addressbook73.png
A +- -- doc/addressbook74.png
A +- -- doc/addressbook75.png
A +- -- doc/addressbook76.png
A +- -- doc/addressbook77.png
A +- -- doc/addressbook80.png
A +- -- doc/addressbook81.png
A +- -- doc/addressbook82.png
A +- -- doc/addressbook83.png
A +- -- doc/addressbook84.png
A +- -- doc/addressbook85.png
A +- -- doc/addressbook86.png
A +- -- doc/addressbook87.png
A +- -- doc/addressbook90.png
A +- -- doc/addressbook91.png
A +- -- doc/addressbook92.png
A +- -- doc/addressbook93.png
A +- -- doc/addressbook94.png
A +- -- doc/addressbook95.png
A +- -- doc/application-exit.png
A +- -- doc/application-x-ms-shortcut.png
A +- -- doc/change-icon.png
A +- -- doc/change-language.png
A +- -- doc/configure.png
A +793 -0 doc/docbook-reference.docbook
A +- -- doc/document-edit.png
A +- -- doc/document-open.png
A +- -- doc/document-preview-archive.png
A +- -- doc/document-print.png
A +- -- doc/document-properties.png
A +- -- doc/document-revert.png
A +- -- doc/draw-circle.png
A +- -- doc/draw-rectangle.png
A +- -- doc/edit-clear.png
A +- -- doc/edit-copy.png
A +- -- doc/edit-cut.png
A +- -- doc/edit-delete.png
A +- -- doc/edit-paste.png
A +- -- doc/edit-undo.png
A +- -- doc/folder-new.png
A +- -- doc/go-down.png
A +- -- doc/go-jump.png
A +- -- doc/go-next.png
A +- -- doc/go-previous.png
A +- -- doc/help-about.png
A +2255 -0 doc/index.docbook
A +- -- doc/input-keyboard.png
A +- -- doc/kaddressbook.png
A +- -- doc/list-add.png
A +- -- doc/list-remove.png
A +- -- doc/mail-message-new.png
A +- -- doc/show-menu.png
A +- -- doc/system-help.png
A +- -- doc/tools-report-bug.png
A +- -- doc/user-group-new.png
A +- -- doc/view-calendar-birthday.png
A +- -- doc/view-refresh.png
https://commits.kde.org/kaddressbook/24d6489eaa17a6a32bdfa6b35cc8f683abbed13b
diff --git a/CMakeLists.txt b/CMakeLists.txt
index cf300260..c5a79cbf 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -100,3 +100,6 @@ add_subdirectory(kontactplugin)
install(FILES kaddressbook.renamecategories kaddressbook.categories DESTINATION ${KDE_INSTALL_LOGGINGCATEGORIESDIR})
feature_summary(WHAT ALL FATAL_ON_MISSING_REQUIRED_PACKAGES)
+if(KF5DocTools_FOUND)
+ add_subdirectory(doc)
+endif()
diff --git a/doc/KDE_logo.png b/doc/KDE_logo.png
new file mode 100644
index 00000000..449b1095
Binary files /dev/null and b/doc/KDE_logo.png differ
diff --git a/doc/address-book-new.png b/doc/address-book-new.png
new file mode 100644
index 00000000..4e08aaea
Binary files /dev/null and b/doc/address-book-new.png differ
diff --git a/doc/addressbook00.png b/doc/addressbook00.png
new file mode 100644
index 00000000..8e42ccd9
Binary files /dev/null and b/doc/addressbook00.png differ
diff --git a/doc/addressbook10.png b/doc/addressbook10.png
new file mode 100644
index 00000000..5bbe6428
Binary files /dev/null and b/doc/addressbook10.png differ
diff --git a/doc/addressbook100.png b/doc/addressbook100.png
new file mode 100644
index 00000000..00882f4c
Binary files /dev/null and b/doc/addressbook100.png differ
diff --git a/doc/addressbook101.png b/doc/addressbook101.png
new file mode 100644
index 00000000..4fd47ef5
Binary files /dev/null and b/doc/addressbook101.png differ
diff --git a/doc/addressbook102.png b/doc/addressbook102.png
new file mode 100644
index 00000000..7cb4c852
Binary files /dev/null and b/doc/addressbook102.png differ
diff --git a/doc/addressbook103.png b/doc/addressbook103.png
new file mode 100644
index 00000000..08840680
Binary files /dev/null and b/doc/addressbook103.png differ
diff --git a/doc/addressbook104.png b/doc/addressbook104.png
new file mode 100644
index 00000000..a56a030c
Binary files /dev/null and b/doc/addressbook104.png differ
diff --git a/doc/addressbook110.png b/doc/addressbook110.png
new file mode 100644
index 00000000..b5292d0d
Binary files /dev/null and b/doc/addressbook110.png differ
diff --git a/doc/addressbook111.png b/doc/addressbook111.png
new file mode 100644
index 00000000..cc8e0ea4
Binary files /dev/null and b/doc/addressbook111.png differ
diff --git a/doc/addressbook112.png b/doc/addressbook112.png
new file mode 100644
index 00000000..ed88896e
Binary files /dev/null and b/doc/addressbook112.png differ
diff --git a/doc/addressbook113.png b/doc/addressbook113.png
new file mode 100644
index 00000000..39f94ed3
Binary files /dev/null and b/doc/addressbook113.png differ
diff --git a/doc/addressbook114.png b/doc/addressbook114.png
new file mode 100644
index 00000000..6f21e519
Binary files /dev/null and b/doc/addressbook114.png differ
diff --git a/doc/addressbook120.png b/doc/addressbook120.png
new file mode 100644
index 00000000..8567f4a5
Binary files /dev/null and b/doc/addressbook120.png differ
diff --git a/doc/addressbook121.png b/doc/addressbook121.png
new file mode 100644
index 00000000..e2ed2a72
Binary files /dev/null and b/doc/addressbook121.png differ
diff --git a/doc/addressbook122.png b/doc/addressbook122.png
new file mode 100644
index 00000000..794133cf
Binary files /dev/null and b/doc/addressbook122.png differ
diff --git a/doc/addressbook123.png b/doc/addressbook123.png
new file mode 100644
index 00000000..54067898
Binary files /dev/null and b/doc/addressbook123.png differ
diff --git a/doc/addressbook130.png b/doc/addressbook130.png
new file mode 100644
index 00000000..b88a3a28
Binary files /dev/null and b/doc/addressbook130.png differ
diff --git a/doc/addressbook20.png b/doc/addressbook20.png
new file mode 100644
index 00000000..c2062ce5
Binary files /dev/null and b/doc/addressbook20.png differ
diff --git a/doc/addressbook30.png b/doc/addressbook30.png
new file mode 100644
index 00000000..992aae5f
Binary files /dev/null and b/doc/addressbook30.png differ
diff --git a/doc/addressbook31.png b/doc/addressbook31.png
new file mode 100644
index 00000000..b832b578
Binary files /dev/null and b/doc/addressbook31.png differ
diff --git a/doc/addressbook32.png b/doc/addressbook32.png
new file mode 100644
index 00000000..3418dda9
Binary files /dev/null and b/doc/addressbook32.png differ
diff --git a/doc/addressbook33.png b/doc/addressbook33.png
new file mode 100644
index 00000000..29c56e98
Binary files /dev/null and b/doc/addressbook33.png differ
diff --git a/doc/addressbook34.png b/doc/addressbook34.png
new file mode 100644
index 00000000..6b6d7934
Binary files /dev/null and b/doc/addressbook34.png differ
diff --git a/doc/addressbook35.png b/doc/addressbook35.png
new file mode 100644
index 00000000..19686178
Binary files /dev/null and b/doc/addressbook35.png differ
diff --git a/doc/addressbook40.png b/doc/addressbook40.png
new file mode 100644
index 00000000..366761e5
Binary files /dev/null and b/doc/addressbook40.png differ
diff --git a/doc/addressbook50.png b/doc/addressbook50.png
new file mode 100644
index 00000000..49ddef79
Binary files /dev/null and b/doc/addressbook50.png differ
diff --git a/doc/addressbook51.png b/doc/addressbook51.png
new file mode 100644
index 00000000..28c3067c
Binary files /dev/null and b/doc/addressbook51.png differ
diff --git a/doc/addressbook52.png b/doc/addressbook52.png
new file mode 100644
index 00000000..5fc8ac7f
Binary files /dev/null and b/doc/addressbook52.png differ
diff --git a/doc/addressbook53.png b/doc/addressbook53.png
new file mode 100644
index 00000000..ce1a2ab1
Binary files /dev/null and b/doc/addressbook53.png differ
diff --git a/doc/addressbook54.png b/doc/addressbook54.png
new file mode 100644
index 00000000..5d4ef08c
Binary files /dev/null and b/doc/addressbook54.png differ
diff --git a/doc/addressbook55.png b/doc/addressbook55.png
new file mode 100644
index 00000000..a19628e2
Binary files /dev/null and b/doc/addressbook55.png differ
diff --git a/doc/addressbook60.png b/doc/addressbook60.png
new file mode 100644
index 00000000..94b55d04
Binary files /dev/null and b/doc/addressbook60.png differ
diff --git a/doc/addressbook61.png b/doc/addressbook61.png
new file mode 100644
index 00000000..681b0fc3
Binary files /dev/null and b/doc/addressbook61.png differ
diff --git a/doc/addressbook70.png b/doc/addressbook70.png
new file mode 100644
index 00000000..3cbee02a
Binary files /dev/null and b/doc/addressbook70.png differ
diff --git a/doc/addressbook71.png b/doc/addressbook71.png
new file mode 100644
index 00000000..f042b026
Binary files /dev/null and b/doc/addressbook71.png differ
diff --git a/doc/addressbook72.png b/doc/addressbook72.png
new file mode 100644
index 00000000..14688b1e
Binary files /dev/null and b/doc/addressbook72.png differ
diff --git a/doc/addressbook73.png b/doc/addressbook73.png
new file mode 100644
index 00000000..50b5c48a
Binary files /dev/null and b/doc/addressbook73.png differ
diff --git a/doc/addressbook74.png b/doc/addressbook74.png
new file mode 100644
index 00000000..c1c340ca
Binary files /dev/null and b/doc/addressbook74.png differ
diff --git a/doc/addressbook75.png b/doc/addressbook75.png
new file mode 100644
index 00000000..87dc031f
Binary files /dev/null and b/doc/addressbook75.png differ
diff --git a/doc/addressbook76.png b/doc/addressbook76.png
new file mode 100644
index 00000000..a68daca6
Binary files /dev/null and b/doc/addressbook76.png differ
diff --git a/doc/addressbook77.png b/doc/addressbook77.png
new file mode 100644
index 00000000..4544b0df
Binary files /dev/null and b/doc/addressbook77.png differ
diff --git a/doc/addressbook80.png b/doc/addressbook80.png
new file mode 100644
index 00000000..a9ba90ba
Binary files /dev/null and b/doc/addressbook80.png differ
diff --git a/doc/addressbook81.png b/doc/addressbook81.png
new file mode 100644
index 00000000..179a3d03
Binary files /dev/null and b/doc/addressbook81.png differ
diff --git a/doc/addressbook82.png b/doc/addressbook82.png
new file mode 100644
index 00000000..a8aa5d20
Binary files /dev/null and b/doc/addressbook82.png differ
diff --git a/doc/addressbook83.png b/doc/addressbook83.png
new file mode 100644
index 00000000..16afa519
Binary files /dev/null and b/doc/addressbook83.png differ
diff --git a/doc/addressbook84.png b/doc/addressbook84.png
new file mode 100644
index 00000000..6efea0b7
Binary files /dev/null and b/doc/addressbook84.png differ
diff --git a/doc/addressbook85.png b/doc/addressbook85.png
new file mode 100644
index 00000000..f8212723
Binary files /dev/null and b/doc/addressbook85.png differ
diff --git a/doc/addressbook86.png b/doc/addressbook86.png
new file mode 100644
index 00000000..324ff74d
Binary files /dev/null and b/doc/addressbook86.png differ
diff --git a/doc/addressbook87.png b/doc/addressbook87.png
new file mode 100644
index 00000000..bff42d47
Binary files /dev/null and b/doc/addressbook87.png differ
diff --git a/doc/addressbook90.png b/doc/addressbook90.png
new file mode 100644
index 00000000..ea14a574
Binary files /dev/null and b/doc/addressbook90.png differ
diff --git a/doc/addressbook91.png b/doc/addressbook91.png
new file mode 100644
index 00000000..26a5ed82
Binary files /dev/null and b/doc/addressbook91.png differ
diff --git a/doc/addressbook92.png b/doc/addressbook92.png
new file mode 100644
index 00000000..677501e1
Binary files /dev/null and b/doc/addressbook92.png differ
diff --git a/doc/addressbook93.png b/doc/addressbook93.png
new file mode 100644
index 00000000..485543b3
Binary files /dev/null and b/doc/addressbook93.png differ
diff --git a/doc/addressbook94.png b/doc/addressbook94.png
new file mode 100644
index 00000000..7fc45518
Binary files /dev/null and b/doc/addressbook94.png differ
diff --git a/doc/addressbook95.png b/doc/addressbook95.png
new file mode 100644
index 00000000..7b209191
Binary files /dev/null and b/doc/addressbook95.png differ
diff --git a/doc/application-exit.png b/doc/application-exit.png
new file mode 100644
index 00000000..c8e2cab0
Binary files /dev/null and b/doc/application-exit.png differ
diff --git a/doc/application-x-ms-shortcut.png b/doc/application-x-ms-shortcut.png
new file mode 100644
index 00000000..b975b80f
Binary files /dev/null and b/doc/application-x-ms-shortcut.png differ
diff --git a/doc/change-icon.png b/doc/change-icon.png
new file mode 100644
index 00000000..359390fa
Binary files /dev/null and b/doc/change-icon.png differ
diff --git a/doc/change-language.png b/doc/change-language.png
new file mode 100644
index 00000000..086f2a62
Binary files /dev/null and b/doc/change-language.png differ
diff --git a/doc/configure.png b/doc/configure.png
new file mode 100644
index 00000000..e20b8aa3
Binary files /dev/null and b/doc/configure.png differ
diff --git a/doc/docbook-reference.docbook b/doc/docbook-reference.docbook
new file mode 100644
index 00000000..f67510cd
--- /dev/null
+++ b/doc/docbook-reference.docbook
@@ -0,0 +1,793 @@
+<appendix id="docbook-reference">
+
+<appendixinfo>
+
+<authorgroup>
+
+ <author>
+ <firstname>David</firstname>
+ <othername>C.</othername>
+ <surname>Bryant</surname>
+ <affiliation><address><email>davidbryant at gvtc.com</email></address></affiliation>
+ </author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<copyright>
+ <year>2019</year>
+ <holder>David C. Bryant</holder>
+</copyright>
+
+<legalnotice>&CCBYSA4Notice;</legalnotice>
+
+<date>2019-08-26</date>
+<releaseinfo>5.10.3 (Applications 18.12.3)</releaseinfo>
+
+<abstract>
+ <para>&kaddressbook; is a very complicated program with lots of built-in features.
+ Some of the more advanced features of &kaddressbook; are documented in this appendix,
+ primarily to keep the main document from getting too large and unwieldy.
+ </para>
+</abstract>
+
+<!--TODO Note to self: add more keywords later. -->
+<keywordset>
+ <keyword>KDE</keyword>
+ <keyword>KAddressBook</keyword>
+ <keyword>kdepim</keyword>
+ <keyword>Email</keyword>
+</keywordset>
+
+</appendixinfo>
+
+<title>&kaddressbook; Advanced Features Reference Section</title>
+
+<sect1 id="placeholder">
+<title></title>
+<para></para>
+</sect1> <!-- Force a page break after Table of Contents. dcb -->
+
+<sect1 id="file-new-group">
+<title>The New Group Dialog</title>
+
+ <para>When you invoke the <guibutton><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/>
+ </imageobject></inlinemediaobject>New Group</guibutton> function, a dialog will begin, as shown below.</para>
+
+ <para>
+ <screenshot id="screenshot-new-group">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>New Group</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook101.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>New Group</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>New Group</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>New
+ ></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/>
+ </imageobject></inlinemediaobject>New Group</guimenuitem></menuchoice> function.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <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
+ <quote>Name</quote> field to give the new group a name. Enter e-mail addresses, or portions of email addresses, in the blue
+ <quote>+</quote> area. A list of potential matches will appear. Select an item in the list that pops up, and a new name
+ will be added to the list. Continue adding individual contacts to the list until it is complete, then click the
+ <guibutton> ✔ OK </guibutton> button to add this group to your address book. If you want to delete a name from
+ the list, click the <inlinemediaobject><imageobject><imagedata fileref="list-remove.png" format="PNG"/></imageobject>
+ </inlinemediaobject> icon to the right of that particular name. If you need to make changes to the group later, simply select
+ the group and use the <quote>Edit</quote> menu, or the <quote>Edit Contact</quote> button on the toolbar, to open a substantially
+ similar dialog that will let you make the desired changes.</para>
+
+ <para>The &kmail; program provides an alternative method of creating a new group in &kaddressbook;. After you have addressed an e-mail
+ message to several people, you are given the option of adding a new group to your address book, as shown below.</para>
+
+ <para>
+ <screenshot id="screenshot-new-group-via-kmail">
+ <screeninfo>A screenshot of &kmail;'s <quote>New Group</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook102.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kmail;'s <quote>New Group</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kmail;'s <quote>New Group</quote> dialog after choosing the <guibutton> Save List...
+ </guibutton> function.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>After addressing a message to a group of people, clicking the <guibutton> Save List... </guibutton>
+ button to the right of the address input area will cause the illustrated dialog box to appear. Give the list a name
+ and left click the <guibutton> Save List </guibutton> button. Another dialog box will pop up, asking you
+ to select an address book. Make your selection, and a new group will be created for you.</para>
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+<sect1 id="file-print-preview">
+<title>The Print-Preview Dialog</title>
+
+ <para>&kaddressbook;'s <quote>Print Preview</quote> function lets you tailor a hard-copy of your address book
+ data just about any way you want.</para>
+
+ <para>
+ <screenshot id="screenshot-print-preview-a">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook120.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Print Preview</quote> dialog. You may select one or more entire
+ address books, or just a smattering of individual contacts.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The first step is to select the contacts to be included in the printout. If you wish to print just a
+ smattering of individual contacts, you must choose the contacts to be printed before invoking the
+ <menuchoice><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png"
+ format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice> dialog. If you wish
+ to select all your contacts, or all the contacts in a particular address book, you can do it here. Click
+ <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Next</guibutton> when you have made your selection. A new screen will appear.</para>
+
+ <para>
+ <screenshot id="screenshot-print-preview-b">
+ <screeninfo>A second screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook121.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>The second screen in &kaddressbook;'s <quote>Print Preview</quote> dialog. You may choose a sort field
+ and a sort direction (up or down). You may also choose among seven different print layouts.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Here you can choose a sort field (any one of the 47 named fields in the contact record), the
+ direction of the sort, and any one of seven different report formats. When you click <guibutton>
+ <inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Next</guibutton>, you will be given a chance to tailor the color scheme to
+ be used.</para>
+
+ <para>
+ <screenshot id="screenshot-print-preview-c">
+ <screeninfo>A third screenshot of &kaddressbook;'s <quote>Pint Preview</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook122.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A third screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>The third screen in &kaddressbook;'s <quote>Print Preview</quote> dialog. You may select a
+ color scheme here.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Here is a picture of the completed report. It is now ready for printing.</para>
+
+ <para>
+ <screenshot id="screenshot-print-preview-d">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Pint Preview</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook123.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Print Preview</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Print Preview</quote> after the report has been generated and
+ is ready to print. You may select alternative print orientations (landscape or portrait) and
+ launch the print task from this window.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+<sect1 id="configure-ldap-server">
+<title>The Configure LDAP Dialog</title>
+
+ <para>Here is a picture of the first configuration screen that appears when you choose either the
+ <guibutton>Configure LDAP Servers...</guibutton> button in the <menuchoice><guimenu>File</guimenu>
+ <guisubmenu>Import ></guisubmenu><guimenuitem>Import from LDAP Server...</guimenuitem>
+ </menuchoice> dialog or the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject>
+ <imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject>Configure
+ &kaddressbook;...</guisubmenu></menuchoice> menu item.</para>
+
+ <para>
+ <screenshot id="screenshot-ldap1">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook131.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Configure LDAP Server</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import
+ ></guisubmenu><guimenuitem>Import from LDAP Server...</guimenuitem></menuchoice> function and left clicking the
+ <guibutton>Configure LDAP Servers...</guibutton> button.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>If you have already configured one or more <acronym>LDAP</acronym> servers, use this screen to select the servers
+ that should be queried when you search for a name or email address. Use the <guibutton>Add host...</guibutton> button to
+ add a new server to the list of available <acronym>LDAP</acronym> hosts. Use the <guibutton>Edit host...</guibutton>
+ button to reconfigure a server that's already on the list, and the <guibutton>Remove host</guibutton> button to
+ delete an entry you don't need any more. The <guibutton><inlinemediaobject><imageobject><imagedata fileref="edit-undo.png"
+ format="PNG"/></imageobject></inlinemediaobject>Reset</guibutton> button can be used to undo the last <quote>Add</quote>
+ or <quote>Remove</quote> action performed. The <quote>Defaults</quote> button is inoperative in release 5.10.3. The rest
+ of the buttons (OK, Apply, Cancel) have their ordinary functions: apply changes and exit, apply changes and stay here,
+ and exit the dialog without making any changes, respectively.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+
+ <para>When you choose either the <guibutton>Add host...</guibutton> button or the <guibutton>Edit host...</guibutton>
+ button, the following dialog will appear.</para>
+
+ <para>
+ <screenshot id="screenshot-ldap2">
+ <screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook132.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A second screenshot of &kaddressbook;'s <quote>Configure LDAP Server</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Configure LDAP Server</quote> dialog after left clicking either the
+ <guibutton>Add Host...</guibutton> or the <guibutton>Edit Host...</guibutton> button.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The first four fields (<quote>User:</quote>, <quote>Bind DN:</quote>, <quote>Realm:</quote>, and
+ <quote>Password:</quote>) will all be grayed out unless authentication is required. Obtain these credentials
+ from the LDAP server's administrator. Enter the appropriate URI in the <quote>Host:</quote> field. The default
+ values for <quote>Port:</quote>, <quote>Size limit:</quote>, &etc; will work OK for most users. You can use the
+ <guibutton>Query Server</guibutton> button to set up the <quote>DN:</quote> field. I have no idea what the
+ <quote>Filter:</quote> field is for. If you figure it out, please let me know (davidbryant AT gvtc.com).</para>
+
+ <para>Use the <quote>Security</quote> section to specify the encryption method to use: <quote>No</quote> for
+ an unencrypted connection, <glossterm linkend="gloss-tls"><acronym>TLS</acronym></glossterm> for Transport Layer
+ Security, or <glossterm linkend="gloss-ssl"><acronym>SSL</acronym></glossterm> for Secure Socket Layer. Use the
+ <quote>Authentication</quote> options to specify what level of authentication the server requires:
+ <quote>Anonymous</quote> for no name or password at all, <quote>Simple</quote> if <quote>Bind DN</quote> and
+ <quote>Password</quote> must be given, and <glossterm linkend="gloss-sasl"><acronym>SASL</acronym></glossterm>
+ (Simple Authentication and Security Layer) for the whole schmear (four data items). If <quote>SASL</quote> is
+ chosen, use the <guibutton>Query Server</guibutton> button to set the advanced options for this host.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+<sect1 id="import-csv-data">
+<title>The Import CSV File Function</title>
+
+ <para>When you choose the <menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu>
+ <guimenuitem>Import CSV file...</guimenuitem></menuchoice> function, you will be presented with a dialog.
+ After you click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-open.png" format="PNG"/>
+ </imageobject></inlinemediaobject></guibutton> button and choose the file to be imported, the screen will
+ look like this.</para>
+
+ <para>
+ <screenshot id="screenshot-import-csv">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook103.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Import CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import
+ ></guisubmenu><guimenuitem>Import CSV file...</guimenuitem></menuchoice> function and selecting the file to be imported.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Use the <quote>Delimiter</quote> section of this dialog to specify which separator character defines the end of a field in the
+ chosen input file. If quote marks are used to delimit fields with embedded separator characters, you may specify the style (single
+ 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>
+ 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
+ <quote>Date format:</quote> box and a handy set of formatting instructions will be displayed. If the input file is not UTF-8 encoded,
+ 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
+ column headers, check the <quote>Skip first row of file</quote> box to avoid importing the column headers as data. Use the
+ <quote>Undefined</quote> boxes at the top of each column to specify which data fields are to be imported, and where they should be
+ stored, as shown below.</para>
+
+ <para>
+ <screenshot id="screenshot-import-csv-2">
+ <screeninfo>A second screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook104.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A second screenshot of &kaddressbook;'s <quote>Import CSV File</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Import CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Import
+ ></guisubmenu><guimenuitem>Import CSV file...</guimenuitem></menuchoice> function, selecting the file to be imported, and
+ beginning to define the fields to be imported.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <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
+ 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
+ horizontal scrollbar near the bottom of the dialog to view all the columns in the input file. When your selections are complete, click the
+ <guibutton> ✔ OK </guibutton> button. If you have defined multiple address books, you will be asked to specify which address
+ book is to be used. &kaddressbook; will then import the selected data as new contacts.</para>
+
+ <para>If you intend to import additional datasets in the same format sometime in the future, you may click the <guibutton>Save template...</guibutton>
+ 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.
+ Later, when you import another file with the same layout, you can save time by clicking the <guibutton>Apply template...</guibutton> button.</para>
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+<sect1 id="export-csv-data">
+<title>The Export CSV File Function</title>
+
+ <para>When you invoke the <menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export
+ CSV file ...</guimenuitem></menuchoice> function, a dialog box appears.</para>
+
+ <para>
+ <screenshot id="screenshot-export-csv">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Export CSV File</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook100.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Export CSV File</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Export CSV File</quote> dialog after choosing the <menuchoice><guimenu>File</guimenu><guisubmenu>Export
+ ></guisubmenu><guimenuitem>Export CSV file ...</guimenuitem></menuchoice> function.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>You may select all your contact data, or just a portion of it. When you press the <guibutton> ✔ OK </guibutton> button,
+ 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
+ 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>
+
+ <para>Formatted Name | Honorific Prefixes | Given Name | Additional Names | Family Name | Honorific Suffixes | Nick Name | Birthday | Anniversary |
+ EMail (preferred) | EMail (2) | EMail (3) | EMail (4) | Home Address Street | Home Address Post Office Box | Home Address City | Home Address State |
+ Home Address Zip Code | Home Address Country | Home Address Label | Business Address Street | Business Address Post Office Box | Business Address City |
+ Business Address State | Business Address Zip Code | Business Address Country | Business Address Label | Home Phone | Business Phone | Mobile Phone |
+ Home Fax | Business Fax | Car Phone | ISDN | Pager | Mail Client | Title | Role | Organization | Note | Homepage | Blog Feed | Profession | Office |
+ Manager | Assistant | Spouse</para>
+
+ <para>All fields are formatted as character class data. Dates (Birthday and Anniversary, if present) are coded as
+ yyyy-mm-dd (Year, Month, Day).</para>
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+
+</sect1>
+
+<sect1 id="view-change-columns">
+<title>The Change Number of Columns Function</title>
+
+ <para>When you open the <menuchoice><guimenu>View</guimenu></menuchoice> menu, the following screen appears.</para>
+
+ <para>
+ <screenshot id="screenshot-view-menu-appendix">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook82.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>View</quote> menu after choosing the <menuchoice><guimenu>View</guimenu></menuchoice>
+ menu on the main Menubar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Not happy with the hum-drum three column layout appearing above? Jazz things up a little with this minimalist approach.</para>
+
+ <para>
+ <screenshot id="screenshot-view-menu-appendix-2">
+ <screeninfo>A screenshot of &kaddressbook;'s single panel layout.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook110.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s single panel layout.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Simple (one column)</quote> layout. Only the basic contact
+ data are visible.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Notice that the information about which address books exist and are in use is not visible when this <quote>Simple</quote>
+ layout is in effect. Only the contacts from the address books that were selected before choosing this view are displayed.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+
+ <para>If the <quote>Simple</quote> layout does not appeal to you, you may want to try the <quote>Two columns</quote> style.</para>
+
+ <para>
+ <screenshot id="screenshot-view-menu-appendix-3">
+ <screeninfo>A screenshot of &kaddressbook;'s double panel layout.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook111.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s double panel layout.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Two columns</quote> layout. The list of address books is
+ stacked on top of the alphabetized contact list.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para> At &kde;, our motto is "Be Free!" We aim to give you maximum flexibility when it comes to tailoring
+ and configuring our software to suit your tastes. We toyed with the idea of adding even more views to
+ &kaddressbook; (Four columns! Five!), but eventually concluded that enough is enough.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+<sect1 id="settings-configure-shortcuts">
+<title>The Configure Shortcuts Option</title>
+
+ <para>When you first select the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject>
+ <imagedata fileref="input-keyboard.png" format="PNG"/></imageobject></inlinemediaobject>Configure Shortcuts...</guisubmenu>
+ </menuchoice> option, this is what you will see.</para>
+
+ <para>
+ <screenshot id="screenshot-config-shortcut1">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook112.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Configure Shortcuts</quote> dialog. Use the <quote>Search</quote> field, or the
+ vertical scrollbar, to locate the action for which a new keyboard shortcut is to be defined.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The &kaddressbook; actions for which keyboard shortcuts have already been defined are clearly marked in the
+ <quote>Shortcut</quote> column. You may either assign additional shortcuts via the <quote>Alternate</quote>,
+ <quote>Global</quote>, and <quote>Global Alternate</quote> columns in this table, or assign a new shortcut to
+ an action for which no keyboard shortcut has as yet been defined. Select the action to be configured by clicking
+ its name, as illustrated above. </para>
+
+ <para> </para> <!-- add more white space @dcb -->
+
+ <para>When you left-click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/>
+ </imageobject></inlinemediaobject>None</guibutton> button, its name will change to <quote>Input...</quote>; you can then
+ record the combination of keystrokes you wish to assign to the selected action. (Hover the cursor over the <guibutton>
+ <inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject>None</guibutton>
+ button to view a handy hint about this procedure.) The program will note which keys you have pressed, and record the new
+ keyboard shortcut, as illustrated below. If you choose a combination that conflicts with an existing shortcut assignment,
+ you will see an error message, and you will be prompted to make a different selection. You may use the <guibutton><inlinemediaobject>
+ <imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button to
+ erase your selection.</para>
+
+ <para>
+ <screenshot id="screenshot-config-shortcut2">
+ <screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook113.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A second screenshot of &kaddressbook;'s <quote>Configure Shortcuts</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Configure Shortcuts</quote> dialog after a new keyboard shortcut has
+ been entered, but before the new configuration has been saved.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Click the <guibutton> ✔ OK </guibutton> button to save your changes. Click on
+ <guibutton> ⦸ Cancel </guibutton> to exit without saving your changes. Click
+ <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-revert.png" format="PNG"/>
+ </imageobject></inlinemediaobject>Defaults</guibutton> to restore &kaddressbook;'s default set of
+ keyboard shortcuts. Choose <guibutton> Manage Schemes >> </guibutton> to integrate
+ your custom assignments into a larger scheme of shortcut assignments; see the <quote>Customizing KDE
+ Software</quote> chapter in the <quote>Fundamentals</quote> handbook for more details.</para>
+
+ <para>You may select the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-print.png"
+ format="PNG"/></imageobject></inlinemediaobject>Print</guibutton> button to produce a hard-copy version
+ of the keyboard shortcut assignments. Here is a sample from the printed table.</para>
+
+ <para>
+ <screenshot id="screenshot-config-shortcut3">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Print</quote> output.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook114.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Print</quote> output.</phrase>
+ </textobject>
+ <caption>
+ <para>An excerpt from &kaddressbook;'s printed list of keyboard shortcuts.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+<sect1 id="settings-configure-toolbars">
+<title>The Configure Toolbars Option</title>
+
+ <para>Here is a picture of the screen that appears when you click on the <menuchoice><guimenu>Settings</guimenu>
+ <guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Configure Toolbars...</guisubmenu></menuchoice> menu item.</para>
+
+ <para>
+ <screenshot id="screenshot-config-toolbars">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure Toolbars</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook130.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Configure Toolbars</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Configure Toolbars</quote> dialog. Actions that are already displayed
+ on the Toolbar appear in the large window on the right. Actions in the left-hand window may be
+ added to the Toolbar, as explained below.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Use either one of the <quote>Filter</quote> fields to restrict the range of choices displayed in the corresponding
+ window. Select an action in the left-hand window (as shown above) if you wish to add it to the Toolbar. Left click the
+ <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-next.png" format="PNG"/></imageobject></inlinemediaobject>
+ </guibutton> button to add the item to the list in the right-hand window (and thence to &kaddressbook;'s Toolbar). If you
+ want to delete an item from the Toolbar simply reverse the procedure: highlight the item to be deleted from the right-hand
+ window and click the <guibutton><inlinemediaobject><imageobject><imagedata fileref="go-previous.png" format="PNG"/></imageobject>
+ </inlinemediaobject></guibutton> button. The selected item will be removed from the Toolbar.</para>
+
+ <para>You may tailor the order in which selected items appear on the Toolbar by using drag and drop within the right-hand
+ window. The order of items on the Toolbar, left to right, corresponds with the order in the window, top to bottom. You may
+ make additional changes to the appearance of the Toolbar by using the <guibutton><inlinemediaobject><imageobject><imagedata
+ fileref="change-icon.png" format="PNG"/></imageobject></inlinemediaobject>Change Icon...</guibutton> button to alter the icon
+ associated with a particular action. Similarly, you may change the description of each item on the Toolbar by clicking the
+ <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Change Text...</guibutton> button.</para>
+
+ <para>Use the <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-revert.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Defaults</guibutton> button to restore the default Toolbar settings. Choose <quote>OK</quote> to
+ save your changes and exit the dialog, <quote>Apply</quote> to apply your changes while keeping the dialog open, or
+ <quote>Cancel</quote> to exit the dialog without saving your changes. (See the <quote>Customizing KDE Software</quote>
+ chapter in the <quote>Fundamentals</quote> handbook for a more detailed explanation of this procedure.)</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+<sect1 id="settings-configure-kaddressbook">
+<title>The Configure &kaddressbook; Option</title>
+
+ <para>When the <menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png"
+ format="PNG"/></imageobject></inlinemediaobject>Configure &kaddressbook;...</guisubmenu></menuchoice> option is selected, this
+ screen will appear.</para>
+
+ <para>
+ <screenshot id="screenshot-config-general">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook133.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Configure Contact Actions</quote> dialog. These features are still
+ experimental, and not yet entirely operational.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The first dialog that appears supports experimental features that have not yet been completely implemented.
+ You may select from several different options under the headings <quote>Show Address</quote>, <quote>Dial Phone
+ Number</quote>, or <quote>Send SMS</quote>, but there isn't yet any software to do anything with the options you
+ choose.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+
+ <para>The next option, <quote>LDAP Server Settings</quote>, is the same dialog that is documented in the preceding
+ section entitled <link linkend="configure-ldap-server"><quote>The Configure LDAP Dialog</quote></link>.</para>
+
+ <para>
+ <screenshot id="screenshot-config-ldap">
+ <screeninfo>A second screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook134.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A second screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>LDAP Server Settings</quote> dialog. This dialog, and its child, are documented
+ in <link linkend="configure-ldap-server">a preceding section</link> of this appendix.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The final set of options for configuring &kaddressbook; appears when you select <quote>Plugins</quote>.</para>
+
+ <para>
+ <screenshot id="screenshot-config-plugins">
+ <screeninfo>A third screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook135.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A third screenshot of &kaddressbook;'s <quote>Configure &kaddressbook;</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Plugins</quote> dialog. There are ten plugins all together. Seven of them
+ have been activated by default, as shown above.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The actions supported by the seven default <quote>Plugins</quote> are documented in preceding sections of this
+ manual. The <quote>Import Export <glossterm linkend="gloss-gmx"><acronym>GMX</acronym></glossterm></quote> and
+ <quote>Import/Export <glossterm linkend="gloss-ldif"><acronym>LDIF</acronym></glossterm></quote> actions will appear
+ as part of the <menuchoice><guimenu>File</guimenu></menuchoice> menu when activated. The <quote>Check <glossterm
+ linkend="gloss-gravatar">Gravatar</glossterm></quote> item will appear in the <menuchoice><guimenu>Tools</guimenu>
+ </menuchoice> menu when it is activated. Notice that &kaddressbook; must be stopped and restarted before any changes
+ to the <quote>Plugins</quote> will take effect. </para>
+
+ <para> </para> <!-- add more white space @dcb -->
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+<sect1 id="credits-and-licenses">
+<title>Credits and Licenses</title>
+
+ <para>
+ &kaddressbook;
+ </para>
+
+ <para>
+ Copyright © 2007–2019 KAddressBook authors <email>montel at kde.org</email>
+ </para>
+
+ <para>
+ Documentation Copyright © 2019 David C. Bryant <email>davidbryant at gvtc.com</email>
+ </para>
+
+ <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+ <!-- License for new documents after 2017-07-27 (or relicensed) -->
+
+ &underCCBYSA4; <!-- CC BY-SA 4.0: do not remove -->
+
+ <para><link linkend="docbook-reference">Click here to return to the Table of Contents for this Appendix.</link></para>
+
+</sect1>
+
+</appendix>
diff --git a/doc/document-edit.png b/doc/document-edit.png
new file mode 100644
index 00000000..4a3dd219
Binary files /dev/null and b/doc/document-edit.png differ
diff --git a/doc/document-open.png b/doc/document-open.png
new file mode 100644
index 00000000..516e7857
Binary files /dev/null and b/doc/document-open.png differ
diff --git a/doc/document-preview-archive.png b/doc/document-preview-archive.png
new file mode 100644
index 00000000..c60f67b6
Binary files /dev/null and b/doc/document-preview-archive.png differ
diff --git a/doc/document-print.png b/doc/document-print.png
new file mode 100644
index 00000000..58c5b7d3
Binary files /dev/null and b/doc/document-print.png differ
diff --git a/doc/document-properties.png b/doc/document-properties.png
new file mode 100644
index 00000000..7016ffb1
Binary files /dev/null and b/doc/document-properties.png differ
diff --git a/doc/document-revert.png b/doc/document-revert.png
new file mode 100644
index 00000000..9ab179c2
Binary files /dev/null and b/doc/document-revert.png differ
diff --git a/doc/draw-circle.png b/doc/draw-circle.png
new file mode 100644
index 00000000..1328c536
Binary files /dev/null and b/doc/draw-circle.png differ
diff --git a/doc/draw-rectangle.png b/doc/draw-rectangle.png
new file mode 100644
index 00000000..fc9ee305
Binary files /dev/null and b/doc/draw-rectangle.png differ
diff --git a/doc/edit-clear.png b/doc/edit-clear.png
new file mode 100644
index 00000000..ae1faaa4
Binary files /dev/null and b/doc/edit-clear.png differ
diff --git a/doc/edit-copy.png b/doc/edit-copy.png
new file mode 100644
index 00000000..e08e48ab
Binary files /dev/null and b/doc/edit-copy.png differ
diff --git a/doc/edit-cut.png b/doc/edit-cut.png
new file mode 100644
index 00000000..4c9750f6
Binary files /dev/null and b/doc/edit-cut.png differ
diff --git a/doc/edit-delete.png b/doc/edit-delete.png
new file mode 100644
index 00000000..953c578e
Binary files /dev/null and b/doc/edit-delete.png differ
diff --git a/doc/edit-paste.png b/doc/edit-paste.png
new file mode 100644
index 00000000..f515a4b0
Binary files /dev/null and b/doc/edit-paste.png differ
diff --git a/doc/edit-undo.png b/doc/edit-undo.png
new file mode 100644
index 00000000..672829c4
Binary files /dev/null and b/doc/edit-undo.png differ
diff --git a/doc/folder-new.png b/doc/folder-new.png
new file mode 100644
index 00000000..1eb2898c
Binary files /dev/null and b/doc/folder-new.png differ
diff --git a/doc/go-down.png b/doc/go-down.png
new file mode 100644
index 00000000..9a2149d6
Binary files /dev/null and b/doc/go-down.png differ
diff --git a/doc/go-jump.png b/doc/go-jump.png
new file mode 100644
index 00000000..0d09416b
Binary files /dev/null and b/doc/go-jump.png differ
diff --git a/doc/go-next.png b/doc/go-next.png
new file mode 100644
index 00000000..f88db383
Binary files /dev/null and b/doc/go-next.png differ
diff --git a/doc/go-previous.png b/doc/go-previous.png
new file mode 100644
index 00000000..95c19453
Binary files /dev/null and b/doc/go-previous.png differ
diff --git a/doc/help-about.png b/doc/help-about.png
new file mode 100644
index 00000000..42f9952f
Binary files /dev/null and b/doc/help-about.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
new file mode 100644
index 00000000..ea8fad87
--- /dev/null
+++ b/doc/index.docbook
@@ -0,0 +1,2255 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd"
+ [
+ <!ENTITY % addindex "IGNORE">
+ <!ENTITY % English "INCLUDE">
+ <!ENTITY docbook-reference SYSTEM "docbook-reference.docbook">
+ ]>
+
+<book id="kaddressbook" lang="&language;">
+
+<bookinfo>
+
+<title>The &kaddressbook; Handbook</title>
+
+<authorgroup>
+
+ <author>
+ <firstname>David</firstname>
+ <othername>C.</othername>
+ <surname>Bryant</surname>
+ <affiliation><address><email>davidbryant at gvtc.com</email></address></affiliation>
+ </author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<copyright>
+ <year>2019</year>
+ <holder>David C. Bryant</holder>
+</copyright>
+
+<legalnotice>&CCBYSA4Notice;</legalnotice>
+
+<date>2019-07-20</date>
+<releaseinfo>5.10.3 (Applications 18.12.3)</releaseinfo>
+
+<abstract>
+ <para>&kaddressbook; is part of the &kde; suite of personal information management
+ (<glossterm linkend="gloss-pim">&PIM;</glossterm>) programs. &kaddressbook; is
+ primarily an email address manager, but it can also help you keep track of your friends'
+ and associates' telephone numbers, web sites, social media connections, snail-mail
+ addresses, and more, besides. It's your one-stop shop for keeping track of all the people you know.
+ </para>
+</abstract>
+
+<!--TODO Note to self: add more keywords later. -->
+<keywordset>
+ <keyword>KDE</keyword>
+ <keyword>KAddressBook</keyword>
+ <keyword>kdepim</keyword>
+ <keyword>Email</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+ <para>
+ &kaddressbook; is part of the &kde; suite of personal information management (&PIM;)
+ programs. &kaddressbook; is primarily an email address manager, but it can also help
+ you keep track of your friends' and associates' telephone numbers, web sites, social
+ media connections, snail-mail addresses, and more, besides. It's your one-stop shop
+ for keeping track of all the people you know!
+ </para>
+
+ <screenshot id="screenshot-primary">
+ <screeninfo>A screenshot of &kaddressbook;'s primary &GUI; interface</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook00.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s primary &GUI; interface</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s primary display. The Menubar is at the top, the Toolbar
+ is next, and there are three Panels for data in the Text Area
+ at the bottom.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>
+ &kaddressbook; has been integrated into the structure of <glossterm linkend="gloss-kmail">&kmail;</glossterm>,
+ the &kde; email client. So once you add a contact's name to &kaddressbook;, you can address
+ an email message to that person by just typing in a portion of his name. Or if
+ you receive an email message from somebody new, you can add him to your address
+ book with just a few clicks of your mouse.
+ </para>
+
+ <para>
+ &kaddressbook; also permits you to maintain multiple separate contact lists in a
+ wide variety of popular address list formats, either on your local hard disk, or
+ via a resource residing in the cloud. It also supports importing and exporting
+ contact data in <glossterm linkend="gloss-csv"><filename class="extension">.csv</filename></glossterm>
+ (Comma Separated Values), <glossterm linkend="gloss-ldif"><filename class="extension">.ldif</filename></glossterm>
+ (<glossterm linkend="gloss-ldap"><acronym>LDAP</acronym></glossterm> Data Interchange Format), and
+ <glossterm linkend="gloss-vcf"><filename class="extension">.vcf</filename></glossterm>
+ (Virtual business Card Format) record formats.
+ </para>
+
+<!--TODO Insert additional information about problem reporting here -->
+</chapter>
+
+<chapter id="getting-started">
+<title>Getting Started</title>
+
+ <para>
+ Here is a picture of the primary &kaddressbook; user interface before any address
+ data have been entered. The first thing you may want to do is create an address
+ book. Note that the<quote>Personal Contacts</quote> address book is present by default.
+ </para>
+
+ <screenshot id="screenshot-blank">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>empty</quote> &GUI; interface</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook10.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>empty</quote> &GUI; interface</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>empty</quote> &GUI; interface, before any extra address books
+ have been created. The <quote>Personal Contacts</quote> address book is present when
+ &kaddressbook; is first installed.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <sect1 id="how-to-add-a-new-address-book">
+ <title>How to Add a New Address Book</title>
+
+ <procedure id="procedure-add-a-new-addressbook">
+
+ <step id="new-addressbook-dialog-step"><para>
+ Open &kaddressbook;'s Add Address Book dialog with the <menuchoice><guimenu>File</guimenu>
+ <guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="folder-new.png"
+ format="PNG"/></imageobject></inlinemediaobject>Add Address Book...</guimenuitem></menuchoice>
+ option. A dialog box will appear.
+ </para>
+
+ <para>
+ <screenshot id="screenshot-add-an-address-book">
+ <screeninfo>A screenshot of &kaddressbook;'s Add Address Book dialog</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook20.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s Add Address Book dialog</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s Add Address Book dialog.
+ Five cloud services are supported, plus three local storage options.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+ </step>
+
+ <step id="select-a-format-step"><para>
+ Choose one of the options that appear in the dialog. Several of these options
+ link to data collections residing in the cloud: <glossterm linkend="gloss-dav"><acronym>DAV</acronym></glossterm>
+ groupware (Distributed Authoring and Versioning, RFC4918), Google Contacts (your gmail.com
+ account), <glossterm linkend="gloss-kolab">Kolab</glossterm> groupware server (collaboration
+ via <glossterm linkend="gloss-imap">&IMAP;</glossterm>), &Microsoft; Exchange Server
+ <glossterm linkend="gloss-ews">EWS</glossterm> (Exchange Web Services, on servers running MS software),
+ and <glossterm linkend="gloss-group">Open-Xchange Groupware Server</glossterm> (an open-source
+ alternative to MS EWS). If you already have access to one or more of these cloud-based resources, you can integrate those
+ data into &kaddressbook; by simply selecting the option and then entering your login credentials.</para>
+
+ <para>
+ The remaining options in the dialog (Personal Contacts, vCard Directory, and
+ vCard File) all create data sets that are saved on a local storage device. Each
+ one of these options uses the same data format (<filename class="extension">.vcf</filename>,
+ or Virtual Card Format), the only difference being in which particular directory the data
+ are saved. The <quote>Personal Contacts</quote> and <quote>vCard Directory</quote> options
+ create a separate file for each named contact you save; the <quote>vCard File</quote> option
+ puts all the data into one file. It's probably easiest to start with the pre-defined
+ <quote>Personal Contacts</quote> address book. You will not need more address books
+ unless you have extensive contact lists you would like to keep separate.
+ </para></step>
+
+ <step id="add-a-cloud-based-service-step"><para>
+ Once you have made your selection, click on OK. If you have selected a <glossterm
+ linkend="gloss-cloud">cloud-based service</glossterm> a brief dialog will ensue,
+ to establish communications between <glossterm linkend="gloss-akonadi">&akonadi;</glossterm>
+ (the &PIM; cross-desktop storage service) and the selected cloud server. Here's what
+ the dialog looks like for a Google (gmail.com) account. The other cloud-based services
+ are slightly different, but similar.
+ </para>
+
+ <para>
+ <screenshot id="screenshot-add-a-cloud-based-service">
+ <screeninfo>A screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook30.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s link-to-gmail dialog</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s link-to-gmail dialog. Begin by clicking <quote>Add</quote>. A new dialog will appear.
+ Once your credentials have been accepted, this screen will reappear, and you will click
+ <guibutton> ✔ OK </guibutton>. If you would like &kaddressbook; to refresh the
+ locally cached copy of your contact list automatically, do it here, before you click
+ <guibutton> ✔ OK </guibutton>.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para>
+ <screenshot id="screenshot-add-a-cloud-based-service-step2">
+ <screeninfo>A second screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook31.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A second screenshot of &kaddressbook;'s link-to-gmail dialog</phrase>
+ </textobject>
+ <caption>
+ <para>Another picture of &kaddressbook;'s link-to-gmail dialog. Enter your
+ gmail.com address and click <guibutton> Next </guibutton>. You will be asked to
+ enter your gmail password.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para>
+ <screenshot id="screenshot-add-a-cloud-based-service-step3">
+ <screeninfo>A third screenshot of &kaddressbook;'s link-to-gmail dialog</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook32.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A third screenshot of &kaddressbook;'s link-to-gmail dialog</phrase>
+ </textobject>
+ <caption>
+ <para>Yet another picture of &kaddressbook;'s link-to-gmail dialog.
+ Your account name and password have been accepted by Google's server. Read
+ the privacy notice and press <guibutton> Allow </guibutton>, then
+ <guibutton> ✔ OK </guibutton> in the <quote> Add </quote> dialog
+ with which you started.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>
+ Enter your login credentials as illustrated above and say OK. Voila! Your cloud-based
+ contact list is now integrated into &kaddressbook;.
+ </para>
+ <para> </para> <!-- add more white space before next screenshot @dcb -->
+
+ <para>
+ <screenshot id="screenshot-add-a-cloud-based-service-completed">
+ <screeninfo>The &kaddressbook; window after a gmail.com account has been added.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook33.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>The &kaddressbook; window after a gmail.com account has been added.</phrase>
+ </textobject>
+ <caption>
+ <para>Another picture of the &kaddressbook; window, after a gmail.com
+ account has been added. You can now manipulate your gmail contacts via &kaddressbook;, if you like.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>
+ As the preceding screenshot indicates, once you have registered &kaddressbook; as a
+ trusted resource, you can view and edit your gmail contacts using &kaddressbook;. Of
+ course, you may also continue to maintain your contacts by using a web browser, if you wish.
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ </step>
+
+ <step id="add-a-local-addressbook-step"><para>
+ If you selected one of the local address book options in
+ <link linkend="select-a-format-step">step 2</link> above, a different
+ dialog will ensue. </para>
+
+ <para>
+ <screenshot id="screenshot-add-a-personal-addressbook">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Personal Contacts</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook34.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Personal Contacts</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Personal Contacts</quote> dialog. You may specify which directory
+ will contain your data, and whether you have write access to this resource, or not. For most people,
+ the default selections (as shown above) work well.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>
+ Make any modifications you deem necessary in the <quote>Personal Contacts</quote> dialog,
+ then click <guibutton> ✔ OK </guibutton>. A new address book will appear in the main
+ &kaddressbook; interface window, as shown below.
+ </para>
+
+ <para>
+ <screenshot id="screenshot-personal-addressbook-has-been-added">
+ <screeninfo>A screenshot of &kaddressbook;'s main window with an empty <quote>Personal Contacts</quote> address book.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook35.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s main window with an empty <quote>Personal Contacts</quote> address book.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s main window after the <quote>Personal Contacts</quote> address book has been re-created.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+ </step>
+
+ </procedure>
+ </sect1>
+
+ <sect1 id="how-to-add-a-new-contact">
+ <title>How to Add a New Contact</title>
+
+ <procedure id="procedure-add-a-new-contact">
+
+ <step id="new-contact-dialog-step-1"><para>
+ Open &kaddressbook;'s New Contact dialog by clicking the <guibutton> + New Contact </guibutton>
+ button on the Toolbar. A dialog box will appear.</para>
+
+ <para>
+ <screenshot id="screenshot-new-contact-dialog">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook40.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>New Contact</quote> dialog after clicking the
+ <guibutton> + New Contact </guibutton> button on the Toolbar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ </step>
+
+ <step id="procedure-new-contact-data-items"><para>
+ As you can see from the preceding screenshot, the <quote>New Contact</quote> dialog allows one
+ to enter several different data items. Additional data may be entered via the <quote>Location</quote>,
+ <quote>Business</quote>, <quote>Personal</quote>, <quote>Notes</quote>, <quote>Custom Fields</quote>,
+ and <quote>Crypto Settings</quote> sub-dialogs, as explained more fully in <link linkend="editing-contact-data">chapter 4</link>,
+ below. For now, let's concentrate on adding the <quote>Contact</quote> data items appearing in the preceding illustration.</para>
+ </step>
+
+ <step id="procedure-entering-basic-new-contact-data"><para>
+ If you have created more than one address book, use the drop-down list labeled <quote>Add to:</quote>
+ to select the data set to which the new contact will be added. Then enter the new contact's name in
+ the input field marked <quote>Name</quote>, and key in his or her email address in the input field
+ labeled <quote>Email</quote>. If you want to specify special formatting options for this contact's
+ name data, click the <guibutton> ... </guibutton> button to the right of the <quote>Name</quote>
+ input field and follow the prompts. If you wish to add more email addresses for this person, click the
+ <guibutton> + </guibutton> button to the right of the <quote>Email</quote> input field and another
+ Email input field will be generated. To delete an Email address, click the associated
+ <guibutton> − </guibutton> button.
+
+ </para></step>
+
+ <step id="procedure-additional-new-contact-data"><para>
+ You may also associate a nickname, one or more telephone numbers, multiple instant messaging services,
+ and several web sites with each contact in an address book, as explained
+ in <link linkend="editing-contact-data">chapter 4</link>. You may also use the <quote>Show messages ...</quote>
+ and <quote>Allow remote content ...</quote> options to fine-tune the way &kmail; handles email you receive
+ from each contact. See<link linkend="integration-with-other-kde-programs">chapter 3</link> for a more
+ complete explanation.
+ </para></step>
+
+ <!--TODO Note to myself: need to add an explanation of overriding KMail defaults -->
+
+ </procedure>
+ </sect1>
+
+</chapter>
+
+<chapter id="integration-with-other-kde-programs">
+<title>Integration With Other KDE Programs</title>
+
+ <sect1 id="integration-overview">
+ <title>Integration Overview -- &kmail;</title>
+
+ <para>
+ Because &kaddressbook; -- an essential piece of &PIM;, &kde;'s suite of Personal Information Management programs --
+ is the central repository for information about all your contacts, it has been integrated into &kmail; and also
+ into &korganizer;. Here is a quick look at the interface between &kaddressbook; and those two programs.
+ </para>
+
+ <sect2 id="starting-kaddressbook-from-kmail-tools">
+ <title>Starting &kaddressbook; from &kmail;'s Tools Menu</title>
+
+ <para>
+ <screenshot id="screenshot-kmail-tools-menu">
+ <screeninfo>A screenshot of &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice> option.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook50.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice> option.</phrase>
+ </textobject>
+ <caption>
+ <para>Launching &kaddressbook; from &kmail;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem><inlinemediaobject><imageobject><imagedata
+ fileref="address-book-new.png" format="PNG"/></imageobject></inlinemediaobject>Address Book</guimenuitem></menuchoice> menu choice.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>This interface is the epitome of simplicity. Need to consult or update the entry for one of your contacts while reading
+ or composing an email message with &kmail;? Left click <menuchoice><guimenu>Tools</guimenu><guimenuitem><inlinemediaobject><imageobject>
+ <imagedata fileref="address-book-new.png" format="PNG"/></imageobject></inlinemediaobject>Address Book</guimenuitem>
+ </menuchoice>, and the &kaddressbook; application will be launched automatically, allowing quick access to the contact
+ data you want to view or modify.</para>
+
+ <para> </para> <!-- add more white space before next section @dcb -->
+
+ </sect2>
+
+ <sect2 id="autocompletion-feature-on-new-email">
+ <title>Querying &kaddressbook; from &kmail;'s Message Composition Window</title>
+
+ <para>
+ <screenshot id="screenshot-autocompletion-feature">
+ <screeninfo>A screenshot of auto completion from inside &kmail;'s message composition window.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook51.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of auto completion from inside &kmail;'s message composition window.</phrase>
+ </textobject>
+ <caption>
+ <para>Using &kaddressbook;'s auto completion feature from inside &kmail;'s message composition window.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>When you are composing a new email message, &kmail; helps you find the recipient's complete email
+ address by presenting a list of probable matches drawn from the contents of &kaddressbook; and from
+ your email archives, as illustrated above. Just left click an item in the list to use that email address.</para>
+
+ <para> </para> <!-- add more white space before next section @dcb -->
+
+ </sect2>
+
+ <sect2 id="recipient-selection-dialog">
+ <title>&kmail;'s Recipient Selection Dialog</title>
+
+ <para>
+ <screenshot id="screenshot-recipient-selection">
+ <screeninfo>A screenshot of the recipient selection dialog inside &kmail;'s message composition window.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook52.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of the recipient selection dialog inside &kmail;'s message composition window.</phrase>
+ </textobject>
+ <caption>
+ <para>Selecting multiple addressees with the recipient selection dialog inside &kmail;'s message composition window.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>When you are addressing a new email message to multiple recipients, &kmail; provides a convenient method
+ of choosing multiple addressees from the contacts you have saved with &kaddressbook;. Simply left click the
+ <guibutton> Select ... </guibutton> button to open a Drop Down Box that lists all the contacts in the
+ selected address books. Then scroll through the list (or use the handy <quote>Search:</quote> box),
+ select the recipient you want, and left click <guibutton> Add as To </guibutton>,
+ <guibutton> Add as CC </guibutton>, or <guibutton> Add as BCC </guibutton> to add this person
+ to the list of email recipients for your new message. Choose <guibutton> Add as Reply-To </guibutton>
+ to insert this address into your message as a <quote>Reply To</quote> tag.</para>
+
+ <para> </para> <!-- add more white space before next section @dcb -->
+
+ </sect2>
+
+ <sect2 id="new-contact-creation-interface">
+ <title>&kmail;'s New Contact Creation Interface</title>
+
+ <para>
+ <screenshot id="screenshot-new-contact-creation">
+ <screeninfo>A screenshot of the new contact creation interface inside &kmail;'s message viewing window.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook53.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of the new contact creation interface inside &kmail;'s message viewing window.</phrase>
+ </textobject>
+ <caption>
+ <para>Invoking the new contact creation dialog from &kmail;'s message viewing window.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+ <para>When you receive an email message from someone who is not yet in your address book, &kmail; makes it very
+ easy to create a new contact. Simply point your cursor at the email address you want to save, then click the &RMB; and
+ a context menu will appear (see above). Select <guimenuitem> + Add to Address Book </guimenuitem>
+ to add the selected email address to one of your address books. If you recognize this person as somebody who's already
+ in your address book, and he is using a new email address, you may click on <guimenuitem> + Add to Existing Contact </guimenuitem>
+ instead -- this enters a dialog that will direct &kaddressbook; to the spot where you want to insert the new email address.</para>
+ <para> </para> <!-- add more white space before next picture @dcb -->
+
+ <para>
+ <screenshot id="screenshot-new-contact-creation-step2">
+ <screeninfo>A screenshot of the ensuing new contact creation dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook54.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of the ensuing new contact creation dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>Choosing the address book in which the new contact will be created.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+ <para>&kmail; will ask you to choose the address book to which the new contact should be added.</para>
+ <para> </para> <!-- add more white space before next picture @dcb -->
+
+ <para>
+ <screenshot id="screenshot-new-contact-creation-step3">
+ <screeninfo>Another screenshot of the ensuing new contact creation dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook55.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Another screenshot of the ensuing new contact creation dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>Deciding if you would like to edit the newly created contact now, or later.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+ <para>&kmail; will also ask you if you wish to <link linkend="editing-contact-data"> edit the new contact</link>
+ that has just been added. Say <guibutton> ✔ Yes </guibutton> if you want to add more data to the
+ new entry right away.</para>
+ <para> </para> <!-- add more white space before next section @dcb -->
+
+ </sect2>
+
+ </sect1>
+
+ <sect1 id="korganizer-overview">
+ <title>&kaddressbook;'s Interface with &korganizer;</title>
+
+ <para>&korganizer;, the &kde; scheduling and calendar management program, allows you
+ to send e-mail messages to people you want to invite to a meeting, and provides
+ two interfaces with &kaddressbook; in this connection.</para>
+ <para> </para> <!-- add more white space before next section @dcb -->
+
+ <para>
+ <screenshot id="screenshot-inviting-one-attendee">
+ <screeninfo>A screenshot of &korganizer;'s attendees tab.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook60.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &korganizer;'s attendees tab.</phrase>
+ </textobject>
+ <caption>
+ <para>Adding a single attendee to a scheduled meeting in &korganizer;.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+ <para>The first interface is just like the <link linkend="autocompletion-feature-on-new-email">auto completion
+ feature</link> provided by &kmail;: just start typing the name of the person you want to invite, and you will
+ be presented with a list of probable matches, as illustrated above.</para>
+ <para> </para> <!-- add more white space before next section @dcb -->
+
+ <para>
+ <screenshot id="screenshot-inviting-multiple-attendees">
+ <screeninfo>A screenshot of &korganizer;'s attendees tab.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook61.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&korganizer;'s attendees tab.</phrase>
+ </textobject>
+ <caption>
+ <para>Adding multiple attendees to a scheduled meeting in &korganizer;.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+ <para>The second interface is just like the <link linkend="recipient-selection-dialog">recipient selection
+ dialog</link> provided by &kmail;: when you left click the <guibutton> Select Attendees ... </guibutton>
+ button, a searchable list of the contacts in all your address books will appear, as the preceding screenshot shows.</para>
+
+ </sect1>
+
+</chapter>
+
+<chapter id="editing-contact-data">
+<title>Adding or Editing Contact Data</title>
+
+ <sect1 id="edit-basic-info">
+ <title>The Basics</title>
+
+ <para>When you first click on the <guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png"
+ format="PNG"/></imageobject></inlinemediaobject>Add Contact </guibutton> button on &kaddressbook;'s
+ Toolbar, this screen will appear. (If you click on <guibutton><inlinemediaobject><imageobject><imagedata
+ fileref="document-edit.png" format="PNG"/></imageobject></inlinemediaobject>Edit Contact </guibutton>,
+ a similar screen appears, the only difference being that the drop-down box labeled <quote>Add to:</quote> will
+ not appear as part of the <quote>Edit</quote> dialog. That is why both functions are covered in this chapter:
+ they're practically identical.)</para>
+
+ <para>
+ <screenshot id="screenshot-new-contact-dialog-2">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook40.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>New Contact</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Add Contact</quote> dialog after clicking the
+ <guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/>
+ </imageobject></inlinemediaobject>Add Contact </guibutton> button on the Toolbar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <sect2 id="edit-contact-tab">
+ <title>The Contact Tab</title>
+
+ <para>We have already seen (in <link linkend="how-to-add-a-new-contact">How to Add a New Contact</link> )
+ how basic data like Name and Email are entered when a new contact record is created. Here's a description
+ of the many ways to use the rest of the data fields accessible from the <quote>Contact</quote> tab in
+ the <guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/>
+ </imageobject></inlinemediaobject>Add Contact </guibutton> dialog.</para>
+
+ <variablelist>
+
+ <varlistentry><term>Phone</term><listitem><para>You may associate one or more telephone numbers with
+ this person. Use the <guibutton> + </guibutton> and <guibutton> − </guibutton>
+ buttons to add or delete phone number fields. The
+ <guibutton> Home<inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject></guibutton>
+ Drop Down Box allows you to identify fifteen categories of phone numbers (Home, Work, Mobile, Car,<glossterm linkend="gloss-isdn">
+ <acronym>ISDN</acronym></glossterm>, <glossterm linkend="gloss-pcs"><acronym>PCS</acronym></glossterm>, &etc;)</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Messaging</term><listitem><para>You may associate one or more Instant Messaging
+ service identities with this person. Use the <guibutton> + </guibutton> and
+ <guibutton> − </guibutton> buttons to add or delete messaging service fields. The
+ <guibutton> Select ...<inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject></guibutton>
+ Drop Down Box permits you to identify thirteen categories of IM services: <glossterm linkend="gloss-aim">AIM,</glossterm>
+ Facebook, <glossterm linkend="gloss-gadu-gadu">Gadu-Gadu</glossterm>, Google Talk, <glossterm linkend="gloss-gpws">GroupWise</glossterm>,
+ <glossterm linkend="gloss-icq"><acronym>ICQ</acronym></glossterm>, <glossterm linkend="gloss-irc"><acronym>IRC</acronym></glossterm>,
+ <glossterm linkend="gloss-jabber">Jabber</glossterm>, <glossterm linkend="gloss-mnwhl">Meanwhile</glossterm>,
+ <glossterm linkend="gloss-sms"><acronym>SMS</acronym></glossterm>, Skype, Twitter, and Yahoo. (MSN Messenger is
+ still on the list of IM services in version 5.10.3; it has been defunct since 2014.)</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Web</term><listitem><para>You may associate one or more web site URLs with this
+ person. Use the <guibutton> + </guibutton> and <guibutton> − </guibutton>
+ buttons to add or delete Web address fields. The <guibutton> Select ...<inlinemediaobject><imageobject>
+ <imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject></guibutton>
+ Drop Down Box allows you to identify three different kinds of Web addresses: Home, Work, and Other.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Tags</term><listitem><para>You may associate one or more Tags of your own devising with this
+ person. Use the <guibutton> ... </guibutton> button to enter the Tag creation and configuration dialog
+ illustrated below.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ <screenshot id="screenshot-add-tags-dialog">
+ <screeninfo>&kaddressbook;'s <quote>Tags</quote> dialog.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook71.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&kaddressbook;'s <quote>Tags</quote> dialog.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Manage Tags</quote> dialog after clicking the
+ <guibutton> ... </guibutton> button next to <quote>Tags</quote>.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <variablelist>
+ <varlistentry><term>Tags (continued)</term><listitem><para>Use the <guibutton> Create new tag </guibutton>
+ button and the data entry field to the left to build your customized list of tags. Select the
+ tags associated with this person from the list appearing in the configuration window. Press the
+ <guibutton> ✔ OK </guibutton> button to add the selected tags to this contact.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Blog Feed</term><listitem><para>Use this field to record the URL associated with this
+ contact's web log, or blog.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Show messages ...</term><listitem><para>Use this Drop Down Box to override the corresponding message
+ display option in &kmail;'s <guibutton> Privacy & Security </guibutton> configuration menu. Choose
+ <quote>Default</quote> to leave it up to &kmail;. Choose <quote>Plain Text</quote> or <quote>HTML</quote> if you
+ want to override &kmail;'s default behavior when you receive a message from this person.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Allow remote content ...</term><listitem><para>Select this option if you want to override the
+ corresponding message display option in &kmail;'s <guibutton> Privacy & Security </guibutton>
+ configuration menu when you receive a message from this person.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><guibutton> ✔ OK </guibutton></term><listitem><para>Select this option to save the
+ changes you have made. This button performs the same function in all seven tabs appearing in the <guibutton><inlinemediaobject><imageobject>
+ <imagedata fileref="list-add.png" format="PNG"/></imageobject></inlinemediaobject>Add Contact </guibutton> dialog.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><guibutton> ⦸ Cancel </guibutton></term><listitem><para>Select this option to leave
+ the <guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Add Contact </guibutton> dialog without saving your changes. This button performs
+ the same function in all seven tabs appearing in the <quote>Add Contact</quote> dialog.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+ <para> </para> <!-- add more white space after variablelist @dcb -->
+
+ </sect2>
+
+ <sect2 id="edit-location-tab">
+ <title>The Location Tab</title>
+
+ <para>Use the data input fields in the <quote>Location</quote> tab shown below to associate one or more snail-mail
+ addresses with this person.</para>
+
+ <para>
+ <screenshot id="screenshot-location-tab">
+ <screeninfo>&kaddressbook;'s <quote>Location</quote> tab.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook72.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&kaddressbook;'s <quote>Location</quote> tab.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Location</quote> tab, part of the
+ <quote>Add Contact</quote> dialog.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <variablelist>
+ <varlistentry><term>(unlabeled) Drop Down Box</term><listitem><para>Use this list of categories to describe each
+ mailing address for this contact. Available options include <quote>Home</quote>, <quote>Work</quote>,
+ <quote>Postal</quote>, &etc;</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Street / Post Office Box / Postal Code / Locality / Region</term><listitem><para>Use these free-form
+ data fields to enter mailing address data: Street Address, PO Box, ZIP Code, City, and State, respectively, for
+ addresses in the U.S.A.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Country</term><listitem><para>Use this Drop Down Box to select a country, from
+ Afghanistan to Zimbabwe.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>This is the preferred address</term><listitem><para>Check this box to designate the
+ preferred, or default, mailing address.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><guibutton> Add Address </guibutton></term><listitem><para>When you have finished
+ entering address data, left click this button to add a new address to the set of saved addresses appearing in
+ the large display window to the right.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Icon<inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject></inlinemediaobject>
+ in the large display window</term>
+ <listitem><para>Left click this icon to edit the associated address data.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Icon<inlinemediaobject><imageobject><imagedata fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject>
+ in the large display window</term>
+ <listitem><para>Left click this icon to delete the associated address data.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+ <para> </para> <!-- add more white space after variablelist @dcb -->
+ </sect2>
+
+ <sect2 id="edit-business-tab">
+ <title>The Business, Personal, and Notes Tabs</title>
+
+ <para>The next three tabs in the <quote>Add Contact</quote> dialog are even simpler than
+ the <quote>Location</quote> tab. They allow you to save some information about this person's
+ business and professional affiliations, a few personal details, and miscellaneous free-form
+ notes, respectively.</para>
+
+ <para>
+ <screenshot id="screenshot-business-tab">
+ <screeninfo>&kaddressbook;'s <quote>Business</quote> tab.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook73.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&kaddressbook;'s <quote>Business</quote> tab.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Business</quote> tab, part of the
+ <quote>Add Contact</quote> dialog.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The <quote>Business</quote> tab, shown above, lets you save some additional details
+ about this person's professional and business associations. All the input fields are free-form;
+ you may enter any kind of text data in each field. The small
+ <guibutton><inlinemediaobject><imageobject><imagedata fileref="document-open.png" format="PNG"/></imageobject></inlinemediaobject></guibutton>
+ button will open a file search dialog, making it easy to associate a filename with this person's
+ <quote>Free/Busy</quote> schedule, if you wish.</para>
+
+ <para>Notice that you should enter your business associate's phone as a telephone number under the
+ <quote><link linkend="edit-contact-tab">Contact</link></quote> tab. Similarly, his office address is entered
+ via the <quote>Location</quote> tab, as described in <link linkend="edit-location-tab">the preceding section</link>.</para>
+
+ <para> </para> <!-- add more white space before next screenshot @dcb -->
+ <para>
+ <screenshot id="screenshot-personal-tab">
+ <screeninfo>&kaddressbook;'s <quote>Personal</quote> tab.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook74.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&kaddressbook;'s <quote>Personal</quote> tab.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Personal</quote> tab, part of the
+ <quote>Add Contact</quote> dialog.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Use this tab to store a few personal details: this person's birthday, his wedding anniversary, and
+ the name of his partner, or significant other. Click one of the buttons (⪚, <guibutton><inlinemediaobject><imageobject>
+ <imagedata fileref="view-calendar-birthday.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> )
+ to enter his date of birth, or his wedding anniversary.
+ </para>
+
+ <para> </para> <!-- add more white space before next screenshot @dcb -->
+ <para>
+ <screenshot id="screenshot-notes-tab">
+ <screeninfo>&kaddressbook;'s <quote>Notes</quote> tab.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook75.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&kaddressbook;'s <quote>Notes</quote> tab.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Notes</quote> tab, part of the
+ <quote>Add Contact</quote> dialog.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The <quote>Notes</quote> tab provides a totally free-form input area in which
+ you may enter any data you want to associate with this person.</para>
+
+ </sect2>
+
+ </sect1>
+
+ <sect1 id="edit-advanced-info">
+ <title>The Tricky Stuff</title>
+
+ <para>&kaddressbook; provides a couple of more complex data storage features, in addition to the simple
+ functions described in the preceding section.</para>
+
+ <sect2 id="edit-custom-tab">
+ <title>The Custom Fields Tab</title>
+
+ <para>Not happy with the wide array of data items that &kaddressbook; has already pre-programmed for
+ you? Well, you're in luck. Someday -- maybe soon --you may utilize the <quote>Custom Fields</quote> dialog
+ shown below to define and populate as many additional data fields as you can possibly use.</para>
+
+ <para>
+ <screenshot id="screenshot-custom-tab">
+ <screeninfo>&kaddressbook;'s <quote>Custom Fields</quote> tab.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook76.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&kaddressbook;'s <quote>Custom Fields</quote> tab.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Custom Fields</quote> tab, part of the
+ <quote>Add Contact</quote> dialog.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>This is an experimental feature which doesn't yet do anything worth talking about. So I'm not
+ going to say anything else about it.</para>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="edit-crypto-tab">
+ <title>The Crypto Settings Tab</title>
+
+ <para>Need to send a confidential email message that ought not be read by prying eyes? &kaddressbook;
+ provides a simple way for you to associate cryptographic keys with each person on your mailing list.</para>
+
+ <para>
+ <screenshot id="screenshot-crypto-tab">
+ <screeninfo>&kaddressbook;'s <quote>Crypto Settings</quote> tab.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook77.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&kaddressbook;'s <quote>Crypto Settings</quote> tab.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Crypto Settings</quote> tab, part of the
+ <quote>Add Contact</quote> dialog.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+<variablelist>
+ <varlistentry><term>Allowed Protocols</term><listitem><para>Choose which mode of encryption you wish to use when
+ sending a message to this person: <glossterm linkend="gloss-inline-pgp">Inline OpenPGP</glossterm>, <glossterm
+ linkend="gloss-open-pgp">OpenPGP/<acronym>MIME</acronym></glossterm>, <glossterm linkend="gloss-mime"><acronym>S/MIME</acronym>
+ </glossterm>, or <glossterm linkend="gloss-opaque"><acronym>S/MIME</acronym> Opaque</glossterm>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Preferred OpenPGP Encryption Key:</term><listitem><para>Use the <guibutton> Change... </guibutton>
+ button to select from a list of available Open<glossterm linkend="gloss-pgp">PGP</glossterm> keys, if you have chosen OpenPGP
+ encryption. Use the <guibutton><inlinemediaobject><imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject>
+ </inlinemediaobject></guibutton> button to clear a previously selected key.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Preferred <acronym>S/MIME</acronym> Encryption Certificate:</term>
+ <listitem><para>Use the <guibutton> Change... </guibutton> button to select from a list of available certificates,
+ if you are using a verified key. Use the <guibutton><inlinemediaobject><imageobject><imagedata fileref="edit-clear.png" format="PNG"/>
+ </imageobject></inlinemediaobject></guibutton> button to clear a previously selected key.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Message Preference / Sign:</term><listitem><para>Use this drop-down box to specify when messages addressed to
+ this person should bear your cryptographic signature: Never / Always / If Possible / Ask.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>Message Preference / Encrypt:</term><listitem><para>Use this drop-down box to specify when messages addressed to
+ this person should be encrypted by using the selected protocol and key: Never / Always / If Possible / Ask.</para></listitem>
+ </varlistentry>
+
+</variablelist>
+
+ </sect2>
+
+ </sect1>
+
+</chapter>
+
+<chapter id="commands">
+<title>Command Reference</title>
+
+ <sect1 id="menu-bar-items">
+ <title>The Menu Bar</title>
+
+ <para>Here is a rundown of the seven menus appearing on &kaddressbook;'s Menubar.</para>
+
+
+ <sect2 id="the-file-menu">
+ <title>The File Menu</title>
+
+ <para>
+ <screenshot id="screenshot-file-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>File</quote> menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook80.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>File</quote> menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>File</quote> menu after clicking the
+ <menuchoice><guimenu>File</guimenu></menuchoice> button on the Menubar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The <menuchoice><guimenu>File</guimenu></menuchoice> menu lets you access six main functions, three of which have several options.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut><guimenu>File</guimenu>
+ <guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="list-add.png"
+ format="PNG"/></imageobject></inlinemediaobject>New Contact</guimenuitem></menuchoice></term>
+ <listitem><para>This has exactly the same effect as clicking the <guibutton> + New Contact </guibutton> button
+ on the Toolbar. See <link linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut><guimenu>File</guimenu>
+ <guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png"
+ format="PNG"/></imageobject></inlinemediaobject>New Group</guimenuitem></menuchoice></term>
+ <listitem><para>Opens a dialog in which you may define a new group, or mailing list. See <link linkend="file-new-group">the appendix</link>
+ for a detailed explanation of this function.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu>New ></guisubmenu><guimenuitem><inlinemediaobject><imageobject>
+ <imagedata fileref="folder-new.png" format="PNG"/></imageobject></inlinemediaobject>Add Address Book</guimenuitem></menuchoice></term>
+ <listitem><para>This opens the <quote>Add Address Book</quote> dialog, which is fully documented in
+ <link linkend="how-to-add-a-new-address-book">chapter 2 above</link>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu><guimenuitem>Import from LDAP
+ server ...</guimenuitem></menuchoice></term>
+ <listitem><para>This function allows you to import data from an <acronym>LDAP</acronym> server. The server must be configured before
+ you can use this function. See <link linkend="configure-ldap-server">the appendix</link> for full details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu><guimenuitem>Import CSV file ...</guimenuitem></menuchoice></term>
+ <listitem><para>This function allows you to import contact data from a comma separated values (<acronym>csv</acronym>) file. A dialog ensues, in which
+ you may associate each field in the input file with a named field in &kaddressbook;'s internal storage record. See <link linkend="import-csv-data">the
+ appendix</link> for a more detailed explanation.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu>Import ></guisubmenu><guimenuitem>Import vCard ...</guimenuitem></menuchoice></term>
+ <listitem><para>This function facilitates the importation of <acronym>vcf</acronym>, or vCard, data. All three versions of vCard are supported.
+ You can learn more about the vCard formats <ulink url="https://en.wikipedia.org/wiki/VCard">at this web site</ulink>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export CSV file ...</guimenuitem></menuchoice></term>
+ <listitem><para>This function allows you to export selected contact data as a Comma Separated Values (<acronym>csv</acronym>) file. There are 47
+ fields in the output record. Please refer to <link linkend="export-csv-data">the appendix</link> for a list of those data fields.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export vCard 4.0 ...</guimenuitem></menuchoice></term>
+ <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 4.0</acronym> format. See
+ <ulink url="https://en.wikipedia.org/wiki/VCard">this Wikipedia article</ulink> for more information.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export vCard 3.0 ...</guimenuitem></menuchoice></term>
+ <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 3.0</acronym> format. This
+ format is similar to <acronym>vCard 4.0</acronym> format.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu>Export ></guisubmenu><guimenuitem>Export vCard 2.1 ...</guimenuitem></menuchoice></term>
+ <listitem><para>This function allows you to export selected contact data as a file in <acronym>vCard 2.1</acronym> format. This
+ format is similar to <acronym>vCard 3.0</acronym> format.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut><guimenu>File</guimenu>
+ <guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-print.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Print</guisubmenu></menuchoice></term>
+ <listitem><para>Opens a printer selection dialog. Use the <menuchoice><guisubmenu><inlinemediaobject><imageobject>
+ <imagedata fileref="document-preview-archive.png" format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice>
+ dialog below to set up the range of names and the print format before you select this function.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>File</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/>
+ </imageobject></inlinemediaobject>Print Preview</guisubmenu></menuchoice></term>
+ <listitem><para>Opens a print preview dialog, which also permits you to format the report, select which items to include, and
+ specify a sort order, etc. See <link linkend="file-print-preview">the appendix</link> for further details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut><guimenu>File</guimenu>
+ <guisubmenu><inlinemediaobject><imageobject><imagedata fileref="application-exit.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Quit</guisubmenu></menuchoice></term>
+ <listitem><para>Closes the &kaddressbook; application.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="the-edit-menu">
+ <title>The Edit Menu</title>
+
+ <para>
+ <screenshot id="screenshot-edit-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Edit</quote> menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook81.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Edit</quote> menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Edit</quote> menu after clicking the
+ <menuchoice><guimenu>Edit</guimenu></menuchoice> button on the Menubar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The <menuchoice><guimenu>Edit</guimenu></menuchoice> menu lets you access eight main functions, two of which have multiple options.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="document-edit.png"
+ format="PNG"/></imageobject></inlinemediaobject>Edit Contact ...</guisubmenu></menuchoice></term>
+ <listitem><para>This has nearly the same effect as clicking the <guibutton> + New Contact </guibutton> button
+ on the Toolbar. The difference is that this menu item allows you to edit a contact record that already exists, instead of creating
+ a brand new one. See <link linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject>
+ <imageobject><imagedata fileref="edit-cut.png" format="PNG"/></imageobject></inlinemediaobject>Cut Contact ...</guisubmenu></menuchoice></term>
+ <listitem><para>Performs a <quote>Cut</quote> operation on the selected contact. A copy of this contact, in
+ <glossterm linkend="gloss-vcf"><acronym>vCard 3.0</acronym></glossterm> format, is placed on the clipboard. The
+ <quote>Cut</quote> will be completed when you <quote>Paste</quote> this contact somewhere.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png"
+ format="PNG"/></imageobject></inlinemediaobject>Copy Contact ...</guisubmenu></menuchoice></term>
+ <listitem><para>Places a copy of this contact on the clipboard, so you can paste it somewhere else.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject>
+ <imageobject><imagedata fileref="edit-paste.png" format="PNG"/></imageobject></inlinemediaobject>Paste</guisubmenu></menuchoice></term>
+ <listitem><para><quote>Pastes</quote> the cut or copied contact at the current location. This may be in the same address book you
+ did the <quote>Cut</quote> or <quote>Copy</quote> from, or in another address book. Since the preceding operations placed
+ the contact information on the system's clipboard, you may also paste it somewhere else besides &kaddressbook; (⪚ into a
+ text editor, or as a <acronym>vCard 3.0</acronym> file in your home folder).</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Copy Contact To ></guisubmenu><guimenuitem>(a variable list)</guimenuitem></menuchoice></term>
+ <listitem><para>Combines the <quote>Copy</quote> and <quote>Paste</quote> operations into a single click of the left
+ mouse button. The list of destinations displayed depends on how many address books you have created.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="go-jump.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Move Contact To ></guisubmenu><guimenuitem>(a variable list)</guimenuitem></menuchoice></term>
+ <listitem><para>Works just like the <quote>Copy Contact To</quote> operation described above, except that it combines
+ <quote>Cut</quote> and <quote>Paste</quote> into a single click of the left mouse button.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="press">∇</keycombo></shortcut><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject>
+ <imagedata fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject>Delete Contact</guisubmenu></menuchoice></term>
+ <listitem><para>Delete the selected contact from the current address book.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Edit</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png"
+ format="PNG"/></imageobject></inlinemediaobject>Delete Address Book</guisubmenu></menuchoice></term>
+ <listitem><para>Delete the current address book. Be careful with this command -- you could lose some data!
+ In theory, this function simply removes the symbolic link between &kaddressbook; and the associated <acronym>vCard</acronym>
+ file or directory (or the hyperlink to a <glossterm linkend="gloss-cloud">cloud-based service</glossterm>), and the real data will
+ not be altered. Still, it's probably wisest to make a backup copy of this address book somewhere before you delete it.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="the-view-menu">
+ <title>The View Menu</title>
+
+ <para>
+ <screenshot id="screenshot-view-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook82.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>View</quote> menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>View</quote> menu after clicking the
+ <menuchoice><guimenu>View</guimenu></menuchoice> button on the Menubar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The <menuchoice><guimenu>View</guimenu></menuchoice> menu lets you access four main functions, and one experimental
+ feature which doesn't really do anything yet.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>View</guimenu><guisubmenu>Themes ></guisubmenu></menuchoice></term>
+ <listitem><para>This menu item doesn't really do anything. It will open a <quote>Themes</quote> dialog,
+ but that dialog is broken in release 5.10.3.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>1</keycap></keycombo></shortcut>
+ <guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png"
+ format="PNG"/></imageobject></inlinemediaobject>Simple (one column)</guisubmenu></menuchoice></term>
+ <listitem><para>Changes the default three panel layout into a single column. For more details, see
+ <link linkend="view-change-columns">the appendix</link>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>2</keycap></keycombo></shortcut>
+ <guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png"
+ format="PNG"/></imageobject></inlinemediaobject>Two columns</guisubmenu></menuchoice></term>
+ <listitem><para>Changes the default three panel layout into two panels. For more details, see
+ <link linkend="view-change-columns">the appendix</link>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>3</keycap></keycombo></shortcut>
+ <guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-circle.png"
+ format="PNG"/></imageobject></inlinemediaobject>Three columns</guisubmenu></menuchoice></term>
+ <listitem><para>Switches back to the default three panel layout.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>View</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png"
+ format="PNG"/></imageobject></inlinemediaobject>Show QR Codes</guisubmenu></menuchoice></term>
+ <listitem><para>Check this box to display contact information as a QR code. Uncheck it to suppress QR codes.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="the-action-menu">
+ <title>The Action Menu</title>
+
+ <para>
+ <screenshot id="screenshot-action-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Action</quote> menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook83.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Action</quote> menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Action</quote> menu after clicking the
+ <menuchoice><guimenu>Action</guimenu></menuchoice> button on the Menubar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The <menuchoice><guimenu>Action</guimenu></menuchoice> menu lets you access two data transmission functions.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Action</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="mail-message-new.png"
+ format="PNG"/></imageobject></inlinemediaobject>Send vCards...</guisubmenu></menuchoice></term>
+ <listitem><para>This option is similar to <quote>Send an email...</quote>, below, except that after
+ you select some contacts with &Ctrl; and your mouse, the message composition window will open with a
+ blank list of addressees, and with files attached (the selected contacts, in vCard 3.0 format). This
+ makes it easy to share selected &kaddressbook; information with your friends and business associates.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Action</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="mail-message-new.png"
+ format="PNG"/></imageobject></inlinemediaobject>Send an email...</guisubmenu></menuchoice></term>
+ <listitem><para>This option provides an alternate method for setting a new email message's recipient list.
+ Press &Ctrl; (or &Shift;) and select the people to whom you wish to send the new message, by using your left
+ mouse button. Then click on <quote>Send an Email...</quote>; this will open a &kmail; composition window. All
+ the selected contacts will be listed as <quote>To</quote> addressees.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="the-tools-menu">
+ <title>The Tools Menu</title>
+
+ <para>
+ <screenshot id="screenshot-tools-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Tools</quote> menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook84.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Tools</quote> menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Tools</quote> menu after clicking the
+ <menuchoice><guimenu>Tools</guimenu></menuchoice> button on the Menubar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The <menuchoice><guimenu>Tools</guimenu></menuchoice> menu lets you access two data management functions.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Merge Contacts...</guisubmenu></menuchoice></term>
+ <listitem><para>This tool allows you to merge the contents of two or more &kaddressbook; records. To activate it,
+ you must first select two or more contacts (hold &Ctrl; or &Shift; and left-click contacts to make your selection).
+ A dialog box will appear, asking you to verify which contacts you wish to combine, and where the merged record
+ should be saved. Click <quote>merge</quote> to complete the operation.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Search Duplicate Contacts...</guisubmenu></menuchoice></term>
+ <listitem><para>This tool will search one or more address books for duplicate entries, and offer you the option
+ of merging any duplicate records it finds.</para></listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="the-settings-menu">
+ <title>The Settings Menu</title>
+
+ <para>
+ <screenshot id="screenshot-settings-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Settings</quote> menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook85.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Settings</quote> menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Settings</quote> menu after clicking the
+ <menuchoice><guimenu>Settings</guimenu></menuchoice> button on the Menubar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ <para>The <menuchoice><guimenu>Settings</guimenu></menuchoice> menu offers you five options for fine-tuning the
+ way &kaddressbook; operates.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png"
+ format="PNG"/></imageobject></inlinemediaobject><inlinemediaobject><imageobject><imagedata fileref="show-menu.png"
+ format="PNG"/></imageobject></inlinemediaobject>Show Menubar</guisubmenu></menuchoice>
+ <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></term>
+ <listitem><para>This option allows you to show or hide the Menubar.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="draw-rectangle.png"
+ format="PNG"/></imageobject></inlinemediaobject>Show Toolbar</guisubmenu></menuchoice></term>
+ <listitem><para>This option allows you to show or hide the Toolbar.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="input-keyboard.png"
+ format="PNG"/></imageobject></inlinemediaobject>Configure Shortcuts...</guisubmenu></menuchoice></term>
+ <listitem><para>This option allows you to customize the keyboard shortcuts available within &kaddressbook;.
+ See <link linkend="settings-configure-shortcuts">the appendix</link> for more details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png"
+ format="PNG"/></imageobject></inlinemediaobject>Configure Toolbars...</guisubmenu></menuchoice></term>
+ <listitem><para>This option allows you to customize the contents of &kaddressbook;'s Toolbar.
+ See <link linkend="settings-configure-toolbars">the appendix</link> for more details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Settings</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="configure.png"
+ format="PNG"/></imageobject></inlinemediaobject>Configure &kaddressbook;...</guisubmenu></menuchoice>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>,</keycap></keycombo></term>
+ <listitem><para>This option allows you to configure several advanced &kaddressbook; options.
+ See <link linkend="settings-configure-kaddressbook">the appendix</link> for more details.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="the-help-menu">
+ <title>The Help Menu</title>
+
+ <para>
+ <screenshot id="screenshot-help-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Help</quote> menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook86.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Help</quote> menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Help</quote> menu after clicking the
+ <menuchoice><guimenu>Help</guimenu></menuchoice> button on the Menubar.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>The <menuchoice><guimenu>Help</guimenu></menuchoice> menu offers seven options.</para>
+
+ <para> </para> <!-- add more white space @dcb -->
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="system-help.png"
+ format="PNG"/></imageobject></inlinemediaobject>&kaddressbook; Handbook</guisubmenu></menuchoice>
+ <keycombo action="press"><keycap>F1</keycap></keycombo></term>
+ <listitem><para>This option displays a copy of <quote>The &kaddressbook; Handbook</quote> via the
+ &khelpcenter; utility program.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="help-about.png"
+ format="PNG"/></imageobject></inlinemediaobject>What's This?</guisubmenu></menuchoice><keycombo action="simul">&Shift;
+ <keycap>F1</keycap></keycombo></term>
+ <listitem><para>This is &kaddressbook;'s built-in help tool. Left-click this option, then move your cursor and click on any
+ one of the first four items on the Toolbar. A brief description of that tool's function will be displayed.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="tools-report-bug.png"
+ format="PNG"/></imageobject></inlinemediaobject>Report Bug</guisubmenu></menuchoice></term>
+ <listitem><para>This option opens a dialog that helps you file a bug report at <ulink
+ url="https://bugs.kde.org/">bugs.kde.org</ulink>, &kde;'s main bug tracking page.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="application-x-ms-shortcut.png"
+ format="PNG"/></imageobject></inlinemediaobject>Donate</guisubmenu></menuchoice></term>
+ <listitem><para>This opens a <ulink url="https://kde.org/community/donations/?app=kaddressbook">web
+ page</ulink> in your browser, where you may donate money to support &kde;. We accept euros, dollars,
+ rubles, sterling, yen, yuan, pesos, &etc;</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="change-language.png"
+ format="PNG"/></imageobject></inlinemediaobject>Switch Application Language</guisubmenu></menuchoice></term>
+ <listitem><para>This option lets you change the language that is used to label the various menu items and built-in
+ help screens. You must quit &kaddressbook; and restart it before the new language takes effect.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="kaddressbook.png"
+ format="PNG"/></imageobject></inlinemediaobject>About &kaddressbook;</guisubmenu></menuchoice></term>
+ <listitem><para>Click on this item to learn which release of &kaddressbook; you're running, which libraries
+ were used to compile / build the executable code, and who the lead &kde; programmer is.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Help</guimenu><guisubmenu><inlinemediaobject><imageobject><imagedata fileref="KDE_logo.png"
+ format="PNG"/></imageobject></inlinemediaobject>About &kde;</guisubmenu></menuchoice></term>
+ <listitem><para>This option displays information about &kde;. Be free!</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect2>
+
+ </sect1>
+
+ <sect1 id="tool-bar-items">
+ <title>The Tool Bar</title>
+
+ <para>There are five separate tools available on &kaddressbook;'s Toolbar: <quote>New Contact</quote>, <quote>New Group</quote>,
+ <quote>Edit Contact</quote>, <quote>Search...</quote>, and a category filter. Here's a picture. (Note that I have only documented
+ the default version of &kaddressbook;'s Toolbar. You may alter the Toolbar layout by using the <link linkend="the-settings-menu">
+ <quote>Settings</quote></link> menu, if you so desire.)</para>
+
+ <para>
+ <screenshot id="screenshot-tool-bar">
+ <screeninfo>A closeup of &kaddressbook;'s Toolbar.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook87.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A closeup of &kaddressbook;'s Toolbar.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s standard Toolbar, up close and personal.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <variablelist>
+
+ <varlistentry>
+ <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="list-add.png"
+ format="PNG"/></imageobject></inlinemediaobject>New Contact</guibutton></term>
+ <listitem><para>This Toolbar button opens the <quote>Add New Contact</quote> dialog
+ documented in <link linkend="edit-basic-info">chapter 4</link>, above.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png"
+ format="PNG"/></imageobject></inlinemediaobject>New Group</guibutton></term>
+ <listitem><para>This Toolbar button opens the <quote>Add New Group</quote> dialog
+ documented in <link linkend="file-new-group">the appendix</link>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guibutton><inlinemediaobject><imageobject><imagedata fileref="document-edit.png"
+ format="PNG"/></imageobject></inlinemediaobject>Edit Contact</guibutton></term>
+ <listitem><para>This Toolbar button opens the <quote>Edit Contact</quote> dialog
+ documented in <link linkend="edit-basic-info">chapter 4</link>, above.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>[ Search... <keycombo action="simul">&Alt;<keycap>Q</keycap></keycombo> ]</term>
+ <listitem><para>This tool searches through all the contacts in selected address books as you type.
+ Pressing &Alt;+Q simply positions the cursor inside the <quote>Search...</quote>
+ box. Be aware that this function searches the entirety of each contact record; a search for
+ <quote>and</quote> may return not only Andy Brown and Andrew Jones, but also Bill
+ Smith (who happens to work for Brown and Root Construction Company).</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ <screenshot id="toolbar-search">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Search</quote> function.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook91.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Search</quote> function.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Search</quote> function in action.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <variablelist>
+
+ <varlistentry>
+ <term>[ (All) <inlinemediaobject><imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject>
+ <inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject></inlinemediaobject>]</term>
+ <listitem><para>This tool performs a filtering function, based on categories. The two default categories are <quote>Untagged</quote>
+ and <quote>Groups</quote>. You can create new categories by associating <quote>Tags</quote> of your own devising with particular
+ contact records (see <link linkend="edit-basic-info">Add New Contact</link> in chapter 4, above). Clicking either <guibutton><inlinemediaobject>
+ <imageobject><imagedata fileref="edit-clear.png" format="PNG"/></imageobject></inlinemediaobject></guibutton> button will set the selected
+ categories to <quote>None</quote>; the <guibutton><inlinemediaobject><imageobject><imagedata fileref="view-refresh.png" format="PNG"/>
+ </imageobject></inlinemediaobject></guibutton> button will reset the selection criteria to <quote>All</quote>.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ <screenshot id="toolbar-filter">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Filter</quote> function.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook92.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Filter</quote> function.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Filter</quote> function in action.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ </sect1>
+
+ <sect1 id="context-menus">
+ <title>The Context Menus</title>
+
+ <para>When you click the right mouse button anywhere inside the main Text Area, a context menu will appear, as illustrated below.
+ The particular menu that appears depends on both the panel within which the right-click occurred and the particular data item that
+ was selected, if any.</para>
+
+ <sect2 id="the-addressbook-panel">
+ <title>The Address Book Context Menu</title>
+
+ <para>
+ <screenshot id="addressbook-context-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Address Book</quote> context menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook93.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Address Book</quote> context menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Address Book</quote> context menu.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="folder-new.png"
+ format="PNG"/></imageobject></inlinemediaobject>Add Address Book Folder...</guimenu></menuchoice></term>
+ <listitem><para>This context menu option does not perform a useful function in release 5.10.3.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png"
+ format="PNG"/></imageobject></inlinemediaobject>Delete Address Book Folder</guimenu></menuchoice></term>
+ <listitem><para>This context menu option does not perform a useful function in release 5.10.3.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="folder-new.png"
+ format="PNG"/></imageobject></inlinemediaobject>Add Address Book...</guimenu></menuchoice></term>
+ <listitem><para>This context menu option launches the <quote>Add Address Book</quote> dialog that is
+ documented in <link linkend="how-to-add-a-new-address-book">chapter 2</link>, above.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-delete.png"
+ format="PNG"/></imageobject></inlinemediaobject>Delete Address Book</guimenu></menuchoice></term>
+ <listitem><para>Choosing this context menu option will delete the selected address book.
+ Be careful!</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="press"><keycap>F5</keycap></keycombo></shortcut><guimenu><inlinemediaobject>
+ <imageobject><imagedata fileref="view-refresh.png" format="PNG"/></imageobject></inlinemediaobject>Update Address Book
+ Folder</guimenu></menuchoice></term>
+ <listitem><para>This context menu option forces &kaddressbook; to reload the contact
+ data associated with the selected address book.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="configure.png"
+ format="PNG"/></imageobject></inlinemediaobject>Folder Properties...</guimenu></menuchoice></term>
+ <listitem><para>This context menu option displays summary information about the selected
+ address book.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="configure.png"
+ format="PNG"/></imageobject></inlinemediaobject>Address Book Properties...</guimenu></menuchoice></term>
+ <listitem><para>This context menu option displays summary information about the selected
+ address book.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-open.png"
+ format="PNG"/></imageobject></inlinemediaobject>Serverside Subscription...</guimenu></menuchoice></term>
+ <listitem><para>This context menu option may or may not perform a useful function in release 5.10.3; so
+ far as I can tell, it is permanently grayed out. If you understand what it does, please let me know
+ (davidbryant AT gvtc.com).</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="the-contactslist-panel">
+ <title>The List of Contacts Context Menu</title>
+
+ <para>
+ <screenshot id="contactlist-context-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Contact List</quote> context menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook94.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Contact List</quote> context menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Contact List</quote> context menu.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <variablelist>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
+ <guimenu><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/>
+ </imageobject></inlinemediaobject>New Contact</guimenu></menuchoice></term>
+ <listitem><para>Choosing this context menu option has exactly the same effect as clicking the
+ <guibutton> + New Contact </guibutton> button on the Toolbar. See <link
+ linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut>
+ <guimenu><inlinemediaobject><imageobject><imagedata fileref="user-group-new.png" format="PNG"/>
+ </imageobject></inlinemediaobject>New Group</guimenu></menuchoice></term>
+ <listitem><para>Choosing this context menu option opens a dialog in which you may define a new group, or mailing
+ list. See <link linkend="file-new-group">the appendix</link> for a detailed explanation.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-edit.png" format="PNG"/>
+ </imageobject></inlinemediaobject>Edit Contact ...</guimenu></menuchoice></term>
+ <listitem><para>Choosing this context menu option has exactly the same effect as clicking the <guibutton><inlinemediaobject>
+ <imageobject><imagedata fileref="document-edit.png" format="PNG"/></imageobject></inlinemediaobject>Edit Contact...</guibutton> button
+ on the Toolbar. See <link linkend="how-to-add-a-new-contact">chapter 2 above</link> for complete details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu>Export ></guimenu></menuchoice></term>
+ <listitem><para>This context menu function allows you to export selected contact data in either <acronym>vCard</acronym> or
+ <acronym>csv</acronym> format.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="edit-copy.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Copy Contact To ></guimenu></menuchoice></term>
+ <listitem><para>This context menu choice lets you copy the selected contact(s) to a variable destination. The list of
+ destinations displayed when this option is chosen depends on how many address books you have created.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="go-jump.png" format="PNG"/></imageobject>
+ </inlinemediaobject>Move Contact To ></guimenu></menuchoice></term>
+ <listitem><para>Works just like the <quote>Copy Contact To</quote> operation described above, except that it deletes
+ the source data, instead of creating an extra copy of it.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut><guimenu><inlinemediaobject>
+ <imageobject><imagedata fileref="document-print.png" format="PNG"/></imageobject></inlinemediaobject>Print</guimenu></menuchoice></term>
+ <listitem><para>Choosing this context menu item opens a printer selection dialog. Use the <menuchoice><guisubmenu><inlinemediaobject>
+ <imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/></imageobject></inlinemediaobject>Print Preview</guisubmenu>
+ </menuchoice> dialog below to set up the range of names and the print format before you select this function.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><guimenu><inlinemediaobject><imageobject><imagedata fileref="document-preview-archive.png" format="PNG"/>
+ </imageobject></inlinemediaobject>Print Preview</guimenu></menuchoice></term>
+ <listitem><para>This context menu option opens a print preview dialog, which also permits you to format the report, select which items to
+ include, and specify a sort order, etc. See <link linkend="file-print-preview">the appendix</link> for further details.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice><shortcut><keycombo action="press">∇</keycombo></shortcut><guimenu><inlinemediaobject><imageobject><imagedata
+ fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject>Delete Contact</guimenu></menuchoice></term>
+ <listitem><para>Delete the selected contact(s) from the current address book.</para></listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para> </para> <!-- add more white space between sections @dcb -->
+
+ </sect2>
+
+ <sect2 id="the-individualcontact-panel">
+ <title>The Individual Contact Context Menu</title>
+
+ <para>
+ <screenshot id="individualcontact-context-menu">
+ <screeninfo>A screenshot of &kaddressbook;'s <quote>Individual Contact</quote> context menu.</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="addressbook95.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>A screenshot of &kaddressbook;'s <quote>Individual Contact</quote> context menu.</phrase>
+ </textobject>
+ <caption>
+ <para>&kaddressbook;'s <quote>Individual Contact</quote> context menu.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para> </para> <!-- add more white space after screenshot @dcb -->
+
+ <para>Depending on which data item you select, the caption in this context menu may vary. But in
+ every case, the function is the same: the selected data item is copied to the clipboard.</para>
+
+ </sect2>
+
+ </sect1>
+
+</chapter>
+
+<glossary>
+
+<!-- Note to proofreaders: I'm still building the glossary. @dcb2019223 -->
+
+ <glossentry id="gloss-aim">
+ <glossterm><acronym>AIM</acronym></glossterm>
+ <glossdef><para><acronym>AIM</acronym> stands for America Online Instant Messaging. AIM was an early leader in
+ the competitive IM marketplace, but fell into disfavor as AOL itself became less popular. The original service
+ was discontinued in 2017, but fans have kept it running <ulink url="http://iwarg.ddns.net/aim/">at this
+ web site</ulink>.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-akonadi">
+ <glossterm>&akonadi;</glossterm>
+ <glossdef><para>An extensible cross-desktop storage service for PIM data and meta data providing
+ concurrent read, write, and query access. &akonadi; can be manipulated with the akonadictl
+ command: enter <quote>akonadictl --help</quote> in a console window to learn more.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-cloud">
+ <glossterm>Cloud-based service</glossterm>
+ <glossdef><para>Any provider of data storage and data processing resources residing in some
+ <quote>cloud</quote> of servers one may access via the internet.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-csv">
+ <glossterm>.csv</glossterm>
+ <glossdef><para>A Comma Separated Values (or <filename class="extension">.csv</filename>) file is a
+ plain text document in which each line, or record, is divided into fields by a specific separator character,
+ usually a comma. The <filename class="extension">.csv</filename> format dates back to the early days
+ of computing. It is still widely used, mainly because it is conceptually so simple.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-dav">
+ <glossterm><acronym>DAV</acronym></glossterm>
+ <glossdef><para><acronym>DAV</acronym> stands for Distributed Authoring and Versioning, which exists in
+ several <quote>flavors</quote>, such as WebDAV (for creating pages on the internet), GroupDAV (for groupware,
+ open source software authored by a group of collaborators), and CalDAV (calendar management for groups),
+ each one of which helps connect open source clients with open source servers.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-digest">
+ <glossterm><acronym>DIGEST-MD5</acronym></glossterm>
+ <glossdef><para><acronym>DIGEST-MD5</acronym> is an authentication technique used to set up secure communications
+ between a client and an internet service. It gets its name from the MD5 hashing function used to encode the client's
+ credentials. See <ulink url="https://en.wikipedia.org/wiki/Digest_access_authentication">this Wikipedia article</ulink>
+ to learn more about it.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-ews">
+ <glossterm><acronym>EWS</acronym></glossterm>
+ <glossdef><para><acronym>EWS</acronym> stands for Exchange Web Services, &Microsoft;'s set of
+ proprietary protocols for exchanging personal data between internet servers and end users, or clients.
+ <glossterm linkend="gloss-kolab">Kolab</glossterm> provides similar functionality.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-gadu-gadu">
+ <glossterm>Gadu-Gadu</glossterm>
+ <glossdef><para>Gadu-Gadu (aka GG) is the most popular instant-messaging app in Poland.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-gmx">
+ <glossterm><acronym>GMX</acronym></glossterm>
+ <glossdef><para><acronym>GMX</acronym> stands for Global Mail eXchange (or, in Germany, Global Message eXchange),
+ a free advertising-supported email service. Visit either <ulink url="https://www.gmx.net/">this web site</ulink>
+ or <ulink url="https://www.gmx.com/">this one</ulink> to learn more about it.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-gravatar">
+ <glossterm>Gravatar</glossterm>
+ <glossdef><para>A Gravatar, or Globally Recognized Avatar, is a graphic image associated with a WordPress
+ user's email address. It is usually displayed as an 80px X 80px graphic image. Since many bloggers use
+ WordPress software, the Gravatar is widely available.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-gpws">
+ <glossterm>GroupWise</glossterm>
+ <glossdef><para>GroupWise Messenger is an instant messaging service sponsored by Micro Focus International
+ plc, a software company located in Newbury, Berkshire, England. You can get a copy of the Messenger software
+ from <ulink url="https://mail.dcbe.org:8300/">this web site</ulink>.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-gssapi">
+ <glossterm><acronym>GSSAPI</acronym></glossterm>
+ <glossdef><para><acronym>GSSAPI</acronym> stands for Generic Security Service Application Program Interface,
+ a sort of <quote>dictionary</quote> for the many security protocols in use on the internet. It consists of a
+ program library and a set of standard subroutine calls that allow an internet client to determine which particular
+ security protocol an internet service is using, and then to encode/decode the user's credentials appropriately.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-icq">
+ <glossterm><acronym>ICQ</acronym></glossterm>
+ <glossdef><para><acronym>ICQ</acronym> is not precisely an acronym: it's a pun meant to sound like <quote>I
+ Seek You</quote>. It is one of the original IM platforms, first coming online in 1996. The software is available
+ for download <ulink url="https://icq.com/linux/en">here</ulink>.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-imap">
+ <glossterm>&IMAP;</glossterm>
+ <glossdef><para><acronym>IMAP</acronym> stands for Internet Message Access Protocol, a widely
+ available method for managing email messages. IMAP maintains and synchronizes local and remote
+ copies of a set of messages -- in other words, the locally stored data for an IMAP account are
+ a mirror image of the messages on the server.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-inline-pgp">
+ <glossterm>Inline OpenPGP</glossterm>
+ <glossdef><para>Inline OpenPGP is an encryption protocol in which PGP signatures are directly
+ embedded in the body of the email message. This protocol is deprecated because of technical
+ difficulties caused by the indiscriminate use of non-ASCII characters in plain-text email
+ messages.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-irc">
+ <glossterm><acronym>IRC</acronym></glossterm>
+ <glossdef><para><acronym>IRC</acronym> stands for Internet Relay Chat, an IM service that has its
+ roots in a Finnish predecessor of the World Wide Web called OuluBox (1988). <acronym>IRC</acronym>
+ has been losing users steadily for many years as social media platforms like Facebook have become
+ more popular. The largest remaining network is known as Freenode; it can be accessed <ulink
+ url="https://webchat.freenode.net/">via this web site</ulink>.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-isdn">
+ <glossterm><acronym>ISDN</acronym></glossterm>
+ <glossdef><para><acronym>ISDN</acronym> stands for Integrated Services Data Network, the very first set of
+ telecommunication standards that permitted the simultaneous transmission of analog voice signals and digital
+ data signals over a switched network of copper wires (&ie; the old-style telephone system). <acronym>ISDN</acronym>
+ was unavoidable in the early days of the Internet, but has lately been supplanted by more robust technologies
+ that permit unswitched connections over networks that utilize fiber optic cables, satellites, and very high
+ frequency microwave transmitters / receivers. It is still widely used in a few industrial applications where
+ a direct point-to-point connection is necessary, but is on the way out in the broader consumer market.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-jabber">
+ <glossterm>Jabber</glossterm>
+ <glossdef><para>Jabber is an instant-messaging service that relies on the <glossterm linkend="gloss-xmpp"><acronym>XMPP</acronym>
+ </glossterm> protocol. The original <quote>Jabber</quote> web site is no longer accepting new registrations, but the
+ <acronym>XMPP</acronym> protocol is in widespread use. See <ulink url="https://xmpp.org/about/">this web site</ulink>
+ for more information.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-kmail">
+ <glossterm>&kmail;</glossterm>
+ <glossdef><para>&kde;'s email management program. Provides a fully integrated environment
+ for sending and receiving email messages from one (or more) email account(s), maintaining
+ as many email identities as you want to have, organizing and archiving your old email
+ messages, and managing your personal email encryption keys.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-kolab">
+ <glossterm>Kolab</glossterm>
+ <glossdef><para>Kolab Systems AG is a corporation headquartered in Zurich, Switzerland that
+ provides both proprietary and open source software tools to facilitate collaboration among
+ groups of people who share data, messages, and calendaring / scheduling resources via the
+ internet. <glossterm linkend="gloss-ews">EWS</glossterm> provides similar, though
+ wholly proprietary, software packages.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-ldap">
+ <glossterm><acronym>LDAP</acronym></glossterm>
+ <glossdef><para>The Lightweight Directory Access Protocol (or <acronym>ldap</acronym>) is
+ a standard protocol, or method, for sharing some particular classes of information among the
+ many server computers that comprise the internet.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-ldif">
+ <glossterm>.ldif</glossterm>
+ <glossdef><para>An <glossterm linkend="gloss-ldap"><acronym>LDAP</acronym></glossterm>
+ Data Interchange Format (or <filename class="extension">.ldif</filename>) file is a type
+ of plain text file designed for exchanging directory information among the various servers
+ in a distributed network.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-mnwhl">
+ <glossterm>Meanwhile</glossterm>
+ <glossdef><para><quote>Meanwhile</quote> is open source software designed to communicate with IBM's
+ <ulink url="https://en.wikipedia.org/wiki/IBM_Sametime"><quote>Sametime</quote></ulink> instant
+ messaging software. See <ulink url="https://github.com/obriencj/meanwhile">this web site</ulink>
+ if you want to learn more about it.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-acro-mime">
+ <glossterm><acronym>MIME</acronym></glossterm>
+ <glossdef><para><acronym>MIME</acronym> stands for Multipurpose Internet Mail Extensions,
+ a set of coding conventions designed to make email messages more flexible by enabling features
+ like extended character sets, embedded images, <quote>rich text</quote> coding, &etc; The original
+ email coding conventions supported nothing besides plain text (or encrypted) messages written with 7-bit
+ ASCII code. Almost all contemporary email messages are <acronym>MIME</acronym> encoded.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-open-pgp">
+ <glossterm>OpenPGP/<acronym>MIME</acronym></glossterm>
+ <glossdef><para>OpenPGP/<acronym>MIME</acronym> refers to an encryption convention for <glossterm
+ linkend="gloss-acro-mime"><acronym>MIME</acronym></glossterm> encoded email messages. A special set
+ of <acronym>MIME</acronym> headers are wrapped around the PGP signature, allowing an email client
+ program to conceal the signature when the message is displayed.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-group">
+ <glossterm>Open-Xchange Groupware Server</glossterm>
+ <glossdef><para>Open-Xchange AG is a corporation headquartered in Cologne, Germany that
+ provides both proprietary and open source software tools to facilitate collaboration among
+ groups of people who share data, messages, and calendaring / scheduling resources via the
+ internet. <glossterm linkend="gloss-ews">EWS</glossterm> and <glossterm
+ linkend="gloss-kolab">Kolab</glossterm> provide similar software packages.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-pcs">
+ <glossterm><acronym>PCS</acronym></glossterm>
+ <glossdef><para><acronym>PCS</acronym> stands for Personal Communication Service, which is basically
+ a cell phone with some extra functionality built in. <acronym>PCS</acronym> phones operate on a
+ higher frequency band than traditional cell phones, which implies that they can provide more
+ bandwidth than older cell phones.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-pgp">
+ <glossterm><acronym>PGP</acronym></glossterm>
+ <glossdef><para><acronym>PGP</acronym> stands for Pretty Good Privacy, a data-encryption program
+ that was released by Philip Zimmerman in 1991. Most email encryption software in use today employs
+ some variant of PGP to encrypt, decrypt, and cryptographically sign messages.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-pim">
+ <glossterm>&PIM;</glossterm>
+ <glossdef><para>&kde;'s Personal Information Management system, a suite of programs
+ to help you manage your contacts and your schedule. &PIM; includes &kontact;,
+ &kmail;, &kaddressbook;, &korganizer;, &akregator;, and
+ &akonadi;. Also used more generally to describe any system for managing personal
+ information such as names, addresses, telephone numbers, &etc;</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-qrcode">
+ <glossterm>QR Code</glossterm>
+ <glossdef><para>QR Code stands for Quick Response Code, a two-dimensional barcode used to represent
+ digital data. It was invented in Japan in 1994 for use by automobile manufacturers, but has
+ spread far and wide, so that it is ubiquitous today.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-sasl">
+ <glossterm><acronym>SASL</acronym></glossterm>
+ <glossdef><para><acronym>SASL</acronym> stands for Simple Authentication and Security Layer, a framework for
+ client authentication (passwords and usernames) and data security (encrypted connections). It supports more than
+ a dozen different protocols.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-mime">
+ <glossterm><acronym>S/MIME</acronym></glossterm>
+ <glossdef><para><acronym>S/MIME</acronym> stands for Secure / Multipurpose Internet Mail Extensions,
+ a standard cryptographic method for signing, encrypting, abd decrypting email messages. Unlike
+ <glossterm linkend="gloss-pgp"><acronym>PGP</acronym></glossterm>, which uses private keys, <acronym>S/MIME</acronym>
+ uses publicly published encryption keys certified by a Certificate Authority, such as <ulink
+ url="https://www.verisign.com/">Verisign</ulink>.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-opaque">
+ <glossterm><acronym>S/MIME</acronym> Opaque</glossterm>
+ <glossdef><para><acronym>S/MIME</acronym> Opaque stands for the <quote>opaque</quote> version of Secure /
+ Multipurpose Internet Mail Extensions. It is is similar to the <quote>S/MIME</quote> format defined above,
+ but the entire contents of the message are rolled up into a single MIME object. (Most MIME encoded
+ email messages consist of two or more separate MIME objects.)</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-sms">
+ <glossterm><acronym>SMS</acronym></glossterm>
+ <glossdef><para><acronym>SMS</acronym> stands for Short Message Service, a text-messaging service built into
+ most telephone, internet, and mobile device communication networks. It facilitates the exchange of text
+ messages that are less than 161 bytes long.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-ssl">
+ <glossterm><acronym>SSL</acronym></glossterm>
+ <glossdef><para><acronym>SSL</acronym> stands for Secure Socket Layer, a deprecated cryptographic protocol
+ that has been largely supplanted by <acronym>TLS</acronym>.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-tls">
+ <glossterm><acronym>TLS</acronym></glossterm>
+ <glossdef><para><acronym>TLS</acronym> stands for Transport Layer Security, a cryptographic protocol that is
+ widely used to secure internet communications. Its primary function is to allow a client and a server to exchange
+ enough information securely that they can set up a pair of encryption / decryption keys for use during the
+ rest of the internet session. <acronym>TLS</acronym> is the weakest link in the chain connecting a client program
+ to a secure (encrypted) internet service. It has been the target of several hacking exploits, and it has been
+ revised several times in response to those attacks.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-vcf">
+ <glossterm>.vcf</glossterm>
+ <glossdef><para>The Virtual (business) Card Format (or <filename class="extension">.vcf</filename>)
+ is a keyword-oriented data interchange format that has gone through several iterations (2.0,
+ 2.1, 3.0, &etc;) since its introduction <emphasis>ca.</emphasis> 1990. The most recent
+ version is vCard 4.0.</para></glossdef>
+ </glossentry>
+
+ <glossentry id="gloss-xmpp">
+ <glossterm><acronym>XMPP</acronym></glossterm>
+ <glossdef><para><acronym>XMPP</acronym> stands for Extensible Messaging and Presence Protocol, the
+ basic technological underpinning for the <quote>Jabber</quote> instant messaging service.</para></glossdef>
+ </glossentry>
+
+ </glossary>
+
+&docbook-reference;
+
+</book>
diff --git a/doc/input-keyboard.png b/doc/input-keyboard.png
new file mode 100644
index 00000000..030af4c2
Binary files /dev/null and b/doc/input-keyboard.png differ
diff --git a/doc/kaddressbook.png b/doc/kaddressbook.png
new file mode 100644
index 00000000..92e190ae
Binary files /dev/null and b/doc/kaddressbook.png differ
diff --git a/doc/list-add.png b/doc/list-add.png
new file mode 100644
index 00000000..1715591d
Binary files /dev/null and b/doc/list-add.png differ
diff --git a/doc/list-remove.png b/doc/list-remove.png
new file mode 100644
index 00000000..d1d164fc
Binary files /dev/null and b/doc/list-remove.png differ
diff --git a/doc/mail-message-new.png b/doc/mail-message-new.png
new file mode 100644
index 00000000..e045ed98
Binary files /dev/null and b/doc/mail-message-new.png differ
diff --git a/doc/show-menu.png b/doc/show-menu.png
new file mode 100644
index 00000000..21cae41d
Binary files /dev/null and b/doc/show-menu.png differ
diff --git a/doc/system-help.png b/doc/system-help.png
new file mode 100644
index 00000000..6d2a056e
Binary files /dev/null and b/doc/system-help.png differ
diff --git a/doc/tools-report-bug.png b/doc/tools-report-bug.png
new file mode 100644
index 00000000..53916351
Binary files /dev/null and b/doc/tools-report-bug.png differ
diff --git a/doc/user-group-new.png b/doc/user-group-new.png
new file mode 100644
index 00000000..ed9d143c
Binary files /dev/null and b/doc/user-group-new.png differ
diff --git a/doc/view-calendar-birthday.png b/doc/view-calendar-birthday.png
new file mode 100644
index 00000000..cc4880f5
Binary files /dev/null and b/doc/view-calendar-birthday.png differ
diff --git a/doc/view-refresh.png b/doc/view-refresh.png
new file mode 100644
index 00000000..993e790e
Binary files /dev/null and b/doc/view-refresh.png differ
More information about the kde-doc-english
mailing list