NOTE:  This is a work in progress.  Feel free to submit documentation
       changes that will clarify anything.

INTRODUCTION

  This HOWTO covers the use of malsync within the conduit paradigm of 
  PilotManager.  It is assumed that:
  
    - you are already using PilotManager and hence a discussion of 
      its setup is not discussed, see:
        
          http://www.moshpit.org/pilotmgr/download.html

    - you are already using AvantGo via some other means and 
      hence a discussion of required pilot programs and their 
      setup are not discussed, see
      
          http://avantgo.com/setup/index.html

OVERVIEW

  The following steps need to occur:
    
	- download and patch malsync/pilot-link sources
	- compile/install the pilot-link toolset
	- compile/install malsync
	- install the malsync conduit
    
INSTRUCTIONS

  1. download sources and patch sources

  Version 1.8 of malsync contains both malsync and pilot-link.0.9.3 sources.  
  If these versions are used, a single patch file exists to completely patch 
  the distribution for use with the malsync conduit.

    # --- execute the following to download and patch sources
    mkdir /tmp/malsync-conduit
    cd /tmp/malsync-conduit
    wget http://www.etpsoft.com/malsync_src_1_8.tar.gz
    tar -zxvf malsync_src_1_8.tar.gz
    cd malsync_src
    wget http://slug.arlut.utexas.edu/~jbaughmn/pilotmgr/patches/malsync/malsync-conduit-diffs.txt
    patch -p1 < malsync-conduit-diffs.txt
    # --- 

  Otherwise, you may be interested in the separate versions and patches of each.

    pilot-link toolset       ftp://ryeham.ee.ryerson.ca/pub/PalmOS/
    malsync source           http://www.etpsoft.com/malsync.html

    patches:
      http://slug.arlut.utexas.edu/~jbaughmn/pilotmgr/patches/pilot-link/conduit-diffs.txt
      http://slug.arlut.utexas.edu/~jbaughmn/pilotmgr/patches/pilot-link/hpux10.20-diffs.txt
      http://slug.arlut.utexas.edu/~jbaughmn/pilotmgr/patches/malsync/hpux10.20-diffs.txt
      http://slug.arlut.utexas.edu/~jbaughmn/pilotmgr/patches/malsync/setbuf-diffs.txt
    
  2. compile the pilot-link toolset

  The following commands compile and test the pilot-link toolset.  If you do
  no want to install the pilot-link toolset in /usr/local, pass configure a 
  --prefix=/path/to/somewhere and edit the malsync makefile appropriately.

    # --- execute the following to compile and install pilot-link
    cd /tmp/malsync-conduit/malsync_src/vendor/pilot/pilot-link.0.9.3/
    ./configure
    make
    make test
    make install
    cd Perl5
    perl Makefile.PL
    make
    perl test.pl /dev/pilot
    make install
    # --- 

  3. compile malsync

  The following commands compile and install malsync in /usr/local/bin.  If 
  you changed the --prefix for pilot-link, don't forget to edit the
  malsync unix makefile.
  
    # --- execute the following to compile and install malsync
    cd /tmp/malsync-conduit/malsync_src/mal/client/unix/
    make
    cp -p malsync /usr/local/bin
    # ---  

  4. install the malsync conduit

  Download the latest MALSync conduit and copy MALSync.pm into 
  either your PilotManager top-level directory OR (in v1.106 or 
  newer) place the MALSync.pm file in your ~/.pilotmgr.  The 
  next time you run PilotManager, it will locate and add it to 
  your conduit list.
    
    # --- execute the following to install the conduit
    cd /tmp/malsync-conduit
    wget http://slug.arlut.utexas.edu/~jbaughmn/pilotmgr/MALSync.pm
    cp -p MALSync.pm ~/.pilotmgr
    # ---  
  
  
LINKS

  pilot-link toolset       ftp://ryeham.ee.ryerson.ca/pub/PalmOS/
  malsync source           http://www.etpsoft.com/malsync.html
  PilotManager             http://www.moshpit.org/pilotmgr/
  MALSync conduit          http://slug.arlut.utexas.edu/~jbaughmn/pilotmgr/
  AvantGo account (free)   http://avantgo.com/setup/


DOCUMENTATION

  SOURCE    http://slug.arlut.utexas.edu/~jbaughmn/pilotmgr/malsync-conduit-howto.txt
  
  AUTHOR    Jim Baughman, jbaughmn@mail.utexas.edu

  VERSION   $Id: malsync-conduit-howto.txt,v 1.1 2005/02/20 00:21:43 aaronkaplan Exp $