home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / vrac / rms_v150.zip / README.BAK < prev    next >
Text File  |  1995-02-14  |  18KB  |  355 lines
  1.                              Recipe Management System
  2.                                   Shareware Guide
  3.  
  4.          !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  5.          !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  6.          !!!!                                                          !!!!
  7.          !!!!  The Recipe Management System is SHAREWARE NOT FREEWARE  !!!!
  8.          !!!!                                                          !!!!
  9.          !!!! After trying the Recipe Management System, if you would  !!!!
  10.          !!!! like to continue using it,  you are expected to register !!!!
  11.          !!!! your copy with the author by sending $25.00 (U.S. funds) !!!!
  12.          !!!! along with your name and address to:                     !!!!
  13.          !!!!                                                          !!!!
  14.          !!!!                Jon T. McEwen                             !!!!
  15.          !!!!                P.O. Box 15619                            !!!!
  16.          !!!!                Seattle, Washington 98115-0619            !!!!
  17.          !!!!                                                          !!!!
  18.          !!!! When you do, I will send you a users guide and a letter  !!!!
  19.          !!!! of registration that will provide you with instructions  !!!!
  20.          !!!! on how to turn off the startup screen, disable delays,   !!!!
  21.          !!!! and allow you to directly import Meal-Master recipes.    !!!!
  22.          !!!! Please distribute the Recipe Management System to your   !!!!
  23.          !!!! friends and colleagues.  When you do, please make sure   !!!!
  24.          !!!! you give them the original self-extracting file          !!!!
  25.          !!!! (RMS_V150.EXE) or, copies of the following files:        !!!!
  26.          !!!!                                                          !!!!
  27.          !!!!        RECIPE.EXE  main program file                     !!!!
  28.          !!!!        RECIPE.DAT  main database file                    !!!!
  29.          !!!!        RECIPE.IX   database index file                   !!!!
  30.          !!!!        RECIPE.CAT  recipe category list                  !!!!
  31.          !!!!        RECIPE.CFG  configuration file                    !!!!
  32.          !!!!        README.TXT  this file                             !!!!
  33.          !!!!                                                          !!!!
  34.          !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  35.          !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  36.  
  37.          THANK-YOU FOR TRYING THE RECIPE MANAGEMENT SYSTEM
  38.          The  Recipe Management  System (RMS)   is the  easiest way  yet to
  39.          store,  retrieve  and  share  your  recipes  using  your  Personal
  40.          Computer.  RMS  features   include:  character  oriented  windows,
  41.          context  sensitive  pop-up  help,  full  mouse  support and a full
  42.          featured editor for easy formatting  of preparation text. The main
  43.          difference  between  RMS  and  other  Recipe  programs is the user
  44.          interface. When you start up RMS it goes straight into the browser
  45.          where you can  scroll through all of your recipes  in one of three
  46.          orders,  Recipe Name,  Category or  Main Ingredient.  You can find
  47.          recipes by entering search criteria in any of the fields (multiple
  48.          fields  too) or  tell it  to only  browse recipes  that satisfy  a
  49.          search criteria (called a Filter). The  keys you use to browse are
  50.          the keys you're already used to, PgUp, PgDn, Up and Down arrows or
  51.          you can use  your mouse. When you find the  recipe you want, press
  52.          Enter  (or click  the mouse)  and you're  instantly in the editor.
  53.          From here  you can modify  serving sizes, quantities,  preparation
  54.          and more. To  get back to the browser,  press Ctrl+Enter. There is
  55.          much,  much  more  to  the  Recipe  Management  System, BE SURE TO
  56.          REGISTER YOUR  COPY so you can  get a copy of  the RMS Users Guide
  57.          and take full advantage of all that RMS has to offer!
  58.  
  59.                                       Page 1
  60.                              Recipe Management System
  61.                                   Shareware Guide
  62.  
  63.          REQUIREMENTS:
  64.          The  Recipe Management  System  has  the following  minimum system
  65.          requirements:  490,000 bytes  (480K) of  free conventional memory,
  66.          and one meg of free hard disk  space (to install on a hard drive).
  67.          RMS should run on any 100% compatible IBM PC under DOS or WINDOWS.
  68.  
  69.          CAPACITIES:
  70.          - Maximum ingredients per recipe:   25
  71.          - Maximum preparation size (bytes): 4,096 (4K)
  72.          - Maximum recipes per cookbook:     2,147,483,647
  73.  
  74.          INSTALLATION:
  75.          !!!!!!!!!!!! NOTE TO THOSE UPGRADING FROM 1.0 or 1.01 !!!!!!!!!!!!
  76.          If  you want  to keep  any changes  you made  to the cookbook that
  77.          comes  with  RMS  (RECIPE)  DO  NOT  COPY  OVER  THE RECIPE.DAT OR
  78.          RECIPE.IX FILES! Version 1.5 will  update the index file the first
  79.          time you open a 1.0 or 1.01 cookbook.
  80.          !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  81.  
  82.          RMS_V150.EXE is  a self extracting compressed  file. Pass the name
  83.          of the subdirectory you want RMS installed in when you call it, or
  84.          run it from the subdirectory you want it installed in for example:
  85.  
  86.                  C:\>MD C:\RECIPE
  87.                  C:\>RMS_V150 C:\RECIPE
  88.  
  89.          If you have copies of the individual files listed above, just copy
  90.          them to the desired location on your hard drive for example:
  91.  
  92.                  C:\>MD C:\RECIPE
  93.                  C:\>COPY A:*.* C:\RECIPE
  94.  
  95.  
  96.          STARTING THE PROGRAM:
  97.          The Recipe Management System can be  run from DOS by executing the
  98.          RECIPE.EXE file. If the subdirectory  you installed it in isn't in
  99.          your PATH,  move to the subdirectory  prior to calling RECIPE.EXE,
  100.          OR specify  the location when calling  (I.E. C:\RECIPE\RECIPE).
  101.  
  102.          RMS can also  be installed as a Terminate  and Stay Resident (TSR)
  103.          program so that it is available  to pop up over other DOS programs
  104.          that  may be  running by  calling  it  with a  /R parameter  (i.e.
  105.          C:\RECIPE\RECIPE /R). In it's dormant state it only occupies 6K of
  106.          memory and will swap other programs in memory out to disk when the
  107.          hot key (ALT+F1)  is pressed.
  108.  
  109.          RMS can also  be run under Windows by creating  a new program item
  110.          in the  window of your  choice and entering  the following in  the
  111.          program item dialog box:
  112.  
  113.             Description:       Recipe Mgmt System
  114.             Command line:      RECIPE.EXE
  115.             Working directory: C:\RECIPE  (or wherever you installed it)
  116.             Shortcut key:      None
  117.  
  118.                                       Page 2
  119.                              Recipe Management System
  120.                                   Shareware Guide
  121.  
  122.          TEST DRIVE:
  123.          When  you first  start up  RMS you  will see  the start-up  screen
  124.          welcoming  you to  the shareware  version. Press  enter twice  and
  125.          after a five second delay you will see the browser. It shows you a
  126.          screen  full of  recipes in  the current  cookbook in  recipe name
  127.          order. Use the PgUp and PgDn  keys to navigate through the recipes
  128.          one screen at  a time, use the up and  down arrows to navigate one
  129.          recipe at a  time. When you see a  recipe that you want to  take a
  130.          closer  look at,  just press  the Enter  key and  you'll be in the
  131.          recipe editor.  When you're done, press  Ctrl+Enter (hold down the
  132.          Ctrl  key while  you press  Enter) and  you'll be  returned to the
  133.          browser.
  134.  
  135.          Along the bottom of the screen  are the F key assignments (F1-F10)
  136.          here is a brief description of their meanings:
  137.  
  138.          F1-Help
  139.          Brings up a help window that will give you information relative to
  140.          what you are currently doing.
  141.  
  142.          F2-Add
  143.          Brings up  a blank recipe in  the recipe editor and  allows you to
  144.          add new recipes to the current cookbook.
  145.  
  146.          F3-Del
  147.          Deletes  the  current  recipe  (RMS  asks  for confirmation of the
  148.          deletion first).
  149.  
  150.          F4-Find
  151.          This allows you to search for something in the cookbook. It brings
  152.          up a blank recipe where you enter your search criteria. Fill in as
  153.          many  fields as  you want   and press  Ctrl+Enter to  initiate the
  154.          search. RMS  uses two periods  as a "wildcard"  so if you  want to
  155.          search for  a recipe whose  title started with  Chicken, you would
  156.          enter Chicken.. in the name field.  If you wanted to find a recipe
  157.          that  contained onions  and cheese  in the  ingredients, you would
  158.          move to the ingredient section and  type in ..onions.. on one line
  159.          and  ..cheese.. on  another. TIP:  If you  want to  find the  next
  160.          occurrence, just press Alt+N!
  161.  
  162.          F5-Order
  163.          By default the  browser is in recipe name order,  but you can also
  164.          browse the recipes in category  or main ingredient order. Once you
  165.          find  a recipe  whose main  ingredient is  Salmon for  example, by
  166.          pressing the F5 key you can bring together all of the other Salmon
  167.          recipes in the current cookbook!
  168.  
  169.          F6-Filter
  170.          A  filter  is  a  subset  of  recipes  that  satisfy  some  search
  171.          criteria. Enter your  search criteria the same as  for a Find (see
  172.          F4 above)  and RMS will search  through the cookbook and  show you
  173.          only the recipes meet your selection. The number of recipes in the
  174.          filter is displayed in the top right of the window.
  175.  
  176.  
  177.                                       Page 3
  178.                              Recipe Management System
  179.                                   Shareware Guide
  180.  
  181.          F7-Cfg
  182.          Here you can modify your RMS configuration to suit your needs. You
  183.          can specify  colors, printer ports  (or files), and  several other
  184.          things.
  185.  
  186.          F8-Book
  187.          This is where  you can change to a different  cookbook (or start a
  188.          new one). It presents you with  a list of cookbooks in the current
  189.          subdirectory  (any file  that ends  with .DAT)  and allows  you to
  190.          select one.
  191.  
  192.          F9-Shop
  193.          Once you have  marked recipes (see MARKING RECIPES  below) you can
  194.          tell RMS  to gather all  of the required  ingredients together and
  195.          print out a shopping list.
  196.  
  197.          F10-Pack
  198.          Packing  the  database  will  recover  space  occupied  by deleted
  199.          recipes.  Unlike  other  recipe  programs  however  (and even some
  200.          commercial  database products)  RMS will  reuse space  occupied by
  201.          deleted recipes when you add  new recipes. For this reason packing
  202.          really only  makes sense if  you have deleted  several recipes and
  203.          don't plan on adding any.
  204.  
  205.  
  206.          MARKING RECIPES:
  207.          If you  are interested in several  recipes for printing, exporting
  208.          or  printing a  shopping list,   you can  "Mark" them  by pressing
  209.          Alt+M.  You can  mark them  either from  the browser  or from  the
  210.          editor. When you  do, you will see a checkmark  to the left of the
  211.          recipe  in the  browser or  in the  Mark field  in the editor. The
  212.          number  of recipes  currently marked  will appear  in the  browser
  213.          window header.
  214.  
  215.  
  216.          IMPORTING/EXPORTING:
  217.          One of the  greatest features of RMS is the  ability to export and
  218.          import recipe files. If you want  to share a recipe you've created
  219.          with someone else,  mark it (Alt+M) and press  Alt+X. RMS will ask
  220.          you for a file name and then  write the recipe out as a structured
  221.          ASCII file.  You can give  this file to  another RMS user  who can
  222.          then  import  it  (Alt+I)  into  their  cookbook.  If  you  are  a
  223.          registered RMS  user, you can  also import files  that are in  the
  224.          Meal-Master format.  That means that  if you (or  anyone you trade
  225.          recipes  with) keeps  their recipes  in Meal-Master,  or you see a
  226.          recipe on a bulletin board that  is in the Meal-Master format, you
  227.          can import it directly into RMS!
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                       Page 4
  237.                              Recipe Management System
  238.                                   Shareware Guide
  239.  
  240.          TECHNICAL:
  241.          The Recipe  Management System uses a  balanced B-Tree algorithm to
  242.          handle the storage and retrieval  tasks. Indexes are maintained in
  243.          the .IX file  that allows RMS to quickly  and efficiently find and
  244.          retrieve recipes  (if it can use  an index). If you  are searching
  245.          for  a recipe  on a  non-indexed field  RMS searches  the cookbook
  246.          sequentially (a  task that takes  decidedly longer). Unlike  other
  247.          recipe programs, RMS always maintains the order of the recipes for
  248.          you based on  their name and there is  no restriction on duplicate
  249.          names  (you  might  have  several  Beef  Stew  recipes).  RMS will
  250.          automatically  detect problems  with the  index file  (if it  gets
  251.          deleted  for  example)  and  will  automatically  rebuild  them if
  252.          needed. But  your best protection  is always BACKUP,BACKUP,BACKUP!
  253.          There are many ways to do backup your cookbooks, if you have PKZIP
  254.          or some  other file compression  program it doesn't  take long and
  255.          minimizes  the impact  on your  hard drive.  Failing this, you can
  256.          export all of  the recipes to a text file  that can be imported if
  257.          needed  (this  results  in  a   file  that  is  smaller  than  the
  258.          corresponding .DAT file) or you can have RMS back up your cookbook
  259.          for you every  time you exit (this results in  a .BAK file that is
  260.          that same  size as the  .DAT file). If  you have RMS  back up your
  261.          cookbook and  want to use  the .BAK file  follow these steps  (the
  262.          following example assumes that the cookbook name was RECIPE):
  263.  
  264.          1) Rename the RECIPE.DAT file to X.X
  265.          2) Erase the RECIPE.IX file and rename RECIPE.BAK to RECIPE.DAT
  266.          3) Start the Recipe Management System,  it will ask if you want to
  267.             rebuild the index file, tell it yes and it will run through the
  268.             file and rebuild  the indices. Once you have  verified that the
  269.             cookbook has been recovered, you can delete the X.X file.
  270.  
  271.          The  B-Tree algorithm  has earned  a well-deserved  reputation for
  272.          speed and dependability but it's best  to be prepared. I even keep
  273.          a backup of my favorite cookbooks on separate disk in case of hard
  274.          drive failure.
  275.  
  276.  
  277.          THANK YOU:
  278.          Thank you for taking the time to try the Recipe Management System.
  279.          I decided  to   write  it  after  trying   several  shareware  and
  280.          commercial  recipe  programs  and  found  them  to  be  either too
  281.          cumbersome, too limited or too restrictive. It has taken over five
  282.          hundred hours of  programming to get RMS this  point and there are
  283.          still  more  features  I  would  like  to  add.  If  you  have any
  284.          suggestions about  features to include in  future releases, please
  285.          take  the time  to write  them down  on the following registration
  286.          form and send  them to me along with any  other comments you might
  287.          have (even if you don't want to register your copy).
  288.  
  289.  
  290.                                         Jon T. McEwen
  291.                                         2/14/95
  292.  
  293.  
  294.  
  295.                                       Page 5
  296.                              Recipe Management System
  297.                                   Shareware Guide
  298.  
  299.                                  =================
  300.                                  REGISTRATION FORM
  301.                                  =================
  302.  
  303.  
  304.          Please complete the following registration form:
  305.  
  306.  
  307.  
  308.          Name (please print) ______________________________________________
  309.  
  310.  
  311.          Address __________________________________________________________
  312.  
  313.  
  314.          City ___________________  St/Prov __________  Zip/Code ___________
  315.  
  316.  
  317.          Country (if not USA) __________________  Phone/FAX _______________
  318.  
  319.  
  320.  
  321.  
  322.          Comments _________________________________________________________
  323.  
  324.  
  325.          __________________________________________________________________
  326.  
  327.  
  328.          __________________________________________________________________
  329.  
  330.  
  331.          __________________________________________________________________
  332.  
  333.  
  334.          __________________________________________________________________
  335.  
  336.  
  337.          __________________________________________________________________
  338.  
  339.  
  340.          __________________________________________________________________
  341.  
  342.  
  343.          Enclose $25.00 and send to:
  344.  
  345.  
  346.                               Jon T. McEwen
  347.                               P.O. Box 15619
  348.                               Seattle, Washington 98115-0619
  349.  
  350.  
  351.          Thank-You in advance for your registration.
  352.  
  353.  
  354.                                       Page 6
  355.