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

        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)  Untar the nut archive:

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

2)  If you want a graphical user interface, install fltk-1.1.10 or something
    from the fltk-1.3.x branch other than fltk-1.3.0.  The graphical user
    interface executable will be called "Nut" and the console program 
    executable will be called "nut" when they are installed.

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

    When not specified, all PUFAs except 18:2, 20:3, and 20: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 are sub-items to change the
       way the program computes essential fatty acid values.

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