evolution/help/C/config-sync.xml

  <chapter id="config-sync">
     <title>Setting up your synchronization system</title> 
     <para>
        Synchronization presents you with two issues you'll need to
        address. 
        <simplelist>
          <member>
            Your computer needs to recognize and access your handheld.
            At this time, <application>Ximian Evolution</application> only
            supports Palm-OS devices like the Palm Pilot and the
            Handspring Visor.
          </member>
          <member>
           You should decide what sort of synchronization behavior you
           want.
          </member>
        </simplelist>
    </para>

    <para>
       If you haven't used a handheld device with your computer
       before, you'll need to run the GNOME <application>Control
       Center</application> by selecting
       <menuchoice><guimenu>System</guimenu><guimenuitem>Settings</guimenuitem></menuchoice>,
       and make sure that <application>Pilot Link</application> is
       properly configured. You will need to make sure that you have
       read and write permissions on the device, which is normally
       /dev/pilot. If that does not work, check /dev/ttyS0 if you have
       a serial connection, or /dev/ttyUSB0 for a USB connection. You
       can do this by becoming root and running the command:
       <userinput>chmod 777 /dev/ttyUSB0</userinput>.
    </para>
    <para>
        Once your computer and your Palm-OS device are talking happily
        to each other, select the <glossterm
        linkend="conduit">conduits</glossterm> you want under the
        <guilabel>Pilot Conduits</guilabel> section of the Control
        Center.  You may use conduits to synchronize data with several
        applications; the <application>Ximian Evolution</application>
        conduits are labeled <guilabel>EAddress</guilabel>, for the
        contacts in your addressbook, <guilabel>ECalendar</guilabel>,
        for your calendar, and <guilabel>ETodo</guilabel>, for your
        task list.
    </para>
   <para>
      To enable a conduit, click the
        <guibutton>Enable</guibutton> to enable it, and click
        <guibutton>Settings</guibutton> to change what it will do when
        activated.  Your options may vary depending on the conduit,
        but typically they will be:

        <variablelist>
         <varlistentry>
            <term>Disabled:</term>
            <listitem> 
               <para>
                  Do nothing.
               </para>
            </listitem>
          </varlistentry>

         <varlistentry>
            <term>Synchronize:</term>
            <listitem> 
               <para>
                  Copy new data from the computer to the handheld, and
                  from the handheld to the computer.  Remove items
                  that were on both systems but have been deleted on
                  one.
               </para>
            </listitem>
          </varlistentry>

         <varlistentry>
            <term>Copy From Pilot:</term>
            <listitem> 
               <para>
                  If there is any new data on the the handheld device,
                  copy it to the computer.
               </para>
            </listitem>
          </varlistentry>

         <varlistentry>
            <term>Copy To Pilot:</term>
            <listitem> 
               <para>
                 Copy new data from the computer to the handheld. 
               </para>
            </listitem>
          </varlistentry>

         <varlistentry>
            <term>Merge From Pilot:</term>
            <listitem> 
               <para>
                  Copy new data from the handheld to the computer, and
                  remove any information from the computer that has
                  been deleted on the handheld.
               </para>
            </listitem>
          </varlistentry>

         <varlistentry>
            <term>Merge To Pilot:</term>
            <listitem> 
               <para>
                  Copy new data from the computer to the handheld, and
                  remove any information from the handheld that has
                  been deleted on the computer.
               </para>
            </listitem>
          </varlistentry>
       </variablelist>
    </para>

    <para>
      Select the behavior you want for each conduit you choose to use.
      If you're not sure, go ahead and stick with
      <guilabel>Synchronize</guilabel>.  Then, put your handheld on
      its cradle and press the HotSync button.
    </para>
      <para> 
         <tip> 
	  <title>Data Loss Prevention</title> 
	  <para>
	    It's always a good idea to make a backup.  To do that,
	    make a copy of the <filename>evolution</filename>
	    directory inside your home directory.
          </para>
	</tip>
       </para>

    </chapter>