    NUT nutrition software 
    Copyright (C) 1996-2008 by Jim Jozwiak.

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

OVERVIEW

        NUT allows you to record what you eat and analyze your meals for
        nutrient composition. The database included is the USDA Nutrient
        Database for Standard Reference, Release 21.

        This database of food composition tables contains values for
        calories, protein, carbohydrates, fiber, total fat, etc., and
        includes all the nutrient data in the USDA database, including the
        Omega-6 and Omega-3 polyunsaturated fatty acids. Nutrient levels are
        expressed as a percentage of the DV or Daily Value, the familiar
        standard of food labeling in the United States. The essential fatty
        acids, Omega-6 and Omega-3, are not currently mentioned in these
        standards, and a reference value has been supplied.             

        You may search this list of foods and view nutrient values for
        different serving sizes; you may also rank foods in order of level
        of a particular nutrient. You may change the daily calorie level to
        correspond to your personal metabolism, and the levels for fat,
        carbohydrates, fiber, and protein are automatically adjusted. You
        may customize the ratios of carbohydrates to protein to fat to suit
        your personal regimen. You may add your own recipes to the database,
        by creating them from the foods in the database. You can also add
        foods from the information on commercial food labels. The program is
        completely menu-driven and there are no commands to learn.

INSTALLATION

Note:  NUT can modify your prior release database files automatically, from
       release 8.0 forward.  Just follow the steps below and make sure that 
       the Makefile points to your current ".nutdb".  NUT will read in 
       your recipes and match your meal records to a changed food database, 
       or else make other changes the new version requires; however, NUT
       may be incapable of preserving your former personal options or retaining 
       meal foods that do not exist in a changed USDA database, so it is a
       good idea to make a copy of your "meal.db" file before proceeding.

1)  Untar the archive:

	tar xvzf nut-14.1.tar.gz
	cd nut-14.1/

2)  Consider where you want to put the raw data files.  In the Makefile, find
    the line:

CFLAGS= -Os -s -Wall -DNUTDIR=\".nutdb\" -DFOODDIR=\"/usr/local/lib/nut\" -ansi -pedantic
    
    You may redefine "FOODDIR" as shown on the Makefile line, and then 
    create the directory if necessary, and move the contents of the "raw.data"
    directory to that directory.

        mkdir /usr/local/lib/nut/
	mv raw.data/* /usr/local/lib/nut/

    The personal database subdirectory "NUTDIR" is relative to your home
    directory.  If you wish, you may change it to whatever you
    want.  It will be made automatically the first time the program runs,
    if you are not upgrading.

3)  Issue the command "make".

4)  If all goes well, move the "nut" executable where you want it, and move
    "nut.1" to your favorite man directory.

	mv nut /usr/local/bin/
	mv nut.1 /usr/local/man/man1/

5)  When you run NUT the very first time, it will take a minute or so to
    come up because it is reading the file "sr21.nut", and creating the files 
    "food.db", "meal.db", "theusual.db", and "OPTIONS.txt".  The USDA-format
    files "FOOD_DES.txt", "NUT_DATA.txt", and "WEIGHT.txt" contain the
    data for recipes and edits to the database.  The USDA-format group in the 
    directory defined as FOODDIR are for installation-wide changes and the
    changes that come in the NUT distribution.  The group in the user's
    database directory are personal changes to the database.  Both
    groups will be read only if there is no "food.db" when the program
    starts, unless you are upgrading to a release which rebuilds the food
    database and re-indexes the meals to it.

    The source for the food database is:

    U.S. Department of Agriculture, Agricultural Research Service. 2008. 
    USDA National Nutrient Database for Standard Reference, Release 21. 
    Nutrient Data Laboratory Home Page, http://www.ars.usda.gov/ba/bhnrc/ndl

    When not specified, all PUFAs except 18:2, 20:3, 20:4, 21:5, and 22:4 are
    considered to be omega-3; the database does not yet distinguish between 
    omega-6 and omega-3 for many foods.  The omega-6 and omega-3 totals may be
    overstated for foods which contain significant trans- fats, such as those
    which contain hydrogenated vegetable oils.

Note:  There are no DVs for the Omega-6 and Omega-3 polyunsaturated fatty 
       acids.  Reference values shown may be more or less than your personal
       needs. Under the Personal Options menu item is a sub-item for causing 
       the program to look for absolute amounts rather than the default 
       percentage of calories, or changing the way the program computes
       values after an analysis reset.

Jim Jozwiak
http://nut.sourceforge.net/
jozwiak@gmail.com, av832@lafn.org
