<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&kandy;"> <!ENTITY package "kdepim"> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE" > <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> <title>The &kandy; Handbook</title> <authorgroup> <author> <firstname>Cornelius</firstname> <surname>Schumacher</surname> <affiliation> <address><email>schumacher@kde.org</email></address> </affiliation> </author> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> <date>2002-02-05</date> <releaseinfo>0.03.00</releaseinfo> <abstract> <para>&kandy; is an application for synchronizing data on a mobile phone with the data on the desktop.</para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>kdepim</keyword> <keyword>kandy</keyword> <keyword>synchronizing</keyword> <keyword>phone</keyword> </keywordset> </bookinfo> <chapter id="using-kandy"> <title>Using &kandy;</title> <sect1 id="terminal"> <title>The Terminal Window</title> <para>The terminal window provides a low level interface for controlling the mobile phone via <command>AT</command> modem commands. You can type in commands in the upper middle field. The lower middle fields shows the direct response of the mobile phone. In the right side of the main window the processed output is shown.</para> <para> On the left side you have the list of available commands. You can execute them by double-clicking or pressing the <guibutton>Execute</guibutton> 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 <guibutton>Add</guibutton> button. A dialog pops up, which lets you select name and parameters for the command.</para> <para>The command list is saved to an &XML; file by selecting <guimenuitem>Save</guimenuitem> from the menu or pressing the corresponding toolbar button. You can load an existing file by selecting <guimenuitem>Open</guimenuitem> from the menu.</para> </sect1> <sect1 id="mobilegui"> <title>Mobile Interface Window</title> <para>By choosing <guimenuitem>Mobile GUI</guimenuitem> from the <guimenu>Show</guimenu> 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 two list of phonebook data, one representing the &kde; address book and the other representing the data on the phone.</para> <para>You can read the phone books by pressing the <guibutton>Read</guibutton> button right under the corresponding list. By pressing the <guibutton>Write</guibutton> button you write back the data shown in the list to the corresponding phonebook. By pressing <guibutton>Save to File</guibutton> you can store the mobile phonebook as list of comma-seperated values to disk. After loading the phonebook data using the <guibutton>Read</guibutton> buttons, you can merge the phonebooks by pressing the <guibutton>Merge</guibutton> 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.</para> <para>The <guibutton>Sync</guibutton> button combines 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.</para> </sect1> <sect1 id="configuring"> <title>Configuring &kandy;</title> <para>By selecting the entry <guimenuitem>Configure Kandy</guimenuitem> 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 <filename class="devicefile">/dev/ttyS0</filename> for the first and <filename class="devicefile">/dev/ttyS1</filename> for the second serial interface of your computer. You can also set which windows are opened per default when starting &kandy;.</para> </sect1> </chapter> <chapter id="menu-ref"> <title>Menu Reference</title> <sect1> <title><guimenu>File</guimenu> menu</title> <variablelist> <varlistentry> <term> <menuchoice> <shortcut> <keycombo action="simul"> &Ctrl;<keycap>Q</keycap> </keycombo> </shortcut> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice> </term> <listitem> <para><action>Exit</action> &kandy;.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="show-menu"> <title><guimenu>Show</guimenu> Menu</title> <variablelist> <varlistentry> <term><menuchoice> <guimenu>Show</guimenu> <guimenuitem>Terminal</guimenuitem> </menuchoice> </term> <listitem> <para><action>Open the terminal window</action>, where you can interact with your phone via <command>AT</command> commands.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="modem-menu"> <title><guimenu>Modem</guimenu> menu</title> <variablelist> <varlistentry> <term> <menuchoice> <guimenu>Modem</guimenu> <guimenuitem>Connect</guimenuitem> </menuchoice> </term> <listitem> <para><action>Connect to your phone.</action></para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <guimenu>Modem</guimenu> <guimenuitem>Disconnect</guimenuitem> </menuchoice> </term> <listitem> <para><action>Disconnect from your phone.</action></para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="settings-menu"> <title><guimenu>Settings</guimenu> menu</title> <variablelist> <varlistentry> <term> <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Show Toolbar</guimenuitem> </menuchoice> </term> <listitem> <para><action>Toggle on or off the display of the toolbar</action></para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <guimenu>Settings</guimenu> <guimenu>Show Statusbar</guimenu> </menuchoice> </term> <listitem> <para><action>Toggle on or off the display of the statusbar.</action></para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure Shortcuts...</guimenuitem> </menuchoice> </term> <listitem> <para><action>Open a standard dialog to modify shortcut keybindings.</action></para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure Toolbars...</guimenuitem> </menuchoice> </term> <listitem> <para><action>Open a standard dialog to modify the icons on the toolbar.</action></para> </listitem> </varlistentry> <varlistentry> <term> <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure Kandy...</guimenuitem> </menuchoice> </term> <listitem> <para><action>Opens a dialog where you can customize the application.</action>. This is described further in the section <xref linkend="configuring"/>.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="help-menu"> <title><guimenu>Help</guimenu> menu</title> &help.menu.documentation; </sect1> </chapter> <chapter id="credits"> <title>Credits and Licenses</title> <para>&kandy; copyright 2001 Cornelius Schumacher <email>schumacher@kde.org</email>.</para> <para>Documentation by Cornelius Schumacher, with additions by Lauri Watts <email>lauri@kde.org</email>.</para> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> &underGPL; &underFDL; </chapter> <appendix id="installation"> <title>Installation</title> <sect1 id="getting-kandy"> <title>How to obtain &kandy;</title> &install.intro.documentation; </sect1> <sect1 id="kandy-requirements"> <title>Requirements</title> <para>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.</para> <para>The &kaddressbook; is part of the kdebase package. This can also be found at the same location as the kdepim package.</para> </sect1> <sect1 id="compilation"> <title>Compilation and Installation</title> &install.compile.documentation; <para>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 <ulink url="http://www.kde.org/mailinglists.html">&kde; mailing lists </ulink> or from the Usenet newsgroup: comp.windows.x.kde.</para> </sect1> </appendix> <appendix id="developer-info"> <title>Developer Information</title> <sect1 id="dcop"> <title><acronym>DCOP</acronym> Interface</title> <para>&kandy; provides an <acronym>DCOP</acronym> interface <interfacename>KandyIface</interfacename> with the following functions: <function>syncPhonebook()</function> syncs the mobile phone book book with the &kde; address book. This is equivalent to pressing the <guibutton>Sync</guibutton> button in the Mobile Interface Window. <function>exit()</function> closes &kandy;.</para> </sect1> </appendix> </book> <!-- Local Variables: mode: sgml sgml-minimize-attributes:nil sgml-general-insert-case:lower sgml-indent-step:0 sgml-indent-data:nil End: // vim:ts=2:sw=2:tw=78:noet -->