packages icon
    NUT nutrition software 
    Copyright (C) 1996-2014 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 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 27.

        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-20.1.gz
	cd nut-20.1/

2)  If you want a graphical user interface, install fltk-1.3.2 or later from
    the fltk-1.3.x branch.  fltk-1.3.2 does not compile on the Mac but later
    versions from the fltk-1.3.x branch reportedly do work.

    The graphical user interface executable will be called "Nut" and the
    console program executable will be called "nut" when they are installed.
    FLTK only has to be installed to compile the NUT graphical user interface,
    not to run it.

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 "sr27.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. 2014. USDA
    National Nutrient Database for Standard Reference, Release 27. 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 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