README
======

* Generic installation instructions for compiling from source can be
   found in the INSTALL file.

* Notes for specific distros or OSes are found at the bottom of this file.

* Binary packages for Mandrake Linux (RPM) and FreeBSD (pkg) can be found at:
   http://www.varp.net/downloads and at
   http://www.freshmeat.net/iota

* Manuals for iOta can be accessed through the KDE help system
   under Applications/Graphics/iOta
  The latest version of the manual can always be found at
   http://www.varp.net/photos/iOta.html

PORTING ISSUES
==============

* For Mandrake Linux:
^^^^^^^^^^^^^^^^^^^^^
   The KDE desktop files are placed in the non-standard directory 
   /usr/share/applnk-mdk/Multimedia/Graphics
   So, if you compile from scratch, remember to copy 
    iota-0.8/iota/Makefile.am.mdk to iota-0.8/iota/Makefile.am

   And then, from iota-0.8/, do a ./configure; make; make install

* For Redhat Linux:
^^^^^^^^^^^^^^^^^^^

* For Gentoo Linux:
^^^^^^^^^^^^^^^^^^^

* For FreeBSD:
^^^^^^^^^^^^^^
    The critical issue for FreeBSD users is the handling of the
    Berkeley DB package. The header files and library for this
    package are tagged with the release number in FreeBSD systems.

    For example, DB 4.0 will have headers in /usr/local/include/db4
    and the library will be linked as -ldb4. For DB 4.1, headers are
    found under /usr/local/include/db41 and the library is linked as
    -ldb41

    For this reason, we have separate config and make files for BSD.
    This release has been tested with both DB 4.0 and DB 4.1. The 
    makefiles/config files, though, are configured for DB 4.1.
    
    From the base directory:
    - First, copy iota-0.8/configure.bsd iota-0.8/configure
    - Next copy iota-0.8/iota/Makefile.in.bsd iota-0.8/iota/Makefile.in
    - Then,
      ./configure --with-extra-libs=/usr/local/lib \
                  --with-extra-includes=/usr/local/include
      ./gmake
      ./gmake install (as root).

      This package uses GNU Make instead of Make.

    If you want to compile against DB4.0, then edit 
    iota-0.8/iota/Makefile.in to change include/db41 to include/db4