Installation Instructions for GNUe Common
=========================================

Requirements
------------

* Python 2.3+


General Information
-------------------

On Apple Mac OS X (using Fink)
  
  Use the document at doc/install-mac-os-x.txt

On all other systems

  for standard system-wide install
  ./setup.py install
    (if you don't do this as root, you have to set
     PYTHONPATH=/usr/local/gnue/lib/python to make gnue work)

  for install in home-directory (POSIX only)
  ./setup.py install --home=~/gnue --install-scripts=~/bin
    (you have to add "PYTHONPATH=~/gnue/lib/python" to your .profile)

  for packagers we recommend (POSIX only)
  ./setup.py install --prefix=/usr --root=...

  for help:
  ./setup.py install --help

  If you don't have write access to Python's standard directory for
  site-specific packages (/usr/lib/pythonx.y/site-packages on Posix systems),
  you will get a message that you have to set the PYTHONPATH variable. Do it.


On *nix based machine
  Switch to  the etc directory under your install directory.
  On my system that is

  /usr/local/gnue/etc

  Rename the sample.gnue.conf to gnue.conf.  Make any optional changes you like
  to this file.


On Windows machine

  Switch to the etc directory under your python install dir.
  On my system that is

  C:\python23\etc

  Rename the sample-windows.gnue.conf to gnue.conf.  Make any optional changes
  you like to this file.

On all systems

  You should also rename sample.connections.conf to connections.conf and edit
  it to reflect the databases you wish to access frequently.

  See doc/Connections.txt for more information
