GNUtrition                     http://www.gnu.org/software/gnutrition/
----------------------------------------------------------------------

= Building GNUtrition from a Tarball =

First, run:

    ./configure

Run --configure --help to see all available options.  For example, to
set PREFIX to a different location than /usr/local, you can set it
like so:

    ./configure --prefix=/path/to/prefix

If configure runs without errors, then run:

    make
    make install

If your prefix is set to a location where your user does not have
write permissions (such as the default location for most people): you
may either switch to root or run

    sudo make install


= Building GNUtrition from a CVS checkout =

If you're building from a CVS checkout first run autoreconf -i.  For
most users: downloading a release tarball from either ftp.gnu.org or
alpha.gnu.org is recommended.


= Building the USDA database =

Run the script in the top-level directory:

    gnutrition-updatedb

This downloads USDA data and generates food.db to your prespecified
prefix directory.


= Running GNUtrition =

If food.db is in the prespecified prefix directory, simply run:

    gnutrition

To specify a different database location:

    gnutrition --db=/path/to/food.db

The per-user log database is stored at
$XDG_DATA_HOME/gnutrition/log.db (or ~/.local/share/gnutrition/log.db
if XDG_DATA_HOME is not set).  The USDA database is never modified.
