                      Recipe BUSTER for MasterCook-PC
                              MS-dos / Windows
                         (c) 1996-99 Glen G. Hosey


MCBUSTER 2.0

* MC for MasterCook (II, 3.03 and 4.n)
* Windows (3.1, 3.11 or 95)
* Free for you to download and share
* Designed for people who use MasterCook/WIN
* Creates import/export file with the .mxp extension
* Edits, repairs and extracts emailed recipes 
* Helps convert text files and web page recipes into MasterCook import/export
  files

CHANGES FOR VERSION 2.0:

a.  Version 2.0a changed the way ingredients that have parenthesis as the
first part of the item are displayed. Had a bad way they were being displayed,
now if the first part of the item is in parenthesis (like: 1 can (10 ounces)
pineapple), that part in the parenthesis is moved to the end of the item.
Added conversions for some additional "wierd" characters. Placed warning beeps
at all error conditions. Made sure that there would be a blank line before the
posting string.

b. V2.0B Added a switch to strip out all categories from MC & MM recipes and
add an optional new category to all of them. This does not strip out the "C:"
in unformatted recipes. Also fixed problem when a series of "Now You're
Cooking" recipes do not end properly.  The new switch is contained in lines 12
& 13 of the MC_BUSTR.CFG file. STRIPCATS=NO will leave categories as they are.
Setting this to STRIPCATS=YES will strip categories from MC & MM recipes and
replace it with the one you choose in the DEFAULTCAT= line. The "default"
category can be up to 20 characters long.

c. V2.0C has minor changes to the way DEFAULTCAT= is looked at (don't need the
spaces after '=' to leave it blank), the way decimal amounts were converted,
the way the poster's name was pulled out in "Daves Recipe Archive", and fixed
the problem of using asterisks at the end of a line to denote different notes
(previously if there were 4 or more asterisks, they improperly were converted
to dashes).

d. Version 2.0D is a minor change to the way that ingredients in parenthesis
are handled. Placing an item in parenthesis (such as the size of a container)
will be moved to the end of the ingredient line if the item comes immediately
after the amount, or immediately after the measurement:

     1 can (15-oz) tomatoes, drained
     1 (15-oz) can tomatoes, drained

     will both become:

     1 can tomatoes, drained (15-oz)

     but......

     1 can tomatoes (15-oz), drained

     will not be changed!!!

e.  Version 2.0e puts 2 spaces after each period in the sentences that appear
in the directions.  As another added feature, some measurements in Swedish and
Finnish have been added!!! Some of the more common measurements (Tbs, tsp,
can, etc) have their Swedish and Finnish names added to the translation table
where buster expands abbreviations into whole words and will convert them into
English words as well!

f.  Version 2.0f puts 2 spaces after periods, and adds some more conversions 
for Finnish and Swedish! 

g.  Version 2.0g added in new switch for breaking up paragraphs whenever a
direction line ends with a punctuation mark (period, exclamation or question).
Setting SEPARATE_PARA=YES will break them up. Setting SEPARATE_PARA=NO will
have all paragraphs run together until a blank line is encountered.

h.  Version 2.0h fixes problem of MealMaster titles not getting changed to all
caps when using CAPTITLES=YES switch. Adds a couple of "personalized"
MealMaster headings in -- quick headings you can type in when the poster
leaves out the proper heading.  You can use "-----mealmaster" or
"-----meal-master" and buster will recognize them. Also adds a new letter in
the config file.  Using a "Z" will tell buster to put absolutely nothing about
the poster, converted by buster, etc, etc at the end of the recipe. I strongly
advocate giving credit to the original poster, but if you choose not to, you
can use this letter.

i.  Version 2.0i fixes a little typo problem with buster, where buster
converted measurements of "servings" into "cans"!!! My fault!

This version also adds capability to convert mixed whole number and fractions
in the "x - y" amount! One IMPORTANT note: If there are mixed fractions, you
MUST include a dash in the mixed fraction and separate the two amounts by a
space, then the dash, then another space:  1-1/2 - 2-1/2 cups

j.  Version 2.0j adds support for MasterCook 5.0's new header which has only
single spaces in it (* Exported from MasterCook *).

ALL CHANGES IN VARIOUS FLAVORS OF VERSION 1.9 LISTED BELOW HAVE BEEN
INCORPORATED INTO THE NEW VERSION 2.0!!!

CHANGES FOR VERSION 1.9:

  a. It's finally here!!!! The newest version converts all MealMaster recipes
into vastly improved MasterCook recipes. Two-column recipes are converted
properly.

  b. I have added a new switch in the configuration file. The ninth line now
