home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / health / mmcrdt23.zip / MMCREDIT.DOC < prev   
Text File  |  1993-05-31  |  12KB  |  270 lines
  1.  
  2.     MMCREDIT.EXE is a program to complement the Meal Master (MM) program.
  3. MM is an excellent, reasonably priced recipe database program.  On I-LINK
  4. and Rime Cuisine conferences it seems quite popular.   It will read in MM
  5. format recipes from saved QWK messages.
  6.  
  7.     I like to know who originated the recipe, however.  Typing this
  8. information on each recipe by hand is tedious.  This program will scan
  9. through a file and add a credit line at the end of each recipe based on the
  10. From: and Date: information in the header.
  11.  
  12.     It can also be used to label recipes in a ZIP file or otherwise
  13. extracted MM format recipe file that does not have qwk headers.  In this
  14. case, the new -l and -r parameters are used to specify what you want stated
  15. at the bottom of the recipe.  Every recipe in this case would have the same
  16. comment on it.
  17.  
  18.     Using these two functions in combination on successive runs of the
  19. program using the output from each run as input to the next could produce
  20. quite elaborate commentary on each recipe in the file.
  21.  
  22.     The basic functionality produces a copy of your original file with this
  23. information added.  (Well, there is logic to strip headers and commentary
  24. inserted when a recipe is continued between two messages.)  If you would
  25. like an additional file with just the modified recipe text, the new -o
  26. option can be used to produce this in an MRmmdd.n file.
  27.  
  28.     An example of the output produced by the basic functionality in version
  29. 1.00:
  30.  
  31. ===========================================================================
  32.  BBS: The Data Dimension · Norcross, GA · [V.3
  33. Date: 03-02-93 (18:45)             Number: 7419
  34. From: JOHN BLACKWELL               Refer#: NONE
  35.   To: ALL                           Recvd: NO
  36. Subj: Recipes #19                    Conf: (42) IL-Cuisine
  37. ---------------------------------------------------------------------------
  38.  
  39. ---------- Recipe via Meal-Master (tm) v7.04
  40.  
  41.       Title: Mexican Fudge
  42.  Categories: Appetizers, Cheese/eggs
  43.    Servings:  1
  44.  
  45.       1 lb Monterey Jack cheese with           1 cn Evaporated milk (13 oz.)
  46.            Jalapeno pepper                     2    Eggs
  47.       1 lb Cheddar cheese                      3 tb Flour
  48.  
  49.           Grate cheese and lay in greased 9" x 13" pan.  Beat milk, eggs, and
  50.   flour together, pour over cheeses.  Bake 40 minutes at 350 degrees F. Cut
  51.   into squares or diamonds, serve hot or cold.
  52.  
  53.  
  54.   From: JOHN BLACKWELL              Date: 03-02-93
  55. -----
  56.  
  57. The information at the bottom is extracted from the message header.  Using
  58. the -l and -r options, this comment can be set to anything you want.
  59.  
  60.     The program when run without parameters gives the following help
  61. information:
  62.  
  63.    version 2.00
  64.   Meal-Master recipe credit program by Rodney Grantham
  65.  
  66.  
  67.    This program puts author & date from QWK header
  68.       at the bottom of the Meal-Master recipe
  69.       or you can provide your own text to insert with -l & -r
  70.  
  71.  Usage: MMCREDT4 infile [outfile] [-ltext] [-rtext] [-o] [-ffilename]
  72.  
  73.     infile  - contains recipes in Meal-Master format
  74.     outfile - where to write modified Meal-Master recipes
  75.                 by default:  MMmmdd.1 if none is provided
  76.     -l      - add own footer for left side,e.g., -lFrom mm002.zip
  77.     -r      - add own footer for right side,e.g., -rFound 4/5/93
  78.     -o      - also make a file with just recipes MRmmdd.n
  79.     -f      - set recipe only file name (implies -o)
  80.     -t      - display titles as recipes are found
  81.  
  82.     If the program is renamed, the new name will display in the help
  83. message.
  84.  
  85.     You can provide your own output file as the second parameter.  If you
  86. don't, the output file is automatically set to MMmmdd.1.  mmdd
  87. representing 2 digit month and day, of course.  You may enter your own
  88. outfile as the second parameter.  If the output file exists, MMmmdd.n is
  89. attempted until a valid output file can be created.  If you provide your
  90. own file name, a similar process is followed using your filename as the
  91. base and dropping any extension.
  92.  
  93.  
  94. A sample run:
  95.  
  96.     MMCREDIT mmrecipe
  97.  
  98.  Credited file in MM0406.1
  99.  Recipes saved: 5
  100.  Lines read: 375
  101.  Lines written: 385
  102.  
  103.     If you use the optional parameters, the program functioning changes
  104. slightly.
  105.  
  106.     Use the '-o' or '-O' (the letter O for only) indicates you would also
  107. like a file produced with just the modified recipes in it.  This file will
  108. be named MRmmdd.n and the processing to set the name is done like the
  109. default output name displayed above.
  110.  
  111.     You can provide a name for this file yourself by using the -F
  112. parameter followed (immediately) by the desired name, e.g.,
  113. -Fmyrecipe.out.  If you use the -F parameter, the program assumes you mean
  114. -O so you don't have to also enter it, but you can.
  115.  
  116.     The new (version 2.30) option -t or -T displays the titles of recipes
  117. as they are copied.  By using CTRL-P to direct screen display to the
  118. printer, you can save this list for checking against the input file to
  119. verify no recipes were skipped.  (I had accidently saved some non-MM format
  120. recipes in my MMRECIPE file, for example.)
  121.  
  122.     The '-l' or '-L' and '-r' or '-R' parameters are ways to label a zip
  123. file or add a comment on the line after the author and date information if
  124. you run an prior MMCREDIT output file through again.  Up to 38 characters
  125. will be used for either.  Some flexibility is supported here.  As long as
  126. the total characters for both is under 76, the program will combine the
  127. input into a credit line.  If the length exceeds 76, the input will be
  128. adjusted to fit the 76 space limit and a message showing the resulting
  129. credit line will be displayed.
  130.  
  131.  To enter just type, for example:
  132.  
  133.  MMCREDIT mmrecipe -lFrom the ZIP file: MM00.zip -rOff    PC101 BBS
  134.  
  135.  This will add the following CREDIT line at the bottom of recipes:
  136.  
  137.   From the ZIP file: MM00.zip            Off PC101 BBS
  138.  
  139.  If you add quotes to the -r parameter, the extra spaces will be preserved
  140. so this input:
  141.  
  142.  MMCREDIT mmrecipe -lFrom the ZIP file: MM00.zip -r"Off    PC101 BBS"
  143.  
  144. produces this CREDIT line:
  145.  
  146.  From the ZIP file: MM00.zip             Off    PC101 BBS
  147.  
  148.  
  149. A sample run with the -O(nly) option to produce a file with just recipes:
  150.  
  151.     MMCREDIT mmrecipe -o
  152.  
  153.  
  154.  Credited file in MM0406.2
  155.   Just recipes in MR0406.1
  156.  Recipes saved: 5
  157.  Lines read: 375
  158.  Lines written: 385
  159.  
  160.  
  161.  
  162.     If you want to register and be notified of upgrades, send $5 to:
  163.  
  164.               Rodney Grantham
  165.               770 Cranberry Tr.
  166.               Roswell, GA 30076
  167.  
  168.     Please include the version number which displays when MMCREDIT is run
  169. without any parameters.  If there is a newer version, it will be sent to
  170. you.
  171.  
  172.     If you have suggestions send them to the same address.  The current
  173. program does what I need.  But I intend to adjust it as I think of things
  174. or people suggest new ideas to me.
  175.  
  176.     I can also be contacted via RIME or I-LINK CUISINE conferences.
  177.  
  178.     If you use the program and don't register, drop me a postcard anyway.
  179. Include any comments and your name and address.  I won't nag you about the
  180. money.  (Lesser amounts are acceptable if you wish to contribute but have
  181. limited funds BTW).  I'd like to track the spread and usage just out of
  182. curiousity.  At least splurge enough to blow a quarter.  That's real close
  183. to freeware.
  184.  
  185.     Let me know of any problems you encounter or suggested improvements.  I
  186. use the program and so far have managed to find all kinds of things that
  187. needed tweaking, but user input is appreciated.
  188.  
  189.     I intend to keep the following BBSes provided with the latest versions
  190. of the MMCREDIT program.  This gives a fair geographical dispersion.
  191.  
  192.  
  193.          Sempervirens    Sysop Nancy Miller             Pittsburg Ca
  194.          510-432-7579
  195.  
  196.  
  197.          PC101            Sysop Charles Spradlin        Atlanta GA
  198.          404-271-2488
  199.                 (BITT)           brief questionnaire
  200.                                   & upgrade within 24 hours usually
  201.  
  202.          Canada Remote Systems via Anne MacLellan        Toronto Ont
  203.          416-213-6002 and 213-6003 (paid membership)
  204.  
  205.          Bits & Bytes via Anne MacLellan                 Toronto Ont
  206.          416-532-1784           24 hr upgrade
  207.  
  208.          Art & Music     Sysop James Womack              Atlanta GA
  209.          404-739-1858          brief questionnaire & 1 hour access at once
  210.  
  211. *********************************************************************
  212.  
  213.         /************************************************************
  214.           2.00  - also check for MMMMM as bottom marker
  215.                 - write five dashes after credit line for consistency
  216.                 - check ----- for no other characters occurring in line
  217.                         other than blanks or hyphens
  218.                 - handle continuation across qwks
  219.                 - allow parameter input of comment info: left & right
  220.                 - recipe only file output option
  221.                 - detect Blue Wave heading format
  222.                 - don't display skipped output file names
  223.                 - let set recipe only output file name
  224.                 - fix suffix on output files so cycles 1 to 999
  225.                 - increase price to $5
  226.         *************************************************************/
  227.  
  228.  
  229.         /************************************************************
  230.          2.10
  231.                - check for argument with l,r,f parameters - gives message
  232.                  if missing
  233.                - <continued> in zip file: "Recipe continuation is missing"
  234.                  MM0302-5.zip has <continued in next recipe> in three
  235.                  recipes, but no continuation.  This handles this situation
  236.                  smoothly
  237.                - interruption in recipe: "Unexpected end of recipe"- this
  238.                  occurs for example when part of recipe including heading
  239.                  is quoted at the top of a message
  240.                - restore check for input file name
  241.  
  242.         ************************************************************/
  243.  
  244.  
  245.         /************************************************************
  246.          2.20
  247.                - remove extra bottom marker: I find annoying
  248.                - handle two adjacent recipes with no end marker better
  249.                - fix line counts to be accurate
  250.                - FIRST 5 characters in line must be ----- to be end
  251.                  of recipe marker (if not MMMMM type line) - problem
  252.                  with some people's dividers in ingredients that MM
  253.                  accepts, but I treated as bottom.
  254.  
  255.         ************************************************************/
  256.  
  257.         /************************************************************
  258.          2.30
  259.                - Back to first 3 characters in line must be --- to be
  260.                  end of recipe marker (if not MMMMM type line)
  261.                - if only 3 dashes, provide legitimate MM bottom mark
  262.                - if unexpected end to recipe, provide MM bottom mark
  263.                - modify header detection:  5 dashes at right margin and
  264.                  the words meal and master in correct order with not more
  265.                  than one character separating regardless of case
  266.                - added parameter -t or -T to print titles as recipes
  267.                  are extracted
  268.                - fixed Blue Wave checking for end of header
  269.         ************************************************************/
  270.