** ogftp
**
** Omnigo/Unix file transfer program.
**
** Written by and Copyright 1996 Asher Hoskins, except for the sections
** from the GEOS SDK (marked).
** Modified by Marcus Groeber for use under OS/2.
**
** The author retains copyright on this implementation. Permission for
** educational and non-profit use is granted to all. If you're planning to
** make money with this or any code derived from it, check with the author
** first.

** VERSION 1.2.


ogftp is a simple file transfer utility to allow the movement of files between
an HP Omnigo 100 and a Unix or OS/2 system.

COMPILING:
	Set the OPSYS, DEF_PORT, and DEF_SPEED lines in the Makefile (use
	makefile.os2 for OS/2). By default Makefile is setup for a Sun system
	using /dev/ttya at 19200 baud. makefile.os2 is setup for an OS/2 system
	using COM1: at 19200 baud.

	Now use make. If you don't want to use gcc to compile the code then
	change the Makefile.

	The makefile for OS/2 has been tested with NMAKE from the toolkit, but
	it should also work with other make-style tools. To compile the
	program, you'll need the EMX/GCC compiler. The command to make
	ogftp.exe is "nmake /f makefile.os2".

USAGE:
	Start up the transfer program on the Omnigo and select "PC"/"Connect",
	then start up ogftp with:

	ogftp [port] [speed]

Some error conditions will cause ogftp to abort without shutting down the
Omnigo end, in these cases just select "Cancel" on the Omnigo. In normal
conditions, however, when ogftp ends it will cause the Omnigo to disconnect
from the serial line.

Type "?" or "help" in ogftp to get a list of commands. These should be pretty
self-explanatory.

ogftp will start up in "B:\geoworks\document". This is the document directory
on the Omnigo's internal RAM drive. To do a simple backup of the Omnigo just
copy everything in this directory with "get *.*". To see the true Omnigo
document directory (which contains files from ROM/Internal RAM and any
PCMCIA ramcards) change to "B:\GEOWORKS\DOCUMENT" (capitals are necessary).

SUPPORTED SYSTEMS:
	ogftp has been tested on the following systems:
	  * A Sun386i running SunOS 4.0.2.
	  * A Sun SPARCstation IPX running SunOS 4.1.3.
	  * An SGI Indy running Irix 5.3.
	  * Linux 1.3.83/ELF/GCC 2.7.2. Thanks to Matthew Cravit
	    <mcravit@condor.depaul.edu> for the mods for this one.
	  * OS/2 Warp 3.0 with GCC/EMX 0.8g. Thanks to Marcus Groeber
	    <100712.270@compuserve.com> for the mods for this.

BUGS:
	Sometimes doesn't recover properly from missent blocks.

	If too few arguments are given to a command (eg. "DEL" instead of
	"DEL foo") ogftp will seg fault. I should get round to fixing this in
	the next release.

	I don't know of any others at the moment so if you find any please
	email me.

HISTORY:
	V1.2: (16/ 6/96) Added OS/2 mods from Marcus Groeber and changed
	                 Makefile so that default speed and port are set in it.
	                 Changed start up directory to "B:\geoworks\document"
	                 so that "get *.*" doesn't backup ROM files.
	V1.1: (27/ 5/96) Added option for local & remote file names to be
	                 different.
	V1.0: ( 6/ 5/96) Original version.

DISCLAIMER:
	I hold no responsibility for this program doing nasty things to either
	your Omnigo or the computer it's connected to.


Asher Hoskins,
asher@prl.research.philips.com,
16/6/96

