From 460c52653ab0dcca6f19a4f492ed2c5e4e963ab0 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kandy/index.docbook | 348 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 348 insertions(+) create mode 100644 doc/kandy/index.docbook (limited to 'doc/kandy/index.docbook') diff --git a/doc/kandy/index.docbook b/doc/kandy/index.docbook new file mode 100644 index 000000000..c1a952a33 --- /dev/null +++ b/doc/kandy/index.docbook @@ -0,0 +1,348 @@ + + + + + +]> + + + +The &kandy; Handbook + + +Cornelius +Schumacher + +
schumacher@kde.org
+ + + + +2002-02-05 +0.03.00 + +&kandy; is an application for synchronizing the data on a mobile phone +with the data on the desktop. + + +KDE +kdepim +kandy +synchronizing +phone + + + + +Using &kandy; + + +The Terminal Window + +The terminal window provides a low-level interface for controlling +the mobile phone via AT modem commands. You can type +in commands in the upper middle field: the lower-middle fields show +the direct response of the mobile phone; the right side of the main +window shows the processed output. + + On the left side you have the list of available commands; you +can execute them by double-clicking on them or by pressing the +Execute button. The modem response output +fields show what happens. If you have typed in a new command you can +add it to the list of available commands by pressing the +Add button; a dialog will pop up to allow you +select a name and parameters for the command. + +The command list is saved to an &XML; file by selecting +Save from the menu or by pressing the +corresponding toolbar button. You can load an existing file by selecting +Open from the menu. + + + + +Mobile Interface Window + +By choosing Mobile GUI from the +Show menu of the terminal window you open the +Interface Window for your mobile phone. This shows a comprehensive view +of the status and data present on the phone including the +phonebook. There are twos list of phonebook data: one representing the +&kde; address book; the other representing the data on the +phone. + +You can read the phone books by pressing the +Read button right under the corresponding +list. By pressing the Write button you write back +the data shown in the list to the corresponding phonebook. By pressing +Save to File you can store the mobile phonebook +as list of comma-separated values to disk. After loading the phonebook +data using the Read buttons you can merge the +phonebooks by pressing the Merge button: this +will put data only present in one of the phonebooks into the other and +vice versa; if conflicts occur during this process, a dialog pops +up. + +The Sync button performs all the actions +needed for syncing the phonebooks. It reads the data from the &kde; +addressbook and the mobile phone, does the merge and writes it +back. + + + + +Configuring &kandy; + +By selecting the entry Configure Kandy +from the menu you get the preferences dialog of &kandy;. You can set the +name of the serial device where your mobile is connected in this +dialog; examples for the name of the serial device under &Linux; are +/dev/ttyS0 for the first and +/dev/ttyS1 for the second serial +interface of your computer. You can also set which windows are opened +by default when starting &kandy;. + + + + + + +Menu Reference + + +<guimenu>File</guimenu> menu + + + + + + + +&Ctrl;Q + + +File +Quit + + + +Exit &kandy;. + + + + + + + +<guimenu>Show</guimenu> Menu + + + + +Show +Terminal + + + +Open the terminal window, where you can interact +with your phone via AT commands. + + + + + + + +<guimenu>Modem</guimenu> menu + + + + + +Modem +Connect + + + +Connect to your phone. + + + + + + +Modem +Disconnect + + + +Disconnect from your phone. + + + + + + + +<guimenu>Settings</guimenu> menu + + + + + +Settings +Show Toolbar + + + +Toggle whether the toolbar should be displayed. + + + + + + +Settings +Show Statusbar + + + +Toggle whether the statusbar should be displayed. + + + + + + +Settings +Configure Shortcuts... + + + +Open a standard dialog to modify shortcut +keybindings. + + + + + + +Settings +Configure Toolbars... + + + +Open a standard dialog to modify the icons on the +toolbar. + + + + + + +Settings +Configure Kandy... + + + +Opens a dialog where you can customize the +application.; this is described further in the section. + + + + + + + +<guimenu>Help</guimenu> menu + +&help.menu.documentation; + + + + + + +Credits and Licenses + +&kandy; copyright 2001 Cornelius Schumacher +schumacher@kde.org. + +Documentation by Cornelius Schumacher, with additions by Lauri +Watts lauri@kde.org. + + + +&underGPL; +&underFDL; + + + + +Installation + + +How to obtain &kandy; + +&install.intro.documentation; + + + + +Requirements + +You will need to have the kdelibs package installed in order to +successfully compile the kdepim package that contains &kandy;. The +kdelibs package may be found at the same location as the kdepim +package. + +The &kaddressbook; is part of the kdebase package. This can also +be found at the same location as the kdepim package. + + + + +Compilation and Installation + +&install.compile.documentation; + +Compiling and installing the required kdelibs package follows the +same process. If you encounter any problems compiling or installing +&kandy;, help may be obtained from the &kde; mailing lists +or from the Usenet newsgroup: comp.windows.x.kde. + + + + +Developer Information + + +<acronym>DCOP</acronym> Interface + +&kandy; provides a DCOP interface +KandyIface with the following functions: +syncPhonebook() syncs the mobile phone book book +with the &kde; address book. This is equivalent to pressing the +Sync button in the Mobile Interface +Window. exit() closes &kandy;. + + + + + + + + -- cgit v1.2.1