    NUT nutrition software 
    Copyright (C) 1996-2012 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 24.

        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.  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.

1)  If you want the GUI, install fltk-1.1.10.  NUT specifically does not work
    with the stable fltk-1.3.0 release, but in general it does work with the
    fltk-1.3 branch including the betas that will culminate in fltk-1.3.1.
    Ubuntu-type distributions will need to install the "fltk" package if FLTK 
    is not compiled from source, but again, if the package is the straight 
    1.3.0 release, NUT will segfault upon use of certain pull-down menus.  
    Neither fltk2 nor fltk3 will work with NUT yet.

2)  Untar the nut archive:

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

3)  Issue the command "make install" as root.  You can always issue the
    command "make clean" before the "make install" if you want to be
    absolutely sure everything will be freshly recompiled.

4)  The console program is called "nut" and the fltk GUI is called "Nut".
    Both programs operate identically on the underlying database and can be
    used interchangeably; however, they cannot be used at the same time as 
    they would overwrite each other's changes to the database.

    The size of the GUI can be changed either by resizing or by editing the
    file "fontsize" in the ".nutdb" directory before the application comes up.
    The range is 8 to 24 and the default is 12.

5)  When you run NUT the very first time, it will take a few extra seconds to
    come up because it is reading the file "sr24.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. USDA 
    Nutrient Data Laboratory. 2011. USDA National Nutrient Database for 
    Standard Reference, Release 24. Nutrient Data Laboratory website: 
    http://www.ars.usda.gov/nutrientdata

    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 to change the way the program computes
       values after an analysis reset.

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