Skeleton directory for the DOT implementation.

To build DOT, there are two steps:

  1.  Build sfslite (or the full SFS)
  2.  Build DOT

Step 1.

  You can get sfslite from
     http://www.okws.org/doku.php?id=okws:sfslite

  Currently, that version won't work because it doesn't have
  some changes that DOT needs (e.g., axprt_pipe).  So, build
  the version of sfslite that's in the DOT SVN repository.
  This version is ready to configure (no need to run the auto*
  tools).

    $ cd sfslite
    $ ./configure
    $ make

Step 2.

  To configure the first time you checkout:

    $ autoreconf -i -s

  To build, do the usual (out-of-directory builds work too):

    $ ./configure --with-sfs=/path/to/sfslite
    $ make

Other useful options:

  To specify a path to the BerkeleyDB libraries
    $ ./configure --with-sfs=... --with-db=/usr

  Libraries are static by default; to make binary programs static too:
    $ LDFLAGS=-static ./configure ...
    (or the equivalent for your shell)

---- System specific configuration and installation nodes ----

FreeBSD 5.x
  - You must use the "gnu-{autoconf,automake,libtool}"
    packages to compile DOT.  The default FreeBSD installs of automake, etc.,
    are hacked to work with the ports system and will not work for DOT.

  - You must install the openssl package or port.  The default FreeBSD
    openssl does not include the pkg-config file for openssl.

  - You must have pkgconfig installed

  - You must copy the "pkg.m4" file from /usr/local/share/aclocal
    into /usr/local/gnu-autotools/share/aclocal/

    before running autoreconf.

FreeBSD 6.x:
  - You don't have to install gnu-libtool, just the other two
  - You must also copy "libtool.m4" from /usr/local/share/aclocal
    into /usr/local/gnu-autotools/share/aclocal

---- Cygwin -----

First, ensure that the necessary Cygwin packages are installed
to compile and run the sfslite and DOT code:
   make, bison, flex, automake, autoconf, libtool, pkg-config, 
   libgmp, minires-devel, sunrpc

Next, you'll need to add modern function prototypes to the sunrpc
header files.  The Cygwin default sunrpc package provides header files
in /usr/include/rpc/ that date from the mid 80s.  Unfortunately, the
headers use K&R syntax, which g++ strongly dislikes because of C++'s
strong type checking.  To correct this, you'll need to add the argument
prototypes for a number of functions in the directory.

XXX - we need to clarify these instructions more and make sure
they're complete.
