== General Informations ==

PgWorksheet is a simple GUI frontend to PostgreSQL 
for executing SQL queries without using the psql command line tool.

More informations on : http://pgworksheet.projects.postgresql.org/

== Operating systems ==
PgWorksheet is certified to run on the following operating systems:
    * FreeBSD 5.x or better
    * Linux Ubuntu 4.x or better
    * Linux Fedora Core 3 or better
    * Microsoft Windows XP


== Depencies ==
PgWorksheet requires the following softwares to run :
    * Python 2.4 or better
    * Python GTK+ 2.4 or better
    * pyPgSQL 2.4 or better
    * mxDateTime (required by pyPgSQL)
    * GTK+ 2.4 or better (required by Python GTK+)


== Installation ==

= Microsoft Windows =
To install and run PgWorksheet under Microsoft Windows XP :
    * Install GTK+ using this installer :
      http://prdownloads.sourceforge.net/pgworksheet/gtk-win32-2.4.14-rc3.exe?download
    * download the pgworksheet-1.x-setup-win32.exe setup program execute it.
      This setup will create a shortcut to PgWorksheet in the start menu.

= Linux Fedora =
The following packages must be installed :
    * postgresql-libs
    * postgresql-devel
    * postgresql
    * mx
You must install pyPgSQL from the sources (download the .tar.gz archive from http://sourceforge.net/project/showfiles.php?group_id=16528):
tar zxvf pyPgSQL-2.4.tar.gz
cd pypgsql
python setup.py build
python setup.py install

= Linux Ubuntu =
The default installation of Linux Ubuntu is sufficient to run PgWorksheet.
If you want to execute psql commands you must install the postgresql-client package.

= FreeBSD =
The following ports must be installed :
    * x11-toolkits/py-gtk2
    * databases/py-pyPgSQL

= Other operating systems =
Please use the package/port system of your Linux distribution or UNIX/BSD system to install these dependencies. 
