home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / mail / mmcrdt22.zip / MMCREDIT.DOC < prev   
Text File  |  1993-04-29  |  10KB  |  244 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.  
  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.  Use the '-o' or '-O' (the letter O for only) indicates you would
  105. also like a file produced with just the modified recipes in it.  This file
  106. will be named MRmmdd.n and the processing to set the name is done like the
  107. default output name displayed above.  You can provide a name for this file
  108. yourself by using the -F parameter followed (immediately) by the desired
  109. name, e.g., -Fmyrecipe.out.  If you use the -F parameter, the program
  110. assumes you mean -O so you don't have to also enter it, but you can.
  111.  
  112.     The '-l' or '-L' and '-r' or '-R' parameters are ways to label a zip
  113. file or add a comment on the line after the author and date information if
  114. you run an prior MMCREDIT output file through again.  Up to 38 characters
  115. will be used for either.  Some flexibility is supported here.  As long as
  116. the total characters for both is under 76, the program will combine the
  117. input into a credit line.  If the length exceeds 76, the input will be
  118. adjusted to fit the 76 space limit and a message showing the resulting
  119. credit line will be displayed.
  120.  
  121.  To enter just type, for example:
  122.  
  123.  MMCREDIT mmrecipe -lFrom the ZIP file: MM00.zip -rOff    PC101 BBS
  124.  
  125.  This will add the following CREDIT line at the bottom of recipes:
  126.  
  127.   From the ZIP file: MM00.zip            Off PC101 BBS
  128.  
  129.  If you add quotes to the -r parameter, the extra spaces will be preserved
  130. so this input:
  131.  
  132.  MMCREDIT mmrecipe -lFrom the ZIP file: MM00.zip -r"Off    PC101 BBS"
  133.  
  134. produces this CREDIT line:
  135.  
  136.  From the ZIP file: MM00.zip             Off    PC101 BBS
  137.  
  138.  
  139. A sample run with the -O(nly) option to produce a file with just recipes:
  140.  
  141.     MMCREDIT mmrecipe -o
  142.  
  143.  
  144.  Credited file in MM0406.2
  145.   Just recipes in MR0406.1
  146.  Recipes saved: 5
  147.  Lines read: 375
  148.  Lines written: 385
  149.  
  150.  
  151.  
  152.     If you want to register and be notified of upgrades, send $5 to:
  153.  
  154.               Rodney Grantham
  155.               770 Cranberry Tr.
  156.               Roswell, GA 30076
  157.  
  158.     Please include the version number which displays when MMCREDIT is run
  159. without any parameters.  If there is a newer version, it will be sent to
  160. you.
  161.  
  162.     If you have suggestions send them to the same address.  The current
  163. program does what I need.  But I intend to adjust it as I think of things
  164. or people suggest new ideas to me.
  165.  
  166.     I can also be contacted via RIME or I-LINK CUISINE conferences.
  167.  
  168.     If you use the program and don't register, drop me a postcard anyway.
  169. Include any comments and your name and address.  I won't nag you about the
  170. money.  (Lesser amounts are acceptable if you wish to contribute but have
  171. limited funds BTW).  I'd like to track the spread and usage just out of
  172. curiousity.  At least splurge enough to blow a quarter.  That's real close
  173. to freeware.
  174.  
  175.     Let me know of any problems you encounter or suggested improvements.  I
  176. use the program and so far have managed to find all kinds of things that
  177. needed tweaking, but user input is appreciated.
  178.  
  179.     I intend to keep the following BBSes provided with the latest versions
  180. of the MMCREDIT program.  This gives a fair geographical dispersion.
  181.  
  182.  
  183.          Sempervirens    Sysop Nancy Miller             Pittsburg Ca
  184.          510-432-7579
  185.  
  186.  
  187.          PC101            Sysop Charles Spradlin        Atlanta GA
  188.          404-271-2488
  189.                 (BITT)           brief questionnaire
  190.                                   & upgrade within 24 hours usually
  191.  
  192.          Canada Remote Systems via Anne MacLellan        Toronto Ont
  193.          416-798-4713
  194.  
  195.          Art & Music     Sysop James Womack              Atlanta GA
  196.          404-739-1858          brief questionnaire & 1 hour access at once
  197.  
  198. *********************************************************************
  199.  
  200.         /************************************************************
  201.           2.00  - also check for MMMMM as bottom marker
  202.                 - write five dashes after credit line for consistency
  203.                 - check ----- for no other characters occurring in line
  204.                         other than blanks or hyphens
  205.                 - handle continuation across qwks
  206.                 - allow parameter input of comment info: left & right
  207.                 - recipe only file output option
  208.                 - detect Blue Wave heading format
  209.                 - don't display skipped output file names
  210.                 - let set recipe only output file name
  211.                 - fix suffix on output files so cycles 1 to 999
  212.                 - increase price to $5
  213.         *************************************************************/
  214.  
  215.  
  216.         /************************************************************
  217.          2.10
  218.                - check for argument with l,r,f parameters - gives message
  219.                  if missing
  220.                - <continued> in zip file: "Recipe continuation is missing"
  221.                  MM0302-5.zip has <continued in next recipe> in three
  222.                  recipes, but no continuation.  This handles this situation
  223.                  smoothly
  224.                - interruption in recipe: "Unexpected end of recipe"- this
  225.                  occurs for example when part of recipe including heading
  226.                  is quoted at the top of a message
  227.                - restore check for input file name
  228.  
  229.         ************************************************************/
  230.  
  231.  
  232.         /************************************************************
  233.          2.20
  234.                - remove extra bottom marker: I find annoying
  235.                - handle two adjacent recipes with no end marker better
  236.                - fix line counts to be accurate
  237.                - FIRST 5 characters in line must be ----- to be end
  238.                  of recipe marker (if not MMMMM type line) - problem
  239.                  with some people's dividers in ingredients that MM
  240.                  accepts, but I treated as bottom.
  241.  
  242.         ************************************************************/
  243.  
  244.