File	Date	Author	Commit
debian	2015-09-15	Reuben Thomas	[3510f3] Move project to GitHub
doc	2014-07-19	Reuben Thomas	[d7bfff] Restore splicing of dates into man pages
etc	2013-12-16	Reuben Thomas	[e9e517] Convert .cvsignore files to .gitignore files
lib	2014-10-15	Reuben Thomas	[7cccbd] Fix various bugs in Debian packaging
m4	2014-07-18	Reuben Thomas	[b1a6dc] Remove generated file m4/intldir.m4
ncpd	2013-12-16	Reuben Thomas	[bdc4e6] Make reasonably recent autotools happy; remove ...
plpftp	2013-12-16	Reuben Thomas	[bdc4e6] Make reasonably recent autotools happy; remove ...
plpfuse	2013-12-16	Reuben Thomas	[cff1bd] Fix a potential overrun in options parsing (tha...
plpprint	2013-12-16	Reuben Thomas	[bdc4e6] Make reasonably recent autotools happy; remove ...
po	2014-07-05	Reuben Thomas	[4c6954] Update po files
sisinstall	2013-12-16	Reuben Thomas	[bdc4e6] Make reasonably recent autotools happy; remove ...
.gitignore	2014-07-19	Reuben Thomas	[a26463] Add INSTALL to .gitignore
AUTHORS	2007-12-09	Reuben Thomas	[b3db3a] Add standard GNU files.
COPYING	1999-07-01	Fritz Elfert	[0d619e] Updated GPL and added generic INSTALL
ChangeLog	2013-12-16	Reuben Thomas	[4a929d] Change references to CVS to references to git
HISTORY	2008-03-22	Reuben Thomas	[1d80f6] Clarify history and add a little more.
Makefile.am	2014-07-26	Reuben Thomas	[719db2] Fix a missing && in Makefile.am
NEWS	2007-12-09	Reuben Thomas	[b3db3a] Add standard GNU files.
README	2015-09-15	Reuben Thomas	[3510f3] Move project to GitHub
TODO	2007-12-16	Reuben Thomas	[1fbc50] Clarify.
configure.ac	2014-10-15	Reuben Thomas	[d86a35] Remove unused variable PLP_LDFLAGS

Read Me

plptools
--------

https://github.com/rrthomas/plptools/

plptools is a suite of programs for transferring files to and from EPOC
devices, as well as backing them up, installing software, and setting the
clock. See below for build instructions and HISTORY for some history.


Building from source
--------------------

[See below for extra instructions for developers.]

To build plpfuse, the following packages are required:

  FUSE: http://fuse.sourceforge.net/
  libattr: ftp://oss.sgi.com/projects/xfs/download/

These packages come with most GNU/Linux distributions. To build plptools,
the development packages (typically ending in -dev or -devel) must be
installed. If they are not installed, plpfuse will not be built, but the
rest of plptools will still work.

plptools uses GNU autotools, so the usual sequence of commands works:

./configure
make
make install

In addition to the usual options, configure understands the following:

  --enable-debug

       builds debugging versions of the programs and libplp

  --with-serial=/dev/sometty

       sets the default serial device for ncpd. Without this option,
       ncpd tries automagically to find a serial device.

  --with-speed=baudrate

       sets the default serial speed (normally 115200 baud).

  --with-port=portnum

       sets the default port on which ncpd listens and to which plpftp
       and plpfuse connect (default 7501).

  --with-drive=drivespec

       sets the default drive for plpftp. The default "AUTO"
       triggers a drive-scan on the psion and sets the drive to the
       first drive found. If you don't want that, specify "C:" for
       example.

  --with-basedir=dirspec

       overrides the default directory for plpftp. The default is \
       which means the root directory. Note: since backslashes need to
       be doubled once for C escaping and once for shell escaping,
       this value is actually supplied as "\\\\".


Information for developers
--------------------------

The git repository can be cloned with:

git clone git://git.code.sf.net/p/plptools/git plptools

Before building:

autoreconf -i

To make a release you need woger, from: http://rrt.sc3d.org/Software/woger