diff --git a/CMakeLists.txt b/CMakeLists.txt --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -100,3 +100,6 @@ 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 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 GIT binary patch literal 0 Hc$@ + + + + + + + David + C. + Bryant +
davidbryant@gvtc.com
 + + + + + + + + 2019 + David C. Bryant + + +&CCBYSA4Notice; + +2019-08-26 +5.10.3 (Applications 18.12.3) + + + &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. + + + + + + KDE + KAddressBook + kdepim + Email + + + + +&kaddressbook; Advanced Features Reference Section + + + + + + + +The New Group Dialog + + When you invoke the + New Group function, a dialog will begin, as shown below. + + + + A screenshot of &kaddressbook;'s New Group dialog. + + + + + + A screenshot of &kaddressbook;'s New Group dialog. + + + &kaddressbook;'s New Group dialog after choosing the FileNew  +  > + New Group function. + + + + + +   + + Use the Add To: drop-down box to choose the address book to which the new group should be added. Use the + Name field to give the new group a name. Enter e-mail addresses, or portions of email addresses, in the blue + + 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 +  ✔ OK  button to add this group to your address book. If you want to delete a name from + the list, click the + 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 Edit menu, or the Edit Contact button on the toolbar, to open a substantially + similar dialog that will let you make the desired changes. + + 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. + + + + A screenshot of &kmail;'s New Group dialog. + + + + + + A screenshot of &kmail;'s New Group dialog. + + + &kmail;'s New Group dialog after choosing the  Save List... +   function. + + + + + +   + + After addressing a message to a group of people, clicking the  Save List...  + 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  Save List  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. + + Click here to return to the Table of Contents for this Appendix. + + + + +The Print-Preview Dialog + + &kaddressbook;'s Print Preview function lets you tailor a hard-copy of your address book + data just about any way you want. + + + + A screenshot of &kaddressbook;'s Print Preview dialog. + + + + + + A screenshot of &kaddressbook;'s Print Preview dialog. + + + &kaddressbook;'s Print Preview dialog. You may select one or more entire + address books, or just a smattering of individual contacts. + + + + + +   + + 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 + Print Preview dialog. If you wish + to select all your contacts, or all the contacts in a particular address book, you can do it here. Click + + Next when you have made your selection. A new screen will appear. + + + + A second screenshot of &kaddressbook;'s Print Preview dialog. + + + + + + A screenshot of &kaddressbook;'s Print Preview dialog. + + + The second screen in &kaddressbook;'s Print Preview dialog. You may choose a sort field + and a sort direction (up or down). You may also choose among seven different print layouts. + + + + + +   + + 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 + + Next, you will be given a chance to tailor the color scheme to + be used. + + + + A third screenshot of &kaddressbook;'s Pint Preview dialog. + + + + + + A third screenshot of &kaddressbook;'s Print Preview dialog. + + + The third screen in &kaddressbook;'s Print Preview dialog. You may select a + color scheme here. + + + + + +   + + Here is a picture of the completed report. It is now ready for printing. + + + + A screenshot of &kaddressbook;'s Pint Preview dialog. + + + + + + A screenshot of &kaddressbook;'s Print Preview dialog. + + + &kaddressbook;'s Print Preview 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. + + + + + +   + + Click here to return to the Table of Contents for this Appendix. + + + + +The Configure LDAP Dialog + + Here is a picture of the first configuration screen that appears when you choose either the + Configure LDAP Servers... button in the File + Import   >Import from LDAP Server... + dialog or the Settings + Configure + &kaddressbook;... menu item. + + + + A screenshot of &kaddressbook;'s Configure LDAP Server dialog. + + + + + + A screenshot of &kaddressbook;'s Configure LDAP Server dialog. + + + &kaddressbook;'s Configure LDAP Server dialog after choosing the FileImport  +  >Import from LDAP Server... function and left clicking the + Configure LDAP Servers... button. + + + + + +   + + If you have already configured one or more LDAP servers, use this screen to select the servers + that should be queried when you search for a name or email address. Use the Add host... button to + add a new server to the list of available LDAP hosts. Use the Edit host... + button to reconfigure a server that's already on the list, and the Remove host button to + delete an entry you don't need any more. The Reset button can be used to undo the last Add + or Remove action performed. The Defaults 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. + +   + + When you choose either the Add host... button or the Edit host... + button, the following dialog will appear. + + + + A second screenshot of &kaddressbook;'s Configure LDAP Server dialog. + + + + + + A second screenshot of &kaddressbook;'s Configure LDAP Server dialog. + + + &kaddressbook;'s Configure LDAP Server dialog after left clicking either the + Add Host... or the Edit Host... button. + + + + + +   + + The first four fields (User:, Bind DN:, Realm:, and + Password:) will all be grayed out unless authentication is required. Obtain these credentials + from the LDAP server's administrator. Enter the appropriate URI in the Host: field. The default + values for Port:, Size limit:, &etc; will work OK for most users. You can use the + Query Server button to set up the DN: field. I have no idea what the + Filter: field is for. If you figure it out, please let me know (davidbryant AT gvtc.com). + + Use the Security section to specify the encryption method to use: No for + an unencrypted connection, TLS for Transport Layer + Security, or SSL for Secure Socket Layer. Use the + Authentication options to specify what level of authentication the server requires: + Anonymous for no name or password at all, Simple if Bind DN and + Password must be given, and SASL + (Simple Authentication and Security Layer) for the whole schmear (four data items). If SASL is + chosen, use the Query Server button to set the advanced options for this host. + +   + + Click here to return to the Table of Contents for this Appendix. + + + + +The Import CSV File Function + + When you choose the FileImport   > + Import CSV file... function, you will be presented with a dialog. + After you click the + button and choose the file to be imported, the screen will + look like this. + + + + A screenshot of &kaddressbook;'s Import CSV File dialog. + + + + + + A screenshot of &kaddressbook;'s Import CSV File dialog. + + + &kaddressbook;'s Import CSV File dialog after choosing the FileImport  +  >Import CSV file... function and selecting the file to be imported. + + + + + +   + + Use the Delimiter 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 Text quote: drop-down box. If the input file contains dates, use the Date format: + 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 + Date format: box and a handy set of formatting instructions will be displayed. If the input file is not UTF-8 encoded, + use the Text codec: drop-down box to specify the binary encoding scheme to use. If the first row of the file contains + column headers, check the Skip first row of file box to avoid importing the column headers as data. Use the + Undefined 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. + + + + A second screenshot of &kaddressbook;'s Import CSV File dialog. + + + + + + A second screenshot of &kaddressbook;'s Import CSV File dialog. + + + &kaddressbook;'s Import CSV File dialog after choosing the FileImport  +  >Import CSV file... function, selecting the file to be imported, and + beginning to define the fields to be imported. + + + + + +   + + 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 Undefined box. See the next section 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 +  ✔ OK  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. + + If you intend to import additional datasets in the same format sometime in the future, you may click the Save template... + 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 Apply template... button. + + Click here to return to the Table of Contents for this Appendix. + + + + +The Export CSV File Function + + When you invoke the FileExport  >Export + CSV file ... function, a dialog box appears. + + + + A screenshot of &kaddressbook;'s Export CSV File dialog. + + + + + + A screenshot of &kaddressbook;'s Export CSV File dialog. + + + &kaddressbook;'s Export CSV File dialog after choosing the FileExport  +  >Export CSV file ... function. + + + + + +   + + You may select all your contact data, or just a portion of it. When you press the  ✔ OK  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. + + 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 + + All fields are formatted as character class data. Dates (Birthday and Anniversary, if present) are coded as + yyyy-mm-dd (Year, Month, Day). + + Click here to return to the Table of Contents for this Appendix. + + + + + +The Change Number of Columns Function + + When you open the View menu, the following screen appears. + + + + A screenshot of &kaddressbook;'s View menu. + + + + + + A screenshot of &kaddressbook;'s View menu. + + + &kaddressbook;'s View menu after choosing the View + menu on the main Menubar. + + + + + +   + + Not happy with the hum-drum three column layout appearing above? Jazz things up a little with this minimalist approach. + + + + A screenshot of &kaddressbook;'s single panel layout. + + + + + + A screenshot of &kaddressbook;'s single panel layout. + + + &kaddressbook;'s Simple (one column) layout. Only the basic contact + data are visible. + + + + + +   + + Notice that the information about which address books exist and are in use is not visible when this Simple + layout is in effect. Only the contacts from the address books that were selected before choosing this view are displayed. + +   + + If the Simple layout does not appeal to you, you may want to try the Two columns style. + + + + A screenshot of &kaddressbook;'s double panel layout. + + + + + + A screenshot of &kaddressbook;'s double panel layout. + + + &kaddressbook;'s Two columns layout. The list of address books is + stacked on top of the alphabetized contact list. + + + + + +   + + 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. + +   + + Click here to return to the Table of Contents for this Appendix. + + + + +The Configure Shortcuts Option + + When you first select the Settings + Configure Shortcuts... + option, this is what you will see. + + + + A screenshot of &kaddressbook;'s Configure Shortcuts dialog. + + + + + + A screenshot of &kaddressbook;'s Configure Shortcuts dialog. + + + &kaddressbook;'s Configure Shortcuts dialog. Use the Search field, or the + vertical scrollbar, to locate the action for which a new keyboard shortcut is to be defined. + + + + + +   + + The &kaddressbook; actions for which keyboard shortcuts have already been defined are clearly marked in the + Shortcut column. You may either assign additional shortcuts via the Alternate, + Global, and Global Alternate 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. + +   + + When you left-click the + None button, its name will change to Input...; you can then + record the combination of keystrokes you wish to assign to the selected action. (Hover the cursor over the + None + 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 + button to + erase your selection. + + + + A second screenshot of &kaddressbook;'s Configure Shortcuts dialog. + + + + + + A second screenshot of &kaddressbook;'s Configure Shortcuts dialog. + + + &kaddressbook;'s Configure Shortcuts dialog after a new keyboard shortcut has + been entered, but before the new configuration has been saved. + + + + + +   + + Click the  ✔ OK  button to save your changes. Click on +  ⦸ Cancel  to exit without saving your changes. Click + + Defaults to restore &kaddressbook;'s default set of + keyboard shortcuts. Choose  Manage Schemes >>  to integrate + your custom assignments into a larger scheme of shortcut assignments; see the Customizing KDE + Software chapter in the Fundamentals handbook for more details. + + You may select the Print button to produce a hard-copy version + of the keyboard shortcut assignments. Here is a sample from the printed table. + + + + A screenshot of &kaddressbook;'s Print output. + + + + + + A screenshot of &kaddressbook;'s Print output. + + + An excerpt from &kaddressbook;'s printed list of keyboard shortcuts. + + + + + +   + + Click here to return to the Table of Contents for this Appendix. + + + + +The Configure Toolbars Option + + Here is a picture of the screen that appears when you click on the Settings + + Configure Toolbars... menu item. + + + + A screenshot of &kaddressbook;'s Configure Toolbars dialog. + + + + + + A screenshot of &kaddressbook;'s Configure Toolbars dialog. + + + &kaddressbook;'s Configure Toolbars 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. + + + + + +   + + Use either one of the Filter 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 + + 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 + button. The selected item will be removed from the Toolbar. + + 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 Change Icon... 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 + + Change Text... button. + + Use the + Defaults button to restore the default Toolbar settings. Choose OK to + save your changes and exit the dialog, Apply to apply your changes while keeping the dialog open, or + Cancel to exit the dialog without saving your changes. (See the Customizing KDE Software + chapter in the Fundamentals handbook for a more detailed explanation of this procedure.) + +   + + Click here to return to the Table of Contents for this Appendix. + + + + +The Configure &kaddressbook; Option + + When the SettingsConfigure &kaddressbook;... option is selected, this + screen will appear. + + + + A screenshot of &kaddressbook;'s Configure &kaddressbook; dialog. + + + + + + A screenshot of &kaddressbook;'s Configure &kaddressbook; dialog. + + + &kaddressbook;'s Configure Contact Actions dialog. These features are still + experimental, and not yet entirely operational. + + + + + +   + + 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 Show Address, Dial Phone + Number, or Send SMS, but there isn't yet any software to do anything with the options you + choose. + +   + + The next option, LDAP Server Settings, is the same dialog that is documented in the preceding + section entitled The Configure LDAP Dialog. + + + + A second screenshot of &kaddressbook;'s Configure &kaddressbook; dialog. + + + + + + A second screenshot of &kaddressbook;'s Configure &kaddressbook; dialog. + + + &kaddressbook;'s LDAP Server Settings dialog. This dialog, and its child, are documented + in a preceding section of this appendix. + + + + + +   + + The final set of options for configuring &kaddressbook; appears when you select Plugins. + + + + A third screenshot of &kaddressbook;'s Configure &kaddressbook; dialog. + + + + + + A third screenshot of &kaddressbook;'s Configure &kaddressbook; dialog. + + + &kaddressbook;'s Plugins dialog. There are ten plugins all together. Seven of them + have been activated by default, as shown above. + + + + + +   + + The actions supported by the seven default Plugins are documented in preceding sections of this + manual. The Import Export GMX and + Import/Export LDIF actions will appear + as part of the File menu when activated. The Check Gravatar item will appear in the Tools + menu when it is activated. Notice that &kaddressbook; must be stopped and restarted before any changes + to the Plugins will take effect. + +   + + Click here to return to the Table of Contents for this Appendix. + + + + +Credits and Licenses + + + &kaddressbook; + + + + Copyright © 2007–2019 KAddressBook authors montel@kde.org + + + + Documentation Copyright © 2019 David C. Bryant davidbryant@gvtc.com + + + + + + + &underCCBYSA4; + + Click here to return to the Table of Contents for this Appendix. + + + + diff --git a/doc/document-edit.png b/doc/document-edit.png new file mode 100644 index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 GIT binary patch literal 0 Hc$@ + + + + ]> + + + + + +The &kaddressbook; Handbook + + + + + David + C. + Bryant +
davidbryant@gvtc.com
 + + + + + + + + 2019 + David C. Bryant + + +&CCBYSA4Notice; + +2019-07-20 +5.10.3 (Applications 18.12.3) + + + &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. + + + + + + KDE + KAddressBook + kdepim + Email + + + + + +Introduction + + + &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! + + + + A screenshot of &kaddressbook;'s primary &GUI; interface + + + + + + A screenshot of &kaddressbook;'s primary &GUI; interface + + + &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. + + + + +   + + + &kaddressbook; has been integrated into the structure of &kmail;, + 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. + + + + &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 .csv + (Comma Separated Values), .ldif + (LDAP Data Interchange Format), and + .vcf + (Virtual business Card Format) record formats. + + + + + + +Getting Started + + + 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 thePersonal Contacts address book is present by default. + + + + A screenshot of &kaddressbook;'s empty &GUI; interface + + + + + + A screenshot of &kaddressbook;'s empty &GUI; interface + + + &kaddressbook;'s empty &GUI; interface, before any extra address books + have been created. The Personal Contacts address book is present when + &kaddressbook; is first installed. + + + + +   + + + How to Add a New Address Book + + + + + Open &kaddressbook;'s Add Address Book dialog with the File + New  >Add Address Book... + option. A dialog box will appear. + + + + + A screenshot of &kaddressbook;'s Add Address Book dialog + + + + + + A screenshot of &kaddressbook;'s Add Address Book dialog + + + &kaddressbook;'s Add Address Book dialog. + Five cloud services are supported, plus three local storage options. + + + + +   + + + + Choose one of the options that appear in the dialog. Several of these options + link to data collections residing in the cloud: DAV + groupware (Distributed Authoring and Versioning, RFC4918), Google Contacts (your gmail.com + account), Kolab  groupware server (collaboration + via &IMAP;), &Microsoft; Exchange Server + EWS  (Exchange Web Services, on servers running MS software), + and Open-Xchange  Groupware  Server   (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. + + + 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 (.vcf, + or Virtual Card Format), the only difference being in which particular directory the data + are saved. The Personal Contacts and vCard Directory options + create a separate file for each named contact you save; the vCard File option + puts all the data into one file. It's probably easiest to start with the pre-defined + Personal Contacts address book. You will not need more address books + unless you have extensive contact lists you would like to keep separate. + + + + Once you have made your selection, click on OK. If you have selected a cloud-based service a brief dialog will ensue, + to establish communications between &akonadi; + (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. + + + + + A screenshot of &kaddressbook;'s link-to-gmail dialog + + + + + + A screenshot of &kaddressbook;'s link-to-gmail dialog + + + &kaddressbook;'s link-to-gmail dialog. Begin by clicking Add. A new dialog will appear. + Once your credentials have been accepted, this screen will reappear, and you will click +   ✔ OK . If you would like &kaddressbook; to refresh the + locally cached copy of your contact list automatically, do it here, before you click +   ✔ OK . + + + + + + + + A second screenshot of &kaddressbook;'s link-to-gmail dialog + + + + + + A second screenshot of &kaddressbook;'s link-to-gmail dialog + + + Another picture of &kaddressbook;'s link-to-gmail dialog. Enter your + gmail.com address and click  Next . You will be asked to + enter your gmail password. + + + + + + + + A third screenshot of &kaddressbook;'s link-to-gmail dialog + + + + + + A third screenshot of &kaddressbook;'s link-to-gmail dialog + + + 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  Allow , then +  ✔ OK  in the  Add  dialog + with which you started. + + + + + +   + + + Enter your login credentials as illustrated above and say OK. Voila! Your cloud-based + contact list is now integrated into &kaddressbook;. + +   + + + + The &kaddressbook; window after a gmail.com account has been added. + + + + + + The &kaddressbook; window after a gmail.com account has been added. + + + 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. + + + + + +   + + + 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. + + +   + + + + + If you selected one of the local address book options in + step 2 above, a different + dialog will ensue. + + + + A screenshot of &kaddressbook;'s Personal Contacts dialog. + + + + + + A screenshot of &kaddressbook;'s Personal Contacts dialog. + + + &kaddressbook;'s Personal Contacts 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. + + + + + +   + + + Make any modifications you deem necessary in the Personal Contacts dialog, + then click  ✔ OK . A new address book will appear in the main + &kaddressbook; interface window, as shown below. + + + + + A screenshot of &kaddressbook;'s main window with an empty Personal Contacts address book. + + + + + + A screenshot of &kaddressbook;'s main window with an empty Personal Contacts address book. + + + &kaddressbook;'s main window after the Personal Contacts address book has been re-created. + + + + + +   + + + + + + + How to Add a New Contact + + + + + Open &kaddressbook;'s New Contact dialog by clicking the  + New Contact  + button on the Toolbar. A dialog box will appear. + + + + A screenshot of &kaddressbook;'s New Contact dialog. + + + + + + A screenshot of &kaddressbook;'s New Contact dialog. + + + &kaddressbook;'s New Contact dialog after clicking the +  + New Contact  button on the Toolbar. + + + + + +   + + + + + As you can see from the preceding screenshot, the New Contact dialog allows one + to enter several different data items. Additional data may be entered via the Location, + Business, Personal, Notes, Custom Fields, + and Crypto Settings sub-dialogs, as explained more fully in chapter 4, + below. For now, let's concentrate on adding the Contact data items appearing in the preceding illustration. + + + + If you have created more than one address book, use the drop-down list labeled Add to: + 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 Name, and key in his or her email address in the input field + labeled  Email. If you want to specify special formatting options for this contact's + name data, click the  ...  button to the right of the Name + input field and follow the prompts. If you wish to add more email addresses for this person, click the +  +  button to the right of the Email input field and another + Email input field will be generated. To delete an Email address, click the associated +  −  button. + + + + + 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 chapter 4. You may also use the Show messages ... + and Allow remote content ... options to fine-tune the way &kmail; handles email you receive + from each contact. Seechapter 3 for a more + complete explanation. + + + + + + + + + + +Integration With Other KDE Programs + + + Integration Overview -- &kmail; + + + 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. + + + + Starting &kaddressbook; from &kmail;'s Tools Menu + + + + A screenshot of &kmail;'s ToolsAddress Book option. + + + + + + A screenshot of &kmail;'s ToolsAddress Book option. + + + Launching &kaddressbook; from &kmail;'s ToolsAddress Book menu choice. + + + + + +   + + 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 Tools + Address Book + , and the &kaddressbook; application will be launched automatically, allowing quick access to the contact + data you want to view or modify. + +   + + + + + Querying &kaddressbook; from &kmail;'s Message Composition Window + + + + A screenshot of auto completion from inside &kmail;'s message composition window. + + + + + + A screenshot of auto completion from inside &kmail;'s message composition window. + + + Using &kaddressbook;'s auto completion feature from inside &kmail;'s message composition window. + + + + + +   + + 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. + +   + + + + + &kmail;'s Recipient Selection Dialog + + + + A screenshot of the recipient selection dialog inside &kmail;'s message composition window. + + + + + + A screenshot of the recipient selection dialog inside &kmail;'s message composition window. + + + Selecting multiple addressees with the recipient selection dialog inside  &kmail;'s message composition window. + + + + + +   + + 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 +  Select ...  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 Search: box), + select the recipient you want, and left click   Add as To , +  Add as CC , or  Add as BCC  to add this person + to the list of email recipients for your new message. Choose  Add as Reply-To  + to insert this address into your message as a Reply To tag. + +   + + + + + &kmail;'s New Contact Creation Interface + + + + A screenshot of the new contact creation interface inside &kmail;'s message viewing window. + + + + + + A screenshot of the new contact creation interface inside &kmail;'s message viewing window. + + + Invoking the new contact creation dialog from &kmail;'s message viewing window. + + + + + +   + 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  + Add to Address Book  + 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  + Add to Existing Contact  + instead -- this enters a dialog that will direct  &kaddressbook; to the spot where you want to insert the new email address. +   + + + + A screenshot of the ensuing new contact creation dialog. + + + + + + A screenshot of the ensuing new contact creation dialog. + + + Choosing the address book in which the new contact will be created. + + + + + +   + &kmail; will ask you to choose the address book to which the new contact should be added. +   + + + + Another screenshot of the ensuing new contact creation dialog. + + + + + + Another screenshot of the ensuing new contact creation dialog. + + + Deciding if you would like to edit the newly created contact now, or later. + + + + + +   + &kmail; will also ask you if you wish to edit the new contact +  that has just been added. Say  ✔ Yes  if you want to add more data to the + new entry right away. +   + + + + + + + &kaddressbook;'s Interface with &korganizer; + + &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. +   + + + + A screenshot of &korganizer;'s attendees tab. + + + + + + A screenshot of &korganizer;'s attendees tab. + + + Adding a single attendee to a scheduled meeting in  &korganizer;. + + + + + +   + The first interface is just like the auto completion + feature 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. +   + + + + A screenshot of &korganizer;'s attendees tab. + + + + + + &korganizer;'s attendees tab. + + + Adding multiple attendees to a scheduled meeting in  &korganizer;. + + + + + +   + The second interface is just like the recipient selection + dialog  provided by &kmail;: when you left click the  Select Attendees ...  + button, a searchable list of the contacts in all your address books will appear, as the preceding screenshot shows. + + + + + + +Adding or Editing Contact Data + + + The Basics + + When you first click on the Add Contact   button on &kaddressbook;'s + Toolbar, this screen will appear. (If you click on Edit Contact  , + a similar screen appears, the only difference being that the drop-down box labeled Add to: will + not appear as part of the Edit dialog. That is why both functions are covered in this chapter: + they're practically identical.) + + + + A screenshot of &kaddressbook;'s New Contact dialog. + + + + + + A screenshot of &kaddressbook;'s New Contact dialog. + + + &kaddressbook;'s Add Contact dialog after clicking the + + Add Contact   button on the Toolbar. + + + + + +   + + + The Contact Tab + + We have already seen (in How to Add a New Contact ) + 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 Contact tab in + the + Add Contact   dialog. + + + + PhoneYou may associate one or more telephone numbers with + this person. Use the  +  and  −  + buttons to add or delete phone number fields. The +  Home + Drop Down Box allows you to identify fifteen categories of phone numbers (Home, Work, Mobile, Car, + ISDN, PCS, &etc;) + + + MessagingYou may associate one or more Instant Messaging + service identities with this person. Use the  +  and +  −  buttons to add or delete messaging service fields. The +  Select ... + Drop Down Box permits you to identify thirteen categories of IM services: AIM, + Facebook, Gadu-Gadu, Google Talk, GroupWise, + ICQ, IRC, + Jabber, Meanwhile, + SMS, 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.) + + + WebYou may associate one or more web site URLs with this + person. Use the  +  and  −  + buttons to add or delete Web address fields. The  Select ... + + Drop Down Box allows you to identify three different kinds of Web addresses: Home, Work, and Other. + + + TagsYou may associate one or more Tags of your own devising with this + person. Use the  ...  button to enter the Tag creation and configuration dialog + illustrated below. + + + + + + + &kaddressbook;'s Tags dialog. + + + + + + &kaddressbook;'s Tags dialog. + + + &kaddressbook;'s Manage Tags dialog after clicking the +  ...  button next to Tags. + + + + + +   + + + Tags (continued)Use the  Create new tag  + 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 +  ✔ OK  button to add the selected tags to this contact. + + + Blog FeedUse this field to record the URL associated with this + contact's web log, or blog. + + + Show messages ...Use this Drop Down Box to override the corresponding message + display option in &kmail;'s  Privacy & Security  configuration menu. Choose + Default to leave it up to &kmail;. Choose Plain Text or HTML if you + want to override &kmail;'s default behavior when you receive a message from this person. + + + Allow remote content ...Select this option if you want to override the + corresponding message display option in &kmail;'s  Privacy & Security  + configuration menu when you receive a message from this person. + + +  ✔ OK Select this option to save the + changes you have made. This button performs the same function in all seven tabs appearing in the + Add Contact   dialog. + + +  ⦸ Cancel Select this option to leave + the + Add Contact   dialog without saving your changes. This button performs + the same function in all seven tabs appearing in the Add Contact dialog. + + + +   + + + + + The Location Tab + + Use the data input fields in the Location tab shown below to associate one or more snail-mail + addresses with this person. + + + + &kaddressbook;'s Location tab. + + + + + + &kaddressbook;'s Location tab. + + + &kaddressbook;'s Location tab, part of the + Add Contact dialog. + + + + + +   + + + (unlabeled) Drop Down BoxUse this list of categories to describe each + mailing address for this contact. Available options include  Home, Work, + Postal, &etc; + + + Street / Post Office Box / Postal Code / Locality / RegionUse 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. + + + CountryUse this Drop Down Box to select a country, from + Afghanistan to Zimbabwe. + + + This is the preferred addressCheck this box to designate the + preferred, or default, mailing address. + + +  Add Address 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. + + + Icon + in the large display window + Left click this icon to edit the associated address data. + + + Icon + in the large display window + Left click this icon to delete the associated address data. + + + +   + + + + The Business, Personal, and Notes Tabs + + The next three tabs in the Add Contact dialog are even simpler than + the Location 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. + + + + &kaddressbook;'s Business tab. + + + + + + &kaddressbook;'s Business tab. + + + &kaddressbook;'s Business tab, part of the + Add Contact dialog. + + + + + +   + + The Business 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 + + button will open a file search dialog, making it easy to associate a filename with this person's + Free/Busy schedule, if you wish. + + Notice that you should enter your business associate's phone as a telephone number under the + Contact tab. Similarly, his office address is entered + via the Location tab, as described in the preceding section. + +   + + + &kaddressbook;'s Personal tab. + + + + + + &kaddressbook;'s Personal tab. + + + &kaddressbook;'s Personal tab, part of the + Add Contact dialog. + + + + + +   + + 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 (⪚, +  ) + to enter his date of birth, or his wedding anniversary. + + +   + + + &kaddressbook;'s Notes tab. + + + + + + &kaddressbook;'s Notes tab. + + + &kaddressbook;'s Notes tab, part of the + Add Contact dialog. + + + + + +   + + The Notes tab provides a totally free-form input area in which + you may enter any data you want to associate with this person. + + + + + + + The Tricky Stuff + + &kaddressbook; provides a couple of more complex data storage features, in addition to the simple + functions described in the preceding section. + + + The Custom Fields Tab + + 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 Custom Fields dialog + shown below to define and populate as many additional data fields as you can possibly use. + + + + &kaddressbook;'s Custom Fields tab. + + + + + + &kaddressbook;'s Custom Fields tab. + + + &kaddressbook;'s Custom Fields tab, part of the + Add Contact dialog. + + + + + +   + + 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. + +   + + + + + The Crypto Settings Tab + + 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. + + + + &kaddressbook;'s Crypto Settings tab. + + + + + + &kaddressbook;'s Crypto Settings tab. + + + &kaddressbook;'s Crypto Settings tab, part of the + Add Contact dialog. + + + + + +   + + + Allowed ProtocolsChoose which mode of encryption you wish to use when + sending a message to this person: Inline OpenPGP, OpenPGP/MIME, S/MIME + , or S/MIME Opaque. + + + Preferred OpenPGP Encryption Key:Use the  Change...  + button to select from a list of available OpenPGP keys, if you have chosen OpenPGP + encryption. Use the + button to clear a previously selected key. + + + Preferred S/MIME Encryption Certificate: + Use the  Change...  button to select from a list of available certificates, + if you are using a verified key. Use the + button to clear a previously selected key. + + + Message Preference / Sign:Use this drop-down box to specify when messages addressed to + this person should bear your cryptographic signature: Never / Always / If Possible / Ask. + + + Message Preference / Encrypt: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. + + + + + + + + + + + +Command Reference + + + The Menu Bar + + Here is a rundown of the seven menus appearing on &kaddressbook;'s Menubar. + + + + The File Menu + + + + A screenshot of &kaddressbook;'s File menu. + + + + + + A screenshot of &kaddressbook;'s File menu. + + + &kaddressbook;'s File menu after clicking the + File button on the Menubar. + + + + + +   + + The File menu lets you access six main functions, three of which have several options. + +   + + + + &Ctrl;NFile + New  >New Contact + This has exactly the same effect as clicking the   + New Contact  button + on the Toolbar. See chapter 2 above for complete details. + + + + &Ctrl;GFile + New  >New Group + Opens a dialog in which you may define a new group, or mailing list. See  the appendix + for a detailed explanation of this function. + + + + FileNew  > + Add Address Book + This opens the Add Address Book dialog, which is fully documented in +  chapter 2 above. + + + + FileImport  >Import from LDAP + server ... + This function allows you to import data from an LDAP server. The server must be configured before + you can use this function. See the appendix for full details. + + + + FileImport  >Import CSV file ... + This function allows you to import contact data from a comma separated values (csv) 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 the + appendix for a more detailed explanation. + + + + FileImport  >Import vCard ... + This function facilitates the importation of vcf, or vCard, data. All three versions of vCard are supported. + You can learn more about the vCard formats at this web site. + + + + FileExport  >Export CSV file ... + This function allows you to export selected contact data as a Comma Separated Values (csv) file. There are 47 + fields in the output record. Please refer to the appendix for a list of those data fields. + + + + FileExport  >Export vCard 4.0 ... + This function allows you to export selected contact data as a file in vCard 4.0 format. See + this Wikipedia article for more information. + + + + FileExport  >Export vCard 3.0 ... + This function allows you to export selected contact data as a file in vCard 3.0 format. This + format is similar to vCard 4.0 format. + + + + FileExport  >Export vCard 2.1 ... + This function allows you to export selected contact data as a file in vCard 2.1 format. This + format is similar to vCard 3.0 format. + + + + &Ctrl;PFile + + Print + Opens a printer selection dialog. Use the + Print Preview + dialog below to set up the range of names and the print format before you select this function. + + + + File + Print Preview + 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  the appendix for further details. + + + + &Ctrl;QFile + + Quit + Closes the &kaddressbook; application. + + + + +   + + + + + The Edit Menu + + + + A screenshot of &kaddressbook;'s Edit menu. + + + + + + A screenshot of &kaddressbook;'s Edit menu. + + + &kaddressbook;'s Edit menu after clicking the + Edit button on the Menubar. + + + + + +   + + The Edit menu lets you access eight main functions, two of which have multiple options. + +   + + + + EditEdit Contact ... + This has nearly the same effect as clicking the  + New Contact  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 chapter 2 above for complete details. + + + + &Ctrl;XEdit + Cut Contact ... + Performs a Cut operation on the selected contact. A copy of this contact, in + vCard 3.0 format, is placed on the clipboard. The + Cut will be completed when you Paste this contact somewhere. + + + + EditCopy Contact ... + Places a copy of this contact on the clipboard, so you can paste it somewhere else. + + + + &Ctrl;VEdit + Paste + Pastes the cut or copied contact at the current location. This may be in the same address book you + did the Cut or Copy 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 vCard 3.0 file in your home folder). + + + + Edit + Copy Contact To   >(a variable list) + Combines the Copy and Paste operations into a single click of the left + mouse button. The list of destinations displayed depends on how many address books you have created. + + + + Edit + Move Contact To   >(a variable list) + Works just like the Copy Contact To operation described above, except that it combines + Cut and Paste into a single click of the left mouse button. + + + + ∇Edit + Delete Contact + Delete the selected contact from the current address book. + + + + EditDelete Address Book + 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 vCard + file or directory (or the hyperlink to a cloud-based service), 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. + + + + +   + + + + + The View Menu + + + + A screenshot of &kaddressbook;'s View menu. + + + + + + A screenshot of &kaddressbook;'s View menu. + + + &kaddressbook;'s View menu after clicking the + View button on the Menubar. + + + + + +   + + The View menu lets you access four main functions, and one experimental + feature which doesn't really do anything yet. + +   + + + + ViewThemes   > + This menu item doesn't really do anything. It will open a Themes dialog, + but that dialog is broken in release 5.10.3. + + + + &Ctrl;&Shift;1 + ViewSimple (one column) + Changes the default three panel layout into a single column. For more details, see +  the appendix. + + + + &Ctrl;&Shift;2 + ViewTwo columns + Changes the default three panel layout into two panels. For more details, see +  the appendix. + + + + &Ctrl;&Shift;3 + ViewThree columns + Switches back to the default three panel layout. + + + + ViewShow QR Codes + Check this box to display contact information as a QR code. Uncheck it to suppress QR codes. + + + + +   + + + + + The Action Menu + + + + A screenshot of &kaddressbook;'s Action menu. + + + + + + A screenshot of &kaddressbook;'s Action menu. + + + &kaddressbook;'s Action menu after clicking the + Action button on the Menubar. + + + + + +   + + The Action menu lets you access two data transmission functions. + +   + + + + ActionSend vCards... + This option is similar to Send an email..., 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. + + + + ActionSend an email... + 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 Send an Email...; this will open a &kmail; composition window. All + the selected contacts will be listed as To addressees. + + + + +   + + + + + The Tools Menu + + + + A screenshot of &kaddressbook;'s Tools menu. + + + + + + A screenshot of &kaddressbook;'s Tools menu. + + + &kaddressbook;'s Tools menu after clicking the + Tools button on the Menubar. + + + + + +   + + The Tools menu lets you access two data management functions. + +   + + + + ToolsMerge Contacts... + 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 merge to complete the operation. + + + + ToolsSearch Duplicate Contacts... + This tool will search one or more address books for duplicate entries, and offer you the option + of merging any duplicate records it finds. + + + +   + + + + + The Settings Menu + + + + A screenshot of &kaddressbook;'s Settings menu. + + + + + + A screenshot of &kaddressbook;'s Settings menu. + + + &kaddressbook;'s Settings menu after clicking the + Settings button on the Menubar. + + + + + +   + +   + + The Settings menu offers you five options for fine-tuning the + way &kaddressbook; operates. + +   + + + + SettingsShow Menubar + &Ctrl;M + This option allows you to show or hide the Menubar. + + + + SettingsShow Toolbar + This option allows you to show or hide the Toolbar. + + + + SettingsConfigure Shortcuts... + This option allows you to customize the keyboard shortcuts available within &kaddressbook;. + See the appendix for more details. + + + + SettingsConfigure Toolbars... + This option allows you to customize the contents of &kaddressbook;'s Toolbar. + See the appendix for more details. + + + + SettingsConfigure &kaddressbook;... + &Ctrl;&Shift;, + This option allows you to configure several advanced &kaddressbook; options. + See the appendix for more details. + + + + +   + + + + + The Help Menu + + + + A screenshot of &kaddressbook;'s Help menu. + + + + + + A screenshot of &kaddressbook;'s Help menu. + + + &kaddressbook;'s Help menu after clicking the + Help button on the Menubar. + + + + + +   + + The Help menu offers seven options. + +   + + + + Help&kaddressbook; Handbook + F1 + This option displays a copy of The &kaddressbook; Handbook via the + &khelpcenter; utility program. + + + + HelpWhat's This?&Shift; + F1 + 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. + + + + HelpReport Bug + This option opens a dialog that helps you file a bug report at bugs.kde.org, &kde;'s main bug tracking page. + + + + HelpDonate + This opens a web + page in your browser, where you may donate money to support &kde;. We accept euros, dollars, + rubles, sterling, yen, yuan, pesos, &etc; + + + + HelpSwitch Application Language + 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. + + + + HelpAbout &kaddressbook; + 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. + + + + HelpAbout &kde; + This option displays information about &kde;. Be free! + + + + + + + + + + The Tool Bar + + There are five separate tools available on &kaddressbook;'s Toolbar: New Contact, New Group, + Edit Contact, Search..., 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 + Settings menu, if you so desire.) + + + + A closeup of &kaddressbook;'s Toolbar. + + + + + + A closeup of &kaddressbook;'s Toolbar. + + + &kaddressbook;'s standard Toolbar, up close and personal. + + + + + +   + + + + + New Contact + This Toolbar button opens the Add New Contact dialog + documented in chapter 4, above. + + + + New Group + This Toolbar button opens the Add New Group dialog + documented in the appendix. + + + + Edit Contact + This Toolbar button opens the Edit Contact dialog + documented in chapter 4, above. + + + + [ Search... &Alt;Q ] + This tool searches through all the contacts in selected address books as you type. + Pressing  &Alt;+Q simply positions the cursor inside the Search... + box. Be aware that this function searches the entirety of each contact record; a search for + and may return not only Andy Brown and Andrew Jones, but also Bill + Smith (who happens to work for Brown and Root Construction Company). + + + + + + + A screenshot of &kaddressbook;'s Search function. + + + + + + A screenshot of &kaddressbook;'s Search function. + + + &kaddressbook;'s Search function in action. + + + + + +   + + + + + [ (All)  + ] + This tool performs a filtering function, based on categories. The two default categories are Untagged + and Groups. You can create new categories by associating Tags of your own devising with particular + contact records (see Add New Contact in chapter 4, above). Clicking either + button will set the selected + categories to None; the + button will reset the selection criteria to All. + + + + + + + A screenshot of &kaddressbook;'s Filter function. + + + + + + A screenshot of &kaddressbook;'s Filter function. + + + &kaddressbook;'s Filter function in action. + + + + + + + + + The Context Menus + + 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. + + + The Address Book Context Menu + + + + A screenshot of &kaddressbook;'s Address Book context menu. + + + + + + A screenshot of &kaddressbook;'s Address Book context menu. + + + &kaddressbook;'s Address Book context menu. + + + + + +   + + + + + Add Address Book Folder... + This context menu option does not perform a useful function in release 5.10.3. + + + + Delete Address Book Folder + This context menu option does not perform a useful function in release 5.10.3. + + + + Add Address Book... + This context menu option launches the Add Address Book dialog that is + documented in chapter 2, above. + + + + Delete Address Book + Choosing this context menu option will delete the selected address book. + Be careful! + + + + F5 + Update Address Book + Folder + This context menu option forces &kaddressbook; to reload the contact + data associated with the selected address book. + + + + Folder Properties... + This context menu option displays summary information about the selected + address book. + + + + Address Book Properties... + This context menu option displays summary information about the selected + address book. + + + + Serverside Subscription... + 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). + + + + +   + + + + + The List of Contacts Context Menu + + + + A screenshot of &kaddressbook;'s Contact List context menu. + + + + + + A screenshot of &kaddressbook;'s Contact List context menu. + + + &kaddressbook;'s Contact List context menu. + + + + + +   + + + + + &Ctrl;N + + New Contact + Choosing this context menu option has exactly the same effect as clicking the +  + New Contact  button on the Toolbar. See chapter 2 above for complete details. + + + + &Ctrl;G + + New Group + Choosing this context menu option opens a dialog in which you may define a new group, or mailing + list. See  the appendix for a detailed explanation. + + + + + Edit Contact ... + Choosing this context menu option has exactly the same effect as clicking the + Edit Contact... button + on the Toolbar. See chapter 2 above for complete details. + + + + Export  > + This context menu function allows you to export selected contact data in either vCard or + csv format. + + + + + Copy Contact To   > + 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. + + + + + Move Contact To   > + Works just like the Copy Contact To operation described above, except that it deletes + the source data, instead of creating an extra copy of it. + + + + &Ctrl;P + Print + Choosing this context menu item opens a printer selection dialog. Use the + Print Preview + dialog below to set up the range of names and the print format before you select this function. + + + + + Print Preview + 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  the appendix for further details. + + + + ∇Delete Contact + Delete the selected contact(s) from the current address book. + + + + +   + + + + + The Individual Contact Context Menu + + + + A screenshot of &kaddressbook;'s Individual Contact context menu. + + + + + + A screenshot of &kaddressbook;'s Individual Contact context menu. + + + &kaddressbook;'s Individual Contact context menu. + + + + + +   + + 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. + + + + + + + + + + + + + AIM + AIM 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 at this + web site. + + + + &akonadi; + 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 akonadictl --help in a console window to learn more. + + + + Cloud-based service + Any provider of data storage and data processing resources residing in some + cloud of servers one may access via the internet. + + + + .csv + A Comma Separated Values (or .csv) 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 .csv format dates back to the early days + of computing. It is still widely used, mainly because it is conceptually so simple. + + + + DAV + DAV stands for Distributed Authoring and Versioning, which exists in + several flavors, 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. + + + + DIGEST-MD5 + DIGEST-MD5 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 this Wikipedia article + to learn more about it. + + + + EWS + EWS stands for Exchange Web Services,  &Microsoft;'s set of + proprietary protocols for exchanging personal data between internet servers and end users, or clients. +   Kolab provides similar functionality. + + + + Gadu-Gadu + Gadu-Gadu (aka GG) is the most popular instant-messaging app in Poland. + + + + GMX + GMX stands for Global Mail eXchange (or, in Germany, Global Message eXchange), + a free advertising-supported email service. Visit either this web site + or this one to learn more about it. + + + + Gravatar + 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. + + + + GroupWise + 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 this web site. + + + + GSSAPI + GSSAPI stands for Generic Security Service Application Program Interface, + a sort of dictionary 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. + + + + ICQ + ICQ is not precisely an acronym: it's a pun meant to sound like I + Seek You. It is one of the original IM platforms, first coming online in 1996. The software is available + for download here. + + + + &IMAP; + IMAP 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. + + + + Inline OpenPGP + 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. + + + + IRC + IRC stands for Internet Relay Chat, an IM service that has its + roots in a Finnish predecessor of the World Wide Web called OuluBox (1988). IRC + 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 via this web site. + + + + ISDN + ISDN 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). ISDN + 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. + + + + Jabber + Jabber is an instant-messaging service that relies on the XMPP + protocol. The original Jabber web site is no longer accepting new registrations, but the + XMPP protocol is in widespread use. See this web site + for more information. + + + + &kmail; + &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. + + + + Kolab + 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.  EWS  provides similar, though + wholly proprietary, software packages. + + + + LDAP + The Lightweight Directory Access Protocol (or  ldap) is + a standard protocol, or method, for sharing some particular classes of information among the + many server computers that comprise the internet. + + + + .ldif + An LDAP + Data Interchange Format (or .ldif) file is a type + of plain text file designed for exchanging directory information among the various servers + in a distributed network. + + + + Meanwhile + Meanwhile is open source software designed to communicate with IBM's + Sametime instant + messaging software. See this web site + if you want to learn more about it. + + + + MIME + MIME 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, rich text 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 MIME encoded. + + + + OpenPGP/MIME + OpenPGP/MIME refers to an encryption convention for MIME encoded email messages. A special set + of MIME headers are wrapped around the PGP signature, allowing an email client + program to conceal the signature when the message is displayed. + + + + Open-Xchange Groupware Server + 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.  EWS  and  Kolab provide similar software packages. + + + + PCS + PCS stands for Personal Communication Service, which is basically + a cell phone with some extra functionality built in. PCS phones operate on a + higher frequency band than traditional cell phones, which implies that they can provide more + bandwidth than older cell phones. + + + + PGP + PGP 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. + + + + &PIM; + &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; + + + + QR Code + 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. + + + + SASL + SASL 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. + + + + S/MIME + S/MIME stands for Secure / Multipurpose Internet Mail Extensions, + a standard cryptographic method for signing, encrypting, abd decrypting email messages. Unlike + PGP, which uses private keys, S/MIME + uses publicly published encryption keys certified by a Certificate Authority, such as Verisign. + + + + S/MIME Opaque + S/MIME Opaque stands for the opaque version of Secure / + Multipurpose Internet Mail Extensions. It is is similar to the S/MIME 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.) + + + + SMS + SMS 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. + + + + SSL + SSL stands for Secure Socket Layer, a deprecated cryptographic protocol + that has been largely supplanted by TLS. + + + + TLS + TLS 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. TLS 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. + + + + .vcf + The Virtual (business) Card Format (or .vcf) + is a keyword-oriented data interchange format that has gone through several iterations (2.0, + 2.1, 3.0,  &etc;) since its introduction  ca. 1990. The most recent + version is vCard 4.0. + + + + XMPP + XMPP stands for Extensible Messaging and Presence Protocol, the + basic technological underpinning for the Jabber instant messaging service. + + + + +&docbook-reference; + + diff --git a/doc/input-keyboard.png b/doc/input-keyboard.png new file mode 100644 index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 GIT binary patch literal 0 Hc$@