        README.TXT  for Diet Monger Ass Kicker    December 19, 2000
        Jerry Story   jstory@edmc.net   or jstory@freenet.edmonton.ab.ca

************************************************************************
<< 1. The purpose of DMAK: >>

    The purpose of DMAK is to make diets.

************************************************************************
<< 2. History of DMAK: >>

  This version of DMAK is a combination of a former version of DMAK and
Raw Vegan.  There are two modes: all the data, and raw vegan data.

************************************************************************
<< 3. What You Need To Run DMAK: >>

    If you have only the source files, you need the Euphoria
programming language.
You can get Euphoria from:

       http://www.RapidEuphoria.com


Source files:

    dmak.exw
    dmak1.ew
    events.ew
    n_info.ew
    widgets.ew
    actions.ew
    usda.ew
    raw.ew


Data files:

    *.REQ files    These are nutrient requirements files. You need at
                   least one of these. You can make as many as you want.


David Cuny's Win32 Library:

    win32lib.ew 

************************************************************************
<< 4. The status of DMAK: >>

    DMAK is Freeware.

************************************************************************
<< 5. How to make a REQ file: >>

    Rules:

a. The body of the file name can be anything you want, but the extender
   must be REQ. Examples: JohnDoe.REQ  JaneDoe.REQ

b. Blank lines are ignored by DMAK.

c. Anything after // on a line is a comment and is ignored by DMAK.

d. Lines that are not valid data lines are ignored by DMAK.

e. A valid data line has 3 data fields separated by | .

f. The 1st data field must be a nutrient and it must be spelled
   correctly including case.

g. The 2nd & 3rd data fields must be numbers in the correct unit.

h. The 1st number is the minimum. The 2nd number is the maximum.

i. White space doesn't matter.

j. Nutrients can be in any order.

k. The REQ file must contain a valid data line for each of 30 nutrients.
   Otherwise it is rejected. (DMAK requires 31)

    See the sample REQ file below. One simple way to make a REQ file
is to copy the sample and change the numbers.

************************************************************************
<< 6. Sample REQ file: >>

// This is a complete list of nutrients. They must be spelled exactly
// as shown.
// The nutrients can be in any order.
// The 1st number is the minimum. The 2nd number is the maximum.
// Note also the units, because that they are important.

Water              |  1800    |  5400     // grams
Energ_Kcal         |  1800    |  1920     // no unit 
Protein            |  56      |  560      // grams  
Tot_Lipid          |  20      |  60       // grams 
Carbohydrt         |  225     |  450      // grams 
Fiber_TD           |  11.25   |  225      // grams 
Ash                |  4.8     |  5000     // grams 
Calcium            |  800     |  99999    // milligrams 
Phosphorus         |  800     |  8000     // milligrams
Iron               |  20      |  99999    // milligrams 
Sodium             |  500     |  99999    // milligrams 
Potassium          |  3000    |  99999    // milligrams
Magnesium          |  400     |  99999    // milligrams 
Zinc               |  15      |  99999    // milligrams 
Copper             |  2.5     |  99999    // milligrams  
Manganese          |  5       |  99999    // milligrams 
Selenium           |  70      |  5000     // mcg     
Vit_A              |  5000    |  100000   // I. U.      
Vit_E              |  10      |  99999    // mg      
Thiamin            |  2       |  99999    // milligrams 
Riboflavin         |  2       |  99999    // milligrams  
Niacin             |  20      |  99999    // milligrams  
Panto_acid         |  7       |  5000     // mg     
Vit_B6             |  2       |  99999    // milligrams  
Folate             |  500     |  99999    // mcg   
Vit_B12            |  2       |  5000     // mcg      
Vit_C              |  200     |  99999    // milligrams 
FA_Sat             |  1       |  20       // grams            // check min
FA_Mono            |  1       |  60       // grams
FA_Poly            |  15      |  20       // grams   
Cholestrl          |  20      |  500      //  milligrams

************************************************************************
<< 7. Possible problems: >>

* The data in the REQ files should not be taken as written in stone
by the finger of God. Some of the numbers are controversial.
Some of the numbers are guesses because data was not available.
Change the numbers as you see fit. Make as many REQ files as you want.

************************************************************************
<< 8. How to contact the author: >>

     The author is:                    Jerry Story
     You can contact the author at: 
        jstory@edmc.net  or  jstory@freenet.edmonton.ab.ca
     
     You can check every now and then for updates at:
        http://www.edmc.net/~jstory    or http://www.edmonton.ab.ca/~jstory

************************************************************************