must contain "SHOWLITERS=YES" or "SHOWLITERS=NO". Setting it to YES will alert
you when any ingredient line contains an amount of "l" (that's a little L)
which will be converted to "liters" in the resulting recipe. If you tell
program to continue, it will be converted, otherwise the program will
terminate and inform you of the line number containing that particular
ingredient so you can edit it and re-run the program!

  c.  Version 1.9d adds support for recognizing MC recipes exported from the
"Key Home Gourmet" recipe program.

  d.  Version 1.9e fixes a problem with the PAUSE=NO switch, which did not
work properly.

  e.  Version 1.9g adds a switch for allowing headers in ingredient lines to
be changed to all cap letters.  If CAPHEADERS=YES and an ingredient line
starts and ends with 3 asterisks or 3 dashes, that line will be capped.

  f.  Version 1.9h converts the abbreviations in MC recipes into spelled out
words now! Also added a little deal to make sure 2 spaces follow each period.
Another biggie, it that the Word Wrap is fixed!

  g.  Version 1.9i cleaned up some formatting of ingredent lines.

  h.  Version 1.9j took out the 2 spaces mentioned in para (f) above. Also
fixed ingredient lines starting with word "about", now puts that word at the
very end. Spells out the single character fractions 1/4, 1/2 and 3/4. Fixes a
problem with "Date: " lines with non-standard dates.

  i.  Version 1.9k/l put a tag line in that says that the recipe was "converted
by MC_buster" for a little credit 8-) !!! Also fixed a problem with "=20"
lines in MM recipes.

  j.  Version 1.9m fixed problems when posters leave out the end of MC recipes
(that is the line of dashes at the end).  Buster now only requires three (3)
brackets at the start and end of unformatted recipes. They still MUST be on a
line by themselves with no spaces at the end! Also, the headings only require
two Asterisks (*) to be capitalized.

  k.  Version 1.9n now recognizes the new endings in MC-Mac recipes (they end
with 5 underscores, not the 3 pound signs!). Changed the lines written at the
end of the temporary file, so hopefully when the last recipe in a file does
not have a proper ending, buster will not hang up. Also the problem of the
MM "dashes and ds" not converting properly was finally whipped!!!!!

  l.  Version 1.9o fixed a minor problem when dates in the recipe file were
not standard.

  m.  Version 1.9p adds the capability for creating MC header lines from
ingredient lines in unformatted recipes which end in a colon. If the line is
in all cap letters and ends with a colon, it will be transformed into a MC
heading line. For example, a line in an unformatted recipe of "FOR THE SAUCE:"
will turn into "***FOR THE SAUCE***" in the resulting MC recipe. It actually
didn't work in certain combinations of .CFG settings, so version 1.9q fixed
that. 

  n.  Version 1.9q also caps the word "OR" if it is the first word in an
ingredient line, and there are no amounts or units on that line.

  o.  Version 1.9r will now create a MC heading out of any ingredient line
which ends in a colon (:) that does NOT have any amounts or units of measure
at the start of the line. Any number at the beginning of a line is regarded as
an amount (like a bread machine's "1-1/2 pound loaf:" would NOT be translated
into a header due to the "1-1/2". If you change the line to "for 1-1/2 pound
loaf:", then it would be transformed into a header (***FOR 1-1/2 POUND
LOAF***). 

  p.  Version 1.9s now allows an optional "NOTES :" to be added after the
title of a recipe. This only works in the unformatted recipes converted with
the [[[[[ method. This is optional, just like the servings, categories and
recipe by are. This one MUST be the last item before the blank line in front
of the ingredients. It can be contain up to 1024 characters. It may span any
number of line, but must not contain a blank line. Example:

[[[[[
Recipe Title
S: 4 (optional servings, can use Serves, Serves:, Yield:, Y:, etc)
B: Bon Appetite! (optional, appears in MC recipes in the "Recipe By:" area)
C: Categories, optional, multiple (separate each category with commas)
N: Optional notes go here. They can be up to a total of 1024 characters
long. They can span multiple lines. Everything from the N: up to the blank line
will be treated as part of the notes.

1 cup this
1/2 cup that
etc, etc, etc.....

Notes can be tagged with "N: ", "Notes ", "NOTES ", "Notes: " or "NOTES: ".

  q.  Version 1.9t is a minor modification to the "notes" provision. I
increased the maximum number of characters allowed to 2048 (that's about 27
lines of 75 characters each!). Also modified it to print before the poster's
name IF your configuration setting is MCNOTES=NO.

  r.  Version 1.9u fixes some problems when busting unformatted recipes which
contain very long lines with lots of dashes or asterisks in them, like:

-----------------------this is a header------------------------
***********************this is a header************************

  s.  Version 1.9v allows conversion of dashes in those ingredient lines which
actually mean "to" (like "2-3 cups sugar"). This will now get converted
properly to "2 cups sugar (up to 3)". There is one exception where this will
not work:  If you have whole numbers and fractions on the left side of the
dash, and the first amount ALSO has a dash, you will get strange results
(like "1-1/2-2 cups")!  Also fixed some minor glitches where buster tried to
use the "to" in a header like the above example (formerly, a heading line like
"TO FINISH:" was not properly converted.  I also fixed the math on determining
whether a measurement should be plural or not. (Before, "3/4" would cause a
plural, while "1 1/2" would not!)

  t.  Well....I blew it with 1.9V!! Did a stupid test in my code, and as a
result, any ingredient which only had a fraction, wound up with "(up to )" at
the end of the line! Simple fix. Additionally, ingredients with the "x to y"
now show up like "1 cup sugar -- up to 2", instead of "1 cup sugar (up to 2)",
much more in line with MasterCook proper format.

  u.  Version 1.9X fixes a reallllly minor problem I created when having
Buster convert a leading "or" to caps. I didn't check for a space after the
"or" so both "or " and "orange" get converted to "OR " and "ORange"!

  v.  Version 1.9Y fixes a problem with multiple " -- " in an ingredient line.
It also fixes the count for maximum characters allowed in a "prep method"
field. 

  w.  Version 1.9Z includes an optional switch to allow the copying of the
digest heading information into your resulting recipes file (.MXP), to give
you a better idea of where the recipes came from! The 11th line of the
configuration file must now contain a line "DIGESTHEADERS=NO" (tells buster
NOT to put that information into the .MXP file) or "DIGESTHEADERS=YES", the
default, which tells buster to include the information.

  x.  Version 1.9AA is a minor change to the information that the previous
version places at the start of the file, now it will place the titles of all
the recipes contained in the file at the top.

  y.  Version 1.9BB fixes a problem that arises when files are saved with
2-letter filenames with an extension. These were not properly matching up with
the entries in the configuration file.

  z.  Version 1.9CC fixes a problem with 2-column MealMaster recipes where
heading lines are interspersed within the ingredients. Buster now properly
puts ingredients within each heading group in their proper place.

  aa. Version 1.9DD fixes a problem with MealMaster recipes which are exported
with decimal amounts.

  bb. Version 1.9EE fixes some spacing and punctuation problems with "up to"
entries.  Also, I have added another optional item: Time!  Using "T:", "Time"
or "Time:" plus a time will have this information placed in the Prep Time
area. They should be formatted like: T: 0:30, Time 0:30 or Time: 0:30.

  cc. Version 1.9FF fixes a bit of comma/dashes problems with ingredients
within parenthesis. Fixed so that "1 cup wine (sweet, red wine)" does NOT
translate into "1 cup wine (sweet -- red wine)", but now properly translates
into "1 cup wine -- (sweet, red wine)".  Minor glitches with converting
abbreviated measurements fixed (only happened with LOWERCASE=NO setting).

  dd. Version 1.9GG adds in a warning when buster encounters a MasterCook
recipe that has no blank lines in the heading between the "Exported from" and
the recipe title.  It shows the line number of the possible error, and warns
the user to edit the file, if necessary.

  ee. Version 1.9HH modifies the wording of the "warning" above. It also now
converts a wierd "tab" character ("") to a space. Additionally, if a file
already exists with same filename and a .DON extension, the new one will be
saved with a different filename. 

  ff. The renaming of files introduced in version 1.9hh was eliminated! You
will get a warning when the same filename already exists when buster attempts
to rename your original to a .DON file. There is a new error stopage when
buster detects a "prep method" that is too long without any spaces to fit into
MC 20-character "prep method" area.

IMPORTANT NOTE FOR WINDOWS '95 USERS:

  Are you using win95?????? if so, go into explorer, and find the subdirectory
where buster is... find buster..... click right button on it and tell it to
make a shortcut. OOps, make sure your explorer isn't taking up the whole
screen! After you make a shortcut, "grab" it and drop it outside explorer onto
the main win screen. Then close explorer. 

  If you want to use the "/LIST" option:  Right button click on the buster
icon, go into properties, into the "program" area. It will give you a "command
line" option, something like "C:\RECIPES\MM_BUSTER.EXE", or whatever. Just go
into that line and add a "/LIST" at the end (with space before it).

  Also, if you want a full-screen buster, right click on the icon, look at the
"Run:" option and tell it "maximized". Then go into the "screen" menu, and
make sure that "full screen" is clicked. THen "apply" it to the icon, close it
up, and the next time you click on the icon it should run properly!

IMPORTANT NOTE FOR WINDOWS 3.x USERS:

  To create an icon so that Buster will operate from a click, in Program
Manager, click on "File" and "New" to create a new "Program Item". In the
properties menu screen, fill in the "Description" with whatever you want the
program called (i.e. "Buster"). Under "Command Line" give it the full path AND
the filename where buster is (you can browse to find it), like
"C:\BUSTER\MC_BUSTER.EXE" and enter that same directory in the "Working
Directory" area ("C:\BUSTER").

  If you want to use the "\LIST" feature of buster, do as above, but in the
"Command Line" area, include the switch, like "C:\BUSTER\MC_BUSTER.EXE \LIST",
note there must be a space after the program name and the switch.

  This will create an icon you can just click on to get buster to run!

CHANGES FOR VERSION 1.8:

  a.  In response to a lot of people who wanted a capability to process more
than one file at a time, I have added a switch "/LIST" to the program. If you
run buster with the command "MC_BUSTR /LIST", the program will create a
listing of all files in your subdirectory (BUSTFILE.FIL), and will then go
through the filenames one at a time, and ask if you want to bust that file or
not. If you answer "Y" or "y", that file will be busted. An answer of "N" or
"n" will skip to the next file. Hitting an "X", "x" or CONTROL-X will abort
the program.

  This new switch will NOT prompt you for any files which have extensions:

    .EXE
    .CFG
    .MMF
    .MXP
    .DON
    .OUT
    .ZIP
    .BAK

  b. Joel Ehrlich has a very old recipe software program, which unfortunately
contains tons of his favorite recipes. The program cannot be altered to print
anything other than the 2-column format. I have now solved the problem and can
now convert these recipes. All you need to do is place curly brackets around
the recipe! No additional editing! Do NOT change any of the spacing! Example:

{{{{{
 Banana Pudding    No. 2306                             Yields 6 Servings

   2/3 Cup       Sugar                      3 Tbls      Butter
   1/3 Cup       Cornstarch                 2 Tbls      Vanilla
     3 Cups      Milk                       2 Cups      Vanilla Wafers
   1/2 tsp       Salt                       2 Cups      Ripe Bananas, Sliced
     2           Eggs

Preheat the oven to 350 degrees.
Combine the sugar, cornstarch, milk and salt in a large saucepan.
Cook, stirring, over medium heat until thickened.
Beat the eggs lightly with a wire whisk.
Add a little of the hot mixture to the eggs.
Blend well.
Pour the eggs into the mixture in the saucepan.
Cook, stirring, for a few minutes.
Add the butter and the vanilla.
Blend well.
Cover the surface of the pudding with plastic wrap.
Cool slightly.
Place a layer of vanilla wafers on the bottom of a (2 Qt.) casserole.
Alternate additional layers of vanilla wafers with layers of banana slices
and
pudding, ending with pudding as the top layer.
Bake until set (about 10 minutes).
}}}}}

AND NOW!!!!! VERSION 1.9!!!!!! It converts MealMaster recipes into MasterCook
format -- do no editing of these, they will be converted properly!!!

ADDENDUM FOR VERSION 1.65U:

Version 1.65U is modified with the following new features:

1. Allows user to select the format of recipe titles. The 6th line in
MC_BUSTR.CFG file must contain a line containing either "CAPTITLES=YES" which
will cause ALL recipe titles to be totally in capital letters, or
"CAPTITLES=NO" which will convert all titles to a format like "This Is A
Recipe Title".

2. Allows for pausing screen after each 20 recipes are converted so you can
see what recipes are getting converted or not to pause at all. The 7th line in
the MC_BUSTR.CFG file must contain a line containing "PAUSE=YES" to turn on
the pause feature, or "PAUSE=NO" to turn it off.


-- Monday, March 17, 1997 --


IMPORTANT INFORMATION .................The following topics contain
information that could be critical to your success in installing and using
your MasterCook Buster. Please take a moment to review this document. It
contains information you need to know to speed-up import of recipes from
lists, digests, and web pages. This document is the User's Guide that
accompanies the software.


Contents of this file
1. Needs
2. Installation 
2.1 Basic
2.2 Un-installing
2.3 Upgrading
3. Configuring Buster
3.1 MC_Buster.exe
3.2 MC_Buster.cfg
4. What Does Buster Produce?
4.1 Files Buster produces.
4.2 What you will do with the Busted files.
5.2 
5 . Saving a recipe to your Buster file.
5.1 If Buster is to type automatically for you:
5.1.1 Save file to match a line in Config. File.
5.1.2 From: and Date: must be at the top - Buster uses that information
5.1.3 Place file in Buster folder
5.2 Caution: Do not save using .mmf, .mxp, or .out.
6. Preparing a File to Bust
6.1 MC-Recipe digest
6.2 Recipes from the Web
7. Start Buster
7.1 Bust a file
7.2 Files Buster Creates 
7.3 Cautions
8. Getting Help
8.1 Contacting the Author
8.2 Reporting bugs etc.
9. Legal Stuff About Sharing
10. Buster-isms: A Glossary of Terms
11. Miscellaneous


1. Needs
   * Dos 5.0 or higher
   * Windows 3.1, 3.ll, or 95
   * An UnZIPing Program for mcbust17.ZIP
   * A little disk space 
   * A minimum of 150 kb for the program's files
   * A variable amount for recipe (text) files

2. Installation 

2.11 Basic Installation

   * Create a directory for BUSTER ~[a]
   * Copy the zipped file that you downloaded into your BUSTER directory
   * Unzip the file

2.12 What you get when you open zip
   * mc_bustr.exe -- the program 
   * mc_bustr.cfg -- configure buster, tels Bustert what to do
   * updates.log -- a technical history of current version
   * sample Busted file - an example of what to expect Buster to do 

~[a] Buster may be run on diskette (which will be noticeably slow) or on a zip
drive

2.2 Un-install: Delete the above four files

2.3 Upgrading

2.31 Unzip the upgrade into a temporary location.

2.32 Replace these files in your buster directory

   * mcbuster EXE
   * updates log
   * bust_how txt

2.33 CAUTION! -- The upgrade will contain a copy of mcbuster.CFG. It's up to
you to SAFEGUARD your personalized copy of this file. (In other words, you may
not want to copy the new Config. over your own.)

3. Configuring MC_Buster

3.1 MC_Buster. Exe This is the program file. It runs from the DOS prompt.
Please refer to your Windows manual or the help file for information about
running MS-dos programs from Windows.

3.2 MC_Buster.cfg (A very basic one comes with the program. See (xxxxx) for a
sample Config and possible settings, and explanation of, etc.) The
Configuration file tells MC_Buster what to do. It's a program information file
and must have the .cfg extension. It must kept be in the same file with
Buster.exec.

  You can use Notepad (Win95) or Notebook (3.1) to edit this text file. This
file must have the .CFG extension and be saved in ASCII (text-only) format
only.

3.21 Sample of Configuration file and explanations

  The Configuration file: (This is what drives the exec - tells Buster what
you want him to do): A basic one has been provided for you. Please refer to
it. All you really need in order to run Buster is the first four items at top
of Configuration file. Any other items are OPTIONS; they are simply used in
order to save you repetitive typing.

  These are the items at the top of the Config file. (See the Config. File
included in Zip.) THEY MUST BE THERE! If they aren't there, Buster will 
halt and tell you which line is in error and what you need to do to correct
the problem.

DELETE=NO -- (recommended) When BUSTER is done editing a file, it will change
     it's extension to .DON (for 'done). That way, you still have your
     original. If you don't want to keep original files, set DELETE=YES
ALLFILES=YES -- BUSTER displays a list of ALL files in the directory, as you
     Bust. If you set ALLFILES=NO the Buster will list only those files
     withOUT extensions. (if you use a system that allows no extensions, for
     example: a non-Windows environment.)
LOWERCASE=YES -- Converts ALL-CAPS to standard upper and lower case. MOMMA'S
     STRAWBERRY JAM becomes Momma's Strawberry Jam. This pertains ONLY to the
     titles. -- All ingredient lines are turned into all lower case.
MCNOTES=NO -- (recommended) If you do not want NOTES to be in MasterCook's
     notes field, then MCNOTES=NO is the option you want. NO will put the note
     at the end of the directions. YES leaves NOTES alone.
WORDWRAP=NO -- Keeps those LONG lines you see in some MasterCook recipes in
     that format. Setting this to "WORDWRAP=YES" will cause all lines over 78
     78 characters long to be broken into smaller lines.
CAPTITLES=NO -- This setting will convert all recipe titles into a format
     like "This Is A Recipe Title"; setting this to CAPTITLES=YES will 
     convert all recipe titles to cap letters "THIS IS A RECIPE TITLE".
PAUSE=YES -- Selects whether you want the program to pause after displaying
     every 20 recipes so you can view the titles as they are being converted.
     Setting this to PAUSE=NO will convert all of the recipes without pausing.
     If you have more than 20 or so recipes in your file, titles of the first
     ones will scroll off the screen.
PERSERVING=YES -- Selects whether you want to leave in the "per serving"
     information that appears at the bottom of some recipes. Setting this to
     PERSERVING=NO will eliminate those lines from the recipes.
SHOWLITERS=YES -- Determines if you want to be warned if ingredients will get
     converted into liters. This is helpful if you have some recipes where
     the little "L" is sometimes used in place of a numeral "one". Setting
     this to SHOWLITERS=NO will process liters without warning.
CAPHEADERS=YES -- Determines if you want the headers in the ingredient lines
     to be cap letters or not. Setting it to CAPHEADERS=NO will have those
     lines in all lower case.
DIGESTHEADERS=YES -- Determines if the first few heading lines of a digest
     will be included in the .MXP file, just to let you remember where and
     when the recipes came from.

EXAMPLES OF LINES YOU MIGHT USE IN CONFIG FILE:

MM,X,Posted to MM-Recipe

   (MEANS: save your file as "MM505", etc, where "505" is the digest number
Buster prints to your recipes: "Posted to MM-Recipes by JDoe@aol.com on Mar
15, 1997.)

MC,N,Posted to MC-Recipe Digest V1 #

   (Using the MC, N line above: save your file as "MC303" where "303" is the
digest number. Prints to your recipe as "Posted to MC-Recipe Digest V1#303 by
JDoe@aol.com on Mar 15, 1997.)

EL,N,Posted to EAT-L Digest 
 
   (Using the EL line above, save your file as "EL0315", where "0315" is date
of March 15. Prints to your recipe as prints as "Posted to EAT-L Digest 15 Mar
97 by JDoe@aol.com on Mar 15, 1997.)

CH,N,Posted to CHILE-HEADS DIGEST V3 #

   (Using the CH, N line above, save file as "CH263" where "263" is the digest
number. Prints to your recipe as "Posted to CHILE-HEADS DIGEST V3 #263 by
JDoe@aol.com on Mar 15, 1997.)

DAVE,D,Posted to Recipe Archive - 

   (Using the DAVE line above, save file as "DAVE0316" where "0316" is March
16th. Prints to your recipe as "Posted to Recipe Archive - 16 Mar 97 by
JDoe@aol.com on Mar 16, 1997.)

TNT,X,Posted to TNT Recipes 

   (Using the TNT example above, save file as anything starting with "TNT",
such as "TNT295". Prints to your recipe as "Posted to TNT Recipes by
JDoe@aol.com on Mar 15, 1997.)

MISC OTHER LINES YOU COULD ADD TO CONFIG FILE:

FF,N,Posted to fatfree digest V97 #
LF,N,Posted to Digest eat-lf.v097.n
JW,N,Posted to JEWISH-FOOD digest V97 #
BQ,N,Posted to bbq-digest V5 #
GOUR,D,Posted to The Gourmet Connection Recipe Page Newsletter
MD,N,Posted to MasterCook Digest V1 #
BR,N,Posted to Digest bread-bakers.v097.n
FW,D,Posted to FOODWINE Digest 

IF YOU USE THE CONFIGURATION TO TYPE BLURBS FOR YOU, IT'S A GOOD IDEA TO KEEP
A COPY OF YOUR CONFIGURATION FILE NEXT TO YOUR COMPUTER FROM REFERENCE.
AND/OR, IF YOU WOULD LIKE TO KEEP NOTES RIGHT ON THE CONFIG FILE, JUST PREFACE
ANY NOTES TO YOURSELF WITH A # AND BUSTER WILL IGNORE THESE LINES.

EXAMPLE: 
# Prints to my file as Posted by JDoe@aol.com on June 2, 1997

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

N means Buster is to type in the volume number ( Note: if you use the N
  method, you will have to pay attention to volume number changes: e.g., V4
  will someday become V5.)
X means Buster is to only type in the sender name, date and list name
D means Buster will type in a date you specify
B means Buster is type nothing without direct input from you

  The words that follow the N, X, D will be inserted into the sentence at the
bottom of each recipe, appended by the information the commands N,X,or D
produce.

4. What Does Buster Produce?

4.1 Buster produces up to 4 files with different extensions: .DON, .MXP, .MMF,
OUT.

   * .DON is your original file
   * .MXP is any recipes in MC format
   * .OUT is all the throw away information, like headers and extraneous text.
     (Check this file to be sure that nothing to want to keep is on it's way
     to the trash.)

4.11 CAUTION - never type extensions .mxp or into the Buster exe.

4.2 What you will do with the Busted files.

4.12 You will use the recipe files for import into your Mastercook software.

4.13 .DON and .OUT you will delete once you are sure that the recipe files are
as you want them.

4.131 Recommend that you test import the recipe files into your software
before you delete the .DON file.

5 . Saving a recipe to your Buster file.

5.1 If Buster is to type automatically for you: Buster to automatically print
sender info, assign a name of digest or list, date: Example: AFTER BUSTING
each recipe in file will have something like this at the bottom: Posted to
MC-Recipe by JDoe@aol.com on June 2, 1997.)

5.1.1 Save file to match a line in Config. File. Example: TNT302.txt

5.1.2 From: and Date: must be at the top - Buster uses that information

5.1.3 Place file in Buster folder

5.2 Caution: The following extensions are reserved by Windows, MasterCook,
and/or Buster.

   * .mxp that's a mastercook file
   * .mmm that's a meal master file 
   * .out that's a buster file

Do not name your file with these extensions or you could damage your files. 

6. Preparing Files

6.1 After file is saved, edit prior to Busting.

6.1.1 Recipe preparation and clean-up

6.1 Buster cannot undo bad formatting. You need to check for proper format.

6.2 Buster can do some cleanups, but not all. 

Example:
Here is a recipe that had problems that Buster corrected.
#5

Subject: Comments
From: Duck@Donald@aol.com
DATE: March 13, 1888

Footer: Here is one of my favorite recipes for pasta. My mother always made it.++
She brought it over from lower Transylvania. It was a traditional dish, served++
at funerals and spring dances. =20

[[[[[
PASTA A LA FRANCO=20
B: Donald Duck's mother
C: Pasta

8 oz Cream cheese
=BE Cup Grated Parmesan Cheese
=BD Cup Flour
=BD Cup Water
=BE Cup Chopped Fresh Tomatoes (or sun dried)=20
Cooked Fettucini

Caution: this is NOT a real recipe
In a large saucepan, combine cream cheese, parmesan cheese, flour and
water. Stir over low heat until smooth, add tomatoes and cook for an
additional 5 minutes, add fettucini and toss lightly and serve.
]]]]]


  Actually, the original said '8ounces'. Buster can't fix that. I did, before
I busted this recipe...note that if this had been a real recipe, I would have
made further edits. Buster doesn't properly format for MasterCook : for
instance, most folks want 'chopped' to follow 'fresh tomatoes'. You still have
some edits. (AAAAH! Humans are still needed!)

AFTER BUSTING:

                      * Exported from MasterCook Buster *

                               Pasta A La Franco


Recipe By : Donald Duck's mother
Serving Size : 1 Preparation Time : 
Categories : Pasta

Amount Measure Ingredient -- Preparation Method
-------- ------------ --------------------------------
8 ounces cream cheese
3/4 cups grated parmesan cheese
1/2 cup flour
1/2 cup water
3/4 cups chopped fresh tomatoes (or sun dried)
cooked fettucini

Caution: this is NOT a real recipe
In a large saucepan, combine cream cheese, parmesan cheese, flour and 
water. Stir over low heat until smooth, add tomatoes and cook for an
additional 5 minutes, add fettucini and toss lightly and serve. 

Here is one of my favorite recipes for pasta. My mother always made it. She
brought it over from lower Transylvania. It was a traditional dish, served 
at funerals and spring dances. 

By Duck@Donald@aol.com on March 13, 1888


                  - - - - - - - - - - - - - - - - - - 


6.3 Buster cannot Bust @@@@@ format (edit into Buster Bracket method, or save
to another file)

6.4 Buster can't Bust plain text recipes until you prepare them.

6.5 

6.2.1 Generic formatting: If a recipe is in plain text you can format it using
Buster.

.MXP FORMATTING USING BUSTER: (very similar to the @@@@@ method): 

Footer: MC formatted by Jake Doe. 
Example:

Footer: MC formatted by Jake Doe <Doe@utoman.com>

[[[[[
title
B: How to Make Morning Beverages by Jackie Gleason
S: 2
C: beverage, alcohol

2 tablespoon molasses
2 cup vodka

Combine the two. Hold your nose and consume.
]]]]]


Footer: Formatted by Mimi Hines on June 2, 1997

[[[[[
Brass Cleaner Homemade Mix
B: Decorating With Style,TV Show;HGTV
S: 
C: Cleaning mixes

-- corn meal
-- little bit of table salt
-- white wine vinegar

Into cornmeal mixed with just a bit of salt, mix in enough white wine vinegar until a thick paste. Use old washrag, dip in cornmeal/vinegar mixture and rub it into the brass.
]]]]]

Buster Brackets ]]]]] must appear at bottom of last recipe in a file or "
Footer: " won't install to last recipe. AND, bottom Buster Bracket (]]]]])
MUST be followed by a hard return (a carraige return).

then run buster...

ANOTHER EXAMPLE:

Footer: 
[[[[[
TITLE
By:
Serves:
Categories:
<<<<<<<<----skip here
ingredients
ingredient
<<<<<<<<<<--- skip here
directions
]]]]]


Example of Do's and Don't when editing C.B.S.

DO (in any order) 

C:space
B:space
S:space

You must use caps. You must use colon(:). You must follow with a space. 

  (Optional: spell out Categories:, Recipe By:, Servings: and follow with
space and put comma and space between each category title)

  Buster is set to recognize several words in this field, e.g., Serves, By,
etc.(see complete list in Appendix)

  CATEGORIES: Buster will capitalize the first letter of single words only. '
salad and beans' would come out: Salads and beans.

SPACES MATTER: example C: beans, salads
Comes out: example C: Beans Salads,
but: example C: Beans Salads
Comes out: Bean

FOOTERS: There are 2 kinds of Footers: (see Glossary and see Rules for Footer)

   1) the kind of footer you type into the exec box as you Bust,

   2)' Footer: ' example below (see Glossary for more info and see Rules for
Footer below)

Footer typed into a file directly, here is example:

Footer: Here is a recipe for croquettes, I made them a few year ago, and they are tasty. We thought lime juice++
made them even better. (See' directions' area for how this will look within a recipe.)

                            * Exported from MasterCook *

                                   Meat Croquettes

Recipe By : Culinary Arts Institute - Chicago
Serving Size : 4 Preparation Time :0:00
Categories : Appetizers Beef 

Amount Measure Ingredient -- Preparation Method
-------- ------------ --------------------------------
1 tablespoon fat
4 tablespoons flour
1 cup milk
2 cups finely ground cooked meat
2 teaspoons lemon juice
1/2 teaspoon salt
1/8 teaspoon pepper
1 teaspoon minced parsley
1 egg

Melt fat, add flour and blend.
Add milk and cook until very thick, stirring constantly.
Add meat, lemon juice seasoning and parsley.
Chill thoroughly.
Form into clylinders, pyramids or patties.
Dip into crumbs, then into slightly beaten egg mixed with 2 tablespoons water and into crumbs again.
Chill.
Fry in hot deep oil (385F) until brown.
Omit lemon juice and add 1 tablespoon mined onion.

Here is a recipe for croquettes, I made them a few year ago, and they are tasty. We thought lime juice made them even better.

- - - - - - - - - - - - - - - - - -



FOOTER RULES:

1. START a line with "Footer: " (please put a space after the colon!) into the
text file. You can put just about as much data after "Footer: " in there as
you want! It will accept a total of 1024 characters before it blows up!

  The only rule with the length of the line, is DO NOT break the line up with
<RETURN>'s...... just keep all the text on the same line, and buster will do
it's magic translating it into lines of 78 characters in length!

2. This "Footer: " line MUST appear somewhere outside of a valid recipe! Don't
put it inside the first recipe, or program won't see it! (Be careful not to
put in the Notes field of the previous recipe -- must be outside of ANY recipe
field.)

3. After the "Footer: " line is found, it will place that text (minus the word
"Footer: ") in each recipe after that. The line or paragraph will have a
2-space indent on the first line.

4. If you want to change the footer at some point in the file, just use a new
"Footer: " line, and program will pick up the new one.

5. If you want to discontinue the "Footer: " information at some point, just
place a line STARTING with "Footer:" by itself on a line, and buster will turn
Footer: off, until it encounters another Footer: line.

7.0. Busting 

7.1 Bust a file: 'Save as' for example: TNT303.txt. Place in file where Buster
and Config reside. Click on the Buster exec. You will be prompted to enter a
filename. Type: tnt303.txt and click return. (not case sensitive) Buster will
ask you if you want to add any footer. You can enter up to 77 characters here<
return>.

7.2 Exit the Buster Exec: Exit the program by 'x' in the upper right corner or
Control-Break.

7.3 Busting same file again: After you Bust, a '.TXT' file becomes' .DON'. If
you need to re-Bust a file, do exactly as you did the '.TXT' ONLY this time,
type the extension .DON. No need to delete the original .OUT and .MXP file.
Buster will overwrite them for you.

  Example: MC537.txt after Busting becomes MC537.don. SAME FILE, ONLY
EXTENSION NAME CHANGES You need to Bust it again, type: MC537.don

8. Getting help

8.1 How to contact Buster's inventor

8.11 email: Glen Hosey <ghosey@mgfairfax.rr.com>

8.12 web: URL ? ? ?

8.2 Comments, suggestions, bug reports etc., are welcome. Write:
<ghosey@mgfairfax.rr.com> Please state the version number of the buster you
are using.

9. Sharing and Disclaimer: CHECK WITH GLEN on how much of the usual disclaimer
stuff he want in there and what tone of voice here are choices

9.1 The program may be freely copied and shared among users of MasterCook
software.

9.11 We ask that you distribute the latest version of the software.

9.12 We ask that your copy include all of the files associated with this
software.

9.2 About the intended user: This software was designed primarily for
MasterCook owners. Test importing into the MasterCook software is an IMPORTANT
way of testing the recipe format for correctness. This is especially important
if you are sharing recipes with other MasterCook users. It is recommended that
users become well acquanted with busting Digests before working with
individual incoming recipes or with unformatted recipes.

legal stuff : This version of buster is distributed as Freeware. This means
you don't have to pay for this software, just enjoy it! You are not allowed to
modify this software. You may distribute it by making it available on
online-services. You may not ask money for the program itself, only for the
distribution of the program.

Use of this program is at your own risk. We are not responsible for anything
if your disk blows up.... etc

Glen Hosey reserves the right to release future versions of Buster as Freeware
or as shareware.

Support is available through the addresses listed above, whether you are a
registered user or not. Registered users receive priority treatment, of
course. E-mail will always receive the quickest response.

10. Glossary of Buster - isms

  Buster Blurb - Recipe Poster's name and date posted, etc.

  Buster Brackets - the five symbols used to format plain text recipes

  Footer: Additional information you want inserted into bottom of recipe

  Footer1 - What you type (up to 77 characters) into exec box - This puts your
words at bottom of >directions. Most often used in conjunction with ' X'
setting in Configuration file.

  Footer2 - Footer: (unlimited number of characters, but see Footer:
instructions. You type into the file you want to Bust ""Footer:<space>" and
unlimited number of words, and Buster will put all these words into each
recipe in your file. (See special "Footer:" instructions.)

  Header - The uppermost To/From area of an email 

  MC Header - the * Exported by MasterCook * (note the spacing, there must be
2 spaces in front of 'Mastercook' in order for the recipe to import)

11. Miscellaneous

MXF Header must not be changed. The spaces are important.

*  Exported from  Mastercook Buster  *

note: () = 1 SPACE SPACES MUST BE THERE TO IMPORT INTO MC COOKBOOK 

*()()Exported from()()Mastercook()()Buster()()*

There are two spaces between the "*" and "Exported" and two spaces between
"from" and "MasterCook", just because that's how MC puts it out! The entire
remainder of the line is not looked at!!!!! All I check for is "* Exported
from MasterCook"

Dates must read exactly like this and spaces matter: Wed, 01 Jan 1997 UNLESS
you change the Date: to 'DATE:'

C:, B:, S: these stand for Categories, Recipe by, Servings. Make sure ':' is
used, followed by a space or these fields will read" blank, blank, 1.

something like "all the following are valid tags for the category, 

* Categories:
* Categories
* Category:
* Category
* C:

  Note: where a colon is shown, it MUST be there.....

  ]]]]] (followed by a return and a blank line) must be at end of all
unformatted recipes in order for Buster to format and/or add Footer.

  Want to say: after you bust a digest, a quick perusal of OUT file shows you
what Buster took and didn't take and any adjustments can be made (like
cut/paste over to the Busted .mxf file).

  Notes area in .mxf must not have empty line between 2 paragraphs...Buster
will not grab after a blank line.

  After opening Buster ExeC and before typing into it, be sure that blue line
shows exec to be activated.

  Second Buster Bracket must always be follow by a carriage return.


