
GENERAL INFORMATION

    This is version 0.3 of GNUTRITION, a recipe and food nutritional
    analysis application for GNOME.

    The official ftp site is:

            ftp://gnutrition.sourceforge.net/pub/gnutrition/

    The official web site is:

            http://gnutrition.sourceforge.net/

    This is alpha software, so don't expect everything to work correctly
    or even at all.

REQUIREMENTS

    GNUTRITION requires that you have installed a few working libraries:

      * up to date GNOME libraries

      * libglade-0.13 or higher compiled with gnome support

      * libxml-1.8.7 or higher.

      * MySQL database server. At present gnutrition requires a
        locally installed server. ( I am using version 3.23.33, but
        I think earlier versions should work).

      * MySQL database client.

      * MySQL database client library. 
      
      * To compile gnutrition you will also need the client library 
        development files.


UPGRADING

    Note that if you are upgrading from version 0.2 to 0.3, gnutrition 0.3
    now uses a MySQL database to store recipes. This means that recipes
    created with version 0.2 cannot be loaded into 0.3. They must be
    re-created using version 0.3. Sorry.

    In future versions, if the database table format is changed, I will
    provide smoother way to upgrade between without losing data.

INSTALLATION

    To compile and install gnutrition, see the file 'INSTALL' for 
    instructions.

    After installing gnutrition, you will need to make sure that
    MySQL is set up properly, especially if you have installed
    MySQL for the first time.

    MySQL uses an access privilege system. When it is installed, the
    initial root password is empty. To get gnutrition working, all you
    need to do is make sure that you specify a root password.

    To save you the trouble of reading the MySQL manual, this can be
    achieved as follows:

    From a shell prompt type:

        mysql -uroot mysql

    You should now get a MySQL prompt of "mysql>".

    From then MySQL prompt type the following lines:

        mysql> UPDATE user SET Password=PASSWORD('new_password') 
                    WHERE user='root';
        mysql> FLUSH PRIVILEGES;
        mysql> quit

    That's it! You can now type "gnutrition".
    

HOW TO REPORT BUGS & CONTACT THE AUTHOR

    email: e.denny@ic.ac.uk
