home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / busi / vit32.zip / VITTLES.DOC next >
Text File  |  1990-08-30  |  66KB  |  1,849 lines
  1.  
  2.  
  3.                                   VITTLES 3.0
  4.  
  5.      
  6.      
  7.      
  8.      
  9.      
  10.      
  11.      
  12.                         +---------------+
  13.                         !               !
  14.                         !    VITTLES    !
  15.                         !               !
  16.                         !  version 3.2  !
  17.                         +---------------+
  18.      
  19.      
  20.                         A Meal Management System
  21.                         Written by Tandika Star
  22.                      1990 Dimension Nine Software
  23.      
  24.      
  25.      
  26.      
  27.      This program is dedicated to working spouses, harried cooks, my
  28.      daughter, Laurie Bayne, my husband, Steve Baker, and anyone else who
  29.      hates weekly grocery shopping.
  30.      
  31.      A special thank you goes to John Nicholson of FastKode BBS and Chuck
  32.      Haynes of Casa de la Luz BBS, in Alamogordo, New Mexico for their
  33.      wonderful beta testing and helpful suggestions.
  34.      
  35.      
  36.      
  37.      
  38.      
  39.      
  40.                     VITTLES was written in Clipper. 
  41.              Clipper is a trademark of Nantucket Software. 
  42.      
  43.      
  44.      
  45.      
  46.      
  47.      
  48.      
  49.      
  50.      
  51.      
  52.      
  53.      
  54.      
  55.      
  56.      
  57.      
  58.      
  59.      
  60.      
  61.      
  62.      
  63.  
  64.                                        1
  65.  
  66.  
  67.  
  68.  
  69.                                   VITTLES 3.0
  70.  
  71.      
  72.      
  73.      
  74.      
  75.      
  76.      
  77.                    ********** REGISTRATION ********** 
  78.      
  79.      This executable program is in the public domain. This means that you
  80.      do not have to pay any type of "registration fee" to use this
  81.      program. You may place this program and documentation in your club's
  82.      library, share it with friends and upload it to bulletin board
  83.      systems.
  84.      
  85.      If you like this program and want to tell me so, or if you have any
  86.      questions or comments, I can be reached:
  87.      
  88.      Mail Correspondence:              Telephone:
  89.      
  90.      Tandika Star                      Phone: (505) 479-6720
  91.      c/o Dimension Nine Software          or: (505) 479-6725
  92.      2170 E. Tinker
  93.      Holloman AFB, NM  88330 
  94.      
  95.      Telecommunications:
  96.      
  97.      Netmail may be sent to 308/30 (Dog Canyon BBS), 308/60 (Casa De La
  98.      Luz BBS), and you may also leave messages for me (and obtain the
  99.      latest version of VITTLES) by calling the FastKode BBS: (505)
  100.      437-2280.  The sysop is John Nicholson. There is no charge to
  101.      register or download. I am also active in the FidoNet National
  102.      Cooking Echo.
  103.      
  104.      PLEASE NOTE: The source code for this program is NOT in the public
  105.      domain and is owned exclusively by Dimension 9 Software and
  106.      Consulting.
  107.      
  108.      
  109.                    ********** HISTORY ********** 
  110.      
  111.      This manual is for version 3.2 of VITTLES. Changes from previous
  112.      versions are as follows: 
  113.      
  114.      
  115.      ***** CHANGES in version 3.2
  116.      
  117.      None.
  118.      
  119.      
  120.      ***** CHANGES in version 3.1
  121.      
  122.      When you print the "table of contents page" for a recipe file, the
  123.      recipes are now in alphabetical order.
  124.      
  125.      When you use the F2 function to add an item number to a recipe the
  126.      box is now moved over further to the right so that you can see more
  127.      of the recipe text.
  128.      
  129.  
  130.                                        2
  131.  
  132.  
  133.  
  134.  
  135.                                   VITTLES 3.0
  136.  
  137.      
  138.      ***** CHANGES in version 3.0
  139.      
  140.      All of the new features in this version were added to the RECIPE
  141.      section of the program. The (H)elp has been expanded. While in the
  142.      recipe databases, you may now SEARCH for text strings. In addition, a
  143.      feature has been added to the Recipe section that will allow you to
  144.      choose an item number from a list displayed on the screen to be
  145.      entered into your recipe. (This is useful for those who are using the
  146.      Shopping and Grocery functions of VITTLES.) See the RECIPE section of
  147.      this manual for more details on these commands.
  148.      
  149.      
  150.      ***** CHANGES in version 2.3
  151.      
  152.      None.
  153.      
  154.      
  155.      ***** CHANGES in version 2.2
  156.      
  157.      All reports may be sent to the screen, printer or disk file.
  158.      
  159.      You may "batch" import from a .TXT file. See the IMPORT instructions.
  160.      
  161.      During the "Change Colors" menu selection the F-keys have been
  162.      changed to accommodate those users who have them side-by-side on the
  163.      left of the keyboard.
  164.      
  165.      The border around the alert boxes has been changed to solid, rather
  166.      than a weird character.
  167.      
  168.      While viewing a recipe, you may scroll through the instructions
  169.      portion by using [PG-UP] and [PG-DOWN] even if that portion is not
  170.      highlighted.
  171.      
  172.      
  173.      ***** CHANGES in version 2.1
  174.      
  175.      None.
  176.      
  177.      
  178.      ***** CHANGES in version 2.0
  179.      
  180.      There have been a large number of changes in the program since
  181.      version 1.1. Of them, the most significant to you would probably be:
  182.      
  183.               VITTLES WILL NOW IMPORT AND EXPORT ASCII TEXT FILES!
  184.      
  185.      You can now move a recipe from one recipe file to another. This can
  186.      be done one recipe at a time, or in batches.
  187.      
  188.      In addition: Almost all of the submenu selections have been moved
  189.      from the F-Keys to single letter key commands. (Everyone but me HATED
  190.      using the F-Keys.)
  191.      
  192.      The information on the screens is much more verbose. Instructions now
  193.      appear as you run the program. This is for those that don't R.T.F.M.
  194.      and just want to run the program right away.
  195.  
  196.                                        3
  197.  
  198.  
  199.  
  200.  
  201.                                   VITTLES 3.0
  202.  
  203.      
  204.      The system is "self-installing". You no longer have to go to the
  205.      INSTALL menu to get started. Just put VITTLES where you want it to
  206.      run, be sure you have some extra room, (VITTLES creates files the
  207.      first time you run it.) Type VITTLES at your DOS prompt and you're
  208.      off and running.
  209.      
  210.      
  211.      ***** CHANGES in version 1.1
  212.      
  213.      Changed print out width of recipe file from 60 characters to 70
  214.      characters so printed text matches screen better. 
  215.      
  216.      Speeded up algorithm for deleting items in the User's Shopping List,
  217.      and the Master Shopping List. 
  218.      
  219.      Added "SCRATCH SHEET" under the "MENU" options. 
  220.      
  221.      
  222.      ***** BUG FIXES in version 3.2
  223.      
  224.      When editing the AISLE categories, if the down arrow was pushed too
  225.      many times, the program aborted. This has been fixed.
  226.      
  227.      
  228.      ***** BUG FIXES in version 3.1
  229.      
  230.      In previous versions, when importing a text file, if you put the
  231.      "&&&" flag as the very first thing, or the very last thing in the
  232.      file, VITTLES locked up. This is now fixed.
  233.      
  234.      In version 3.0 when you used the F2 function to add the item number
  235.      to your recipe file, it didn't always let you scroll through the
  236.      items properly. Now you can scroll all the way through ALL the items,
  237.      not just the chosen category.
  238.      
  239.      When deleting items from the Master Grocery list, VITTLES sometimes
  240.      lost it's place and went all the way to the bottom of the file. Now
  241.      it goes to the item just before the one you deleted.
  242.      
  243.      
  244.      ***** BUG FIXES in version 3.0
  245.      
  246.      The problem with printing most things that were more than 1 page in
  247.      length has been fixed.
  248.      
  249.      
  250.      ***** BUG FIXES in version 2.3
  251.      
  252.      When choosing which device to print to, if you pressed any other key
  253.      than the displayed ones, the program crashed. This has been fixed,
  254.      and now you can only exit by pressing one of the displayed keys.
  255.      
  256.      When sending the table of contents to the printer (from a recipe
  257.      database) it would only print page 1 correctly. Thereafter, each page
  258.      had 1 listing. This has been fixed, and the pages print properly.
  259.      
  260.      When viewing a recipe, the page-down and page-up to scroll the
  261.  
  262.                                        4
  263.  
  264.  
  265.  
  266.  
  267.                                   VITTLES 3.0
  268.  
  269.      instructions portion didn't work properly all the time. Now it does.
  270.      
  271.      There were STILL some pesky messages that didn't go away when they
  272.      served their purpose. I HOPE they all do now.
  273.      
  274.      If you chose to print the table of contents to the screen (while in
  275.      the RECIPE portion of the program) AND there was only one screenful
  276.      of information, it zipped right by. Now it will pause and wait for
  277.      you to press a key.
  278.      
  279.      
  280.      ***** BUG FIXES in version 2.2
  281.      
  282.      Many of the prompts and response lines at the bottom of the screen
  283.      didn't go away when they were no longer needed. Now they do.
  284.      
  285.      
  286.      ***** BUG FIXES in version 2.1
  287.      
  288.      When choosing DELETE ALL from the SHOPPING menu, nothing was deleted
  289.      from the shopping list. Now it works!
  290.      
  291.      An error message was generated when you tried to import the 13th file
  292.      in a row. That problem has now been solved.
  293.      
  294.      
  295.      ***** BUG FIXES in version 2.0
  296.      
  297.      Fixed the problem of adding a single menu entry to the shopping list.
  298.      
  299.      
  300.      ***** BUG FIXES in version 1.1
  301.      
  302.      Fixed "VIEW RECIPE" problem where if no files are chosen from the
  303.      "Scrolling Choice Box" the "No files on data drive." "Alert Box"
  304.      appeared.
  305.      
  306.      Fixed "MASTER SHOPPING" problem where if the last item under "Soft
  307.      Drinks" was deleted, the system locked up. 
  308.      
  309.      Fixed "DEFAULTS" problem during choosing colors, where the third
  310.      group's color set made it "invisible" on many systems. 
  311.      
  312.      
  313.                    ********** KNOWN and UNKNOWN BUGS ********** 
  314.      
  315.      Bugs that have been found (and fixed!) in previous versions are
  316.      listed in the "HISTORY" section of this manual. 
  317.      
  318.      If you discover a bug in the program which causes it to abort or lock
  319.      up the computer, PLEASE let me know so I can fix it!  I will need to
  320.      know what computer, drive configuration and the sequence of events
  321.      that caused the problem. 
  322.      
  323.      Versions 3.x and 2.x of this program were developed on an EVEREX
  324.      286/12 Step computer with 2 40M hard drives, a 3.5 floppy drive and a
  325.      5.25 floppy drive. 
  326.      
  327.  
  328.                                        5
  329.  
  330.  
  331.  
  332.  
  333.                                   VITTLES 3.0
  334.  
  335.      Version 1.0 and 1.1 of this program were developed on a Zenith Z-183
  336.      laptop computer with a 20M hard disk and 3.5 floppy drive and an
  337.      external 5.25 drive.  The external drive is designated as B:.
  338.      Whenever I try to use the B drive during the DEFAULTS option and it
  339.      is turned off or doesn't have a disk in it, the system locks up and I
  340.      have to reboot.  At this time, I don't know if that is a problem with
  341.      this particular system configuration or is common to all.  A warning
  342.      has been placed in the DEFAULTS section of this documentation
  343.      reflecting this problem. 
  344.      
  345.      
  346.      
  347.                    ********** INTRODUCTION **********
  348.      
  349.      When I started back to work full time, my husband and my 16 year old
  350.      daughter took over the meal planning, shopping, and cooking.  While
  351.      my daughter's cooking skills are fine, her organization is sometimes
  352.      scattered, and items were often left off the shopping list.  It's all
  353.      right to forget to buy catsup for the hamburgers, and if you forget
  354.      the buns, you can make do with bread, but if you forget the ground
  355.      beef...@#$%&*@!  My husband was not accustomed to grocery shopping
  356.      and required a VERY specific list.  We also got tired of having the
  357.      'same old things' every couple of weeks. Being able to browse through
  358.      recipes and choose to add them to the weekly menu encouraged variety.
  359.      This program was written to help solve the problems. While it hasn't
  360.      made everything perfect, it has certainly improved the situation. 
  361.      
  362.      NOTE:  My husband says this program won't help him until it pushes
  363.      the cart, writes out the check and carries in 70% of the groceries. 
  364.      Oh well, you can't please everyone! 
  365.      
  366.      VITTLES is a database management system.  Within the program you may
  367.      keep track of how groceries are arranged in your favorite store,
  368.      create weekly menus and shopping lists, and store your favorite
  369.      recipes electronically.  The program is simple to use.  Most options
  370.      can be accessed by pressing a single key. 
  371.      
  372.      
  373.                    ********** SYSTEM REQUIREMENTS ********** 
  374.      
  375.      The minimum system requirements to run VITTLES are an MS-DOS computer
  376.      using DOS 3.1 or higher, and two disk drives. VITTLES will run quite
  377.      nicely on a hard drive and has been tested extensively on one.  A
  378.      color monitor is nice, but monochrome is adequate.  While a printer
  379.      is not absolutely necessary, VITTLES generates many printed reports
  380.      and the program is not particularly useful without one. 
  381.      
  382.      
  383.      
  384.                    ********** MANUAL CONVENTIONS ********** 
  385.      
  386.      The following conventions are used throughout this manual. Taking
  387.      time to familiarize yourself with these conventions will save you
  388.      time and confusion later on. 
  389.      
  390.      
  391.      Section titles are centered and surrounded by attention grabbing
  392.      characters: 
  393.  
  394.                                        6
  395.  
  396.  
  397.  
  398.  
  399.                                   VITTLES 3.0
  400.  
  401.      
  402.                    ********** SECTION TITLE ********** 
  403.      
  404.      This will help you find the section you want quickly. 
  405.      
  406.      
  407.      Subtitles begin at the left margin and have an attention grabber only
  408.      on the left side: 
  409.      
  410.      ***** SUBTITLE 
  411.      
  412.      
  413.      Whenever this manual is referring to a key on your computer keyboard,
  414.      it will be in shown in capital letters surrounded by square brackets.
  415.      For example: 
  416.      
  417.          [F10]     [ESC]     [ENTER]   [A]
  418.      
  419.      
  420.      Whenever you have a choice of options, they will be separated by "|".
  421.      For example: 
  422.      
  423.          [ESC|ENTER] 
  424.      
  425.      You would press ONE of the keys, either [ESC] OR [F10] OR [ENTER]. 
  426.      
  427.      
  428.      Program prompts will be shown indented on a line by themselves
  429.      exactly as they appear in the program and information to be typed in
  430.      by you will be shown in curly braces with upper case letters.  For
  431.      example:  
  432.      
  433.          FILENAME: {XXXXXXXX[ENTER]} 
  434.      
  435.      In the above example "FILENAME:" is the prompt VITTLES shows you.
  436.      "XXXXXXXX [ENTER]" indicates that you would type the filename,
  437.      followed by pressing the [ENTER] key. 
  438.      
  439.      
  440.      Types of input are indicated as follows: 
  441.      
  442.          {NNNN}         indicates numeric input 
  443.          {MM/DD/YY}     indicates a date in month/day/year format 
  444.          {XXXXXX}       indicates alphanumeric input 
  445.      
  446.      
  447.      
  448.                    ********** PROGRAM CONVENTIONS ********** 
  449.      
  450.      ***** MOVEMENT 
  451.      
  452.      [UP-ARROW|RIGHT-ARROW|LEFT-ARROW] are used throughout the program to
  453.      move between menu choices and displayed fields. 
  454.      
  455.      
  456.      ***** INFORMATION LINE 
  457.      
  458.      The bottom line of the screen is reserved as an "Information Line". 
  459.  
  460.                                        7
  461.  
  462.  
  463.  
  464.  
  465.                                   VITTLES 3.0
  466.  
  467.      It will display descriptions, error messages, optional choices and
  468.      "Highlighted Input Boxes". 
  469.      
  470.      
  471.      ***** HIGHLIGHTED INPUT BOXES 
  472.      
  473.      Whenever a "Highlighted Input Box" appears on the screen, you are
  474.      being asked to type information.  Where a default value appears in
  475.      the box, it may be selected by pressing [ENTER]. If the [INSERT] key
  476.      has been pressed, it will be noted in the upper right corner of your
  477.      screen. ([INSERT] is a toggle. Pressing it again will turn it off.) 
  478.      When [INSERT] is on, characters typed on the keyboard will be
  479.      inserted at the cursor and all characters to the left will be moved
  480.      over. When [INSERT] is off, all characters typed on the keyboard will
  481.      overwrite the characters in the box. The following key(s) perform the
  482.      indicated actions: 
  483.      
  484.          [INSERT|CTRL-V]             toggle insert mode 
  485.          [LEFT-ARROW|CTRL-S]         one character left 
  486.          [RIGHT-ARROW|CTRL-D]        one character right 
  487.          [CTRL-LEFT-ARROW|CTRL-A]    one word left 
  488.          [CTRL-RIGHT-ARROW|CTRL-F]   one word right 
  489.          [HOME]                      first character 
  490.          [END]                       last character 
  491.          [DEL]                       delete character at cursor 
  492.                                        position 
  493.          [CTRL-G|BACKSPACE]          destructive backspace 
  494.          [CTRL-H|CTRL-T]             delete word right 
  495.          [CTRL-Y]                    delete from cursor position 
  496.                                        to end 
  497.          [CTRL-U]                    restore default value 
  498.          [ENTER]                     accept the value in the box 
  499.                                        and exit 
  500.      
  501.      
  502.      ***** SCROLLING CHOICE BOXES 
  503.      
  504.      Whenever a "Scrolling Choice Box" appears on the screen, you are
  505.      being asked to select one of the items in the box.  The following
  506.      key(s) perform the indicated actions: 
  507.      
  508.          [UP-ARROW]          up one item 
  509.          [DOWN-ARROW]        down one item 
  510.          [HOME]              first item in window 
  511.          [END]               last item in window 
  512.          [PAGE-UP]           up one "window-full" 
  513.          [PAGE-DOWN]         down one "window-full" 
  514.          [CTRL-PAGE-UP]      top of choices 
  515.          [CTRL-PAGE-DOWN]    bottom of choices 
  516.          [{letter}]          next choice having the same 
  517.                                first letter 
  518.          [ESC]               abort (does not select any item) 
  519.          [ENTER]             select item 
  520.      
  521.      
  522.      ***** ALERT BOXES 
  523.      
  524.      "Alert Boxes" are used throughout the program to give you information
  525.  
  526.                                        8
  527.  
  528.  
  529.  
  530.  
  531.                                   VITTLES 3.0
  532.  
  533.      or to ask you to choose between options.  They are drawn centered on
  534.      the screen using the same colors as "Highlighted Input Boxes".  The
  535.      bottom line of the box will indicate which actions you may take.  The
  536.      box will remain on the screen until you press the requested key. 
  537.      
  538.      
  539.      
  540.                    ****** GETTING STARTED ********** 
  541.      
  542.      The first time you run VITTLES, it will generate the necessary system
  543.      files. They are: 
  544.      
  545.          SYSPARM.MEM          174 bytes 
  546.          AISLE.DBF           1507 bytes 
  547.          ASLE.NTX            2048 bytes 
  548.          CATEG.NTX           2048 bytes 
  549.          MASSHOP.DBF         3226 bytes 
  550.          ITEMNO.NTX          2048 bytes 
  551.          USHOP.DBF            529 bytes 
  552.          UITEM.NTX           2048 bytes 
  553.          MENU.DBF             268 bytes 
  554.          MDATE.NTX           2048 bytes
  555.          RECIPES.DBF          227 bytes
  556.          RECIPES.DBT          512 bytes
  557.          RECIPES.NTX         2048 bytes     Total of 18461 bytes 
  558.      
  559.      If you are using a floppy system, be sure you have enough room on the
  560.      VITTLES disk.  (And bear in mind that when you add to the data bases,
  561.      the sizes of the files will increase!) 
  562.      
  563.      
  564.      ***** FLOPPY DRIVE SYSTEM 
  565.      
  566.      Create a bootable system disk and copy the file "VITTLES.EXE" to it. 
  567.      Insert the disk into your A: drive and boot the system.  At the
  568.      system prompt type: 
  569.      
  570.          {vittles [ENTER]} 
  571.      
  572.      
  573.      ***** HARD DRIVE SYSTEM 
  574.      
  575.      Create a subdirectory for the VITTLES program by typing: 
  576.      
  577.          {md \vittles [ENTER]} 
  578.      
  579.      Copy the file "VITTLES.EXE" to this directory.  To run the program
  580.      type: 
  581.      
  582.          {cd \vittles [ENTER]}    {vittles [ENTER]} 
  583.      
  584.      
  585.      ***** THE OPENING SCREEN 
  586.      
  587.      When you run the program, the opening screen will be displayed for 20
  588.      seconds.  You may [PRESS ANY KEY] to exit sooner.  VITTLES then
  589.      proceeds to check the default system drive (A:\) for the system
  590.      files.  If this is the first time you've run VITTLES, a message will
  591.  
  592.                                        9
  593.  
  594.  
  595.  
  596.  
  597.                                   VITTLES 3.0
  598.  
  599.      be displayed telling you that it is checking the system files, and
  600.      then it will proceed to create them. 
  601.      
  602.      
  603.      ***** THE MAIN OPTIONS SCREEN 
  604.      
  605.      After the installation is completed, the "Main Options Screen" will
  606.      be displayed.  Use [RIGHT-ARROW] and [LEFT-ARROW] to move between the
  607.      menu selections.
  608.      
  609.      
  610.      
  611.                    ********** NAVIGATING THE PROGRAM ********** 
  612.      
  613.      Whenever VITTLES asks you for information in a "Highlighted Input
  614.      Box", you should press [ENTER] when you have finished typing your
  615.      response.  The following instructions assume you understand this, and
  616.      will not advise you any further when to press [ENTER] unless it is
  617.      necessary to activate one of a list of choices. 
  618.      
  619.      The "Main Options Screen" shows 7 selections across the top row: 
  620.      
  621.         UTILITY   AISLES   GROCERY   SHOPPING   RECIPES   MENU   QUIT
  622.          
  623.      Use [RIGHT-ARROW|LEFT-ARROW] to move between the selections. The
  624.      bottom line of the screen will give you a brief description of each
  625.      category. To choose an option, press [ENTER].  You may also press the
  626.      first letter of the option to make your selection. 
  627.      
  628.      A submenu will appear under each main menu, offering further
  629.      selections.  Use [UP-ARROW|DOWN-ARROW] to move between selections. To
  630.      choose an option, press [ENTER]. You may also press the first letter
  631.      of the option followed by [ENTER] to make your selection. 
  632.      
  633.      
  634.      
  635.                    ********** UTILITY **********
  636.      
  637.      If you choose UTILITY from the Main Menu, a submenu will appear with
  638.      the following choices:
  639.      
  640.          DEFAULTS       CHANGE COLORS       REBUILD INDEXES
  641.      
  642.      
  643.      ***** DEFAULTS
  644.      
  645.      Allows you to change the default drive/paths for the system files and
  646.      the recipe files.  It also allows you to change the screen colors. 
  647.      You may save your selections or use them just during this session. 
  648.      If you choose to save them, they will be the default selections every
  649.      time you boot the program until you change them again. 
  650.      
  651.      
  652.      ***** CHANGE COLORS
  653.      
  654.      Selecting this menu item will allow you to change the colors that
  655.      appear on your screen while VITTLES is running. When you exit the
  656.      program, your original colors will be restored.
  657.  
  658.                                        10
  659.  
  660.  
  661.  
  662.  
  663.                                   VITTLES 3.0
  664.  
  665.      
  666.      The following key(s) perform the indicated actions: 
  667.      
  668.          [F2]      choose main foreground (text) color 
  669.          [F3]      choose main background color 
  670.          [F4]      choose enhanced foreground (text) color 
  671.          [F5]      choose enhanced background color 
  672.          [F6]      choose unselected foreground (text) color 
  673.          [F7]      choose unselected background color 
  674.          [ESC]     exit, use old colors 
  675.          [ENTER]   exit, use new colors 
  676.      
  677.      As you press the various function keys, the colors will rotate
  678.      through the available choices.  There are 8 choices for background
  679.      colors and 16 for text.  (If you have a monochrome monitor, you will
  680.      have fewer choices.) 
  681.      
  682.      
  683.      ***** REBUILD INDEXES
  684.      
  685.      If your system files are behaving erratically or you have
  686.      inadvertently erased your index files or if you have modified your
  687.      .DBF files outside of the VITTLES program environment, you will need
  688.      to re-index your system files.
  689.      
  690.      NOTE: This option will NOT re-index your recipe databases. To do
  691.      that, choose EDIT from the RECIPES submenu. Choose the recipe file
  692.      you want to re-index. When the first recipe in the file is displayed,
  693.      press [A] to add a new record. The display will change to the new
  694.      record and display it. Now choose [D] to delete this new record.
  695.      Adding and then deleting a new record will force the database to be
  696.      re-indexed.
  697.      
  698.      
  699.      
  700.                    ********** AISLE ********** 
  701.      
  702.      The aisle database contains the category names and numbers and the
  703.      order in which the categories appear in your favorite store. The
  704.      aisle number field is the only editable field in this data base.  You
  705.      may change the order that the categories are in by changing the aisle
  706.      number (0 thru 99.)  You may put more than one category in each
  707.      aisle.  The advantage of keeping your categories in order is that
  708.      your shopping list will be printed in the order you specify. This
  709.      way, you can start at one end of the store and go down the list in
  710.      order.  (If you regularly shop at more than one grocery store, good
  711.      luck; it seems like no two are set up the same!) 
  712.      
  713.      If you choose AISLES from the Main Menu, a submenu will appear with
  714.      the following choices:
  715.      
  716.          EDIT      PRINT
  717.      
  718.      
  719.      ***** EDIT
  720.      
  721.      If you choose EDIT from the submenu, a new window will appear. The
  722.      following options perform as indicated: 
  723.  
  724.                                        11
  725.  
  726.  
  727.  
  728.  
  729.                                   VITTLES 3.0
  730.  
  731.      
  732.          [E]        edit 
  733.          [P]        print 
  734.          [ESC]      exit, return to Main Screen
  735.      
  736.          ***** [E] - EDIT 
  737.      
  738.      The only editable field is the aisle number. The "Information Line"
  739.      prompt will appear: 
  740.      
  741.          Enter new aisle number: 
  742.      
  743.      followed by a "Highlighted Input Box."  Type the desired number. 
  744.      
  745.      NOTE: Changing the order of the aisles will not affect anything
  746.      except printing the users shopping list and this display.  All other
  747.      displays will remain in the default order. 
  748.      
  749.          ***** [P] - PRINT 
  750.      
  751.      Prints a list of the categories in the order they appear on the
  752.      screen. 
  753.      
  754.      
  755.          ***** [ESC] -  EXIT TO "MAIN OPTIONS SCREEN" 
  756.      
  757.      Returns you to the "Main Options Screen". 
  758.      
  759.      
  760.      ***** PRINT
  761.      
  762.      If you choose PRINT from the submenu, a list of the categories will
  763.      be printed in the order they appear in your database. (This is the
  764.      same as choosing [P] from the EDIT window.)
  765.      
  766.      
  767.      
  768.                    ********** GROCERY **********
  769.      
  770.      The Master Grocery Database consists of 5 fields: 
  771.      
  772.          1. Item Number 
  773.          2. Unit Size 
  774.          3. Description 
  775.          4. Unit Price 
  776.          5. Multiplying Factor 
  777.      
  778.      The item numbers are assigned by VITTLES.  The "Unit Size",
  779.      "Description" and "Unit Price" fields are all editable, and may
  780.      contain any pertinent information.  The "Unit Size" field may be up
  781.      to 15 characters.  The "Description" field may contain up to 40
  782.      characters. The "Unit Price" field may be up to $99.99. The field for
  783.      the "Multiplying Factor" is either "Y" (for yes) or "N" (for no).  It
  784.      is used to calculate the number of items added to the Shopping List. 
  785.      If it is "N", the item will appear only once on the list when added
  786.      from recipes.  If it is "Y", the quantity will be incremented 
  787.      accordingly.
  788.      
  789.  
  790.                                        12
  791.  
  792.  
  793.  
  794.  
  795.                                   VITTLES 3.0
  796.  
  797.      If you choose GROCERY from the Main Menu, a submenu will appear with
  798.      the following choices:
  799.      
  800.          EDIT      PRINT
  801.      
  802.      
  803.      ***** EDIT
  804.      
  805.      If you choose EDIT from the submenu, a new window will appear on your
  806.      screen and you have the following options:
  807.      
  808.          [A]       add a new item to the list
  809.          [G]       go to a specific item number
  810.          [D]       delete the highlighted item
  811.          [P]       print the entire list
  812.          [E]       edit the highlighted information
  813.          [ESC]     exit, return to the Main Menu
  814.      
  815.      
  816.          ***** [G] = GOTO ITEM #
  817.      
  818.      Allows you to move to a specific item number.  The "Information Line"
  819.      will display the following prompt: 
  820.      
  821.          Item number: 
  822.      
  823.      followed by a "Highlighted Input Box".  Type the number of the item
  824.      you want to go to. VITTLES will then move the cursor to the requested
  825.      item number or the next closest number. 
  826.      
  827.      NOTE:  This can be very handy for moving around in your Master
  828.      Grocery List. To go to the beginning of a specific category, simply
  829.      type the number of the category at the "Highlighted Input Box". 
  830.      
  831.      
  832.          ***** [A] = ADD NEW ITEM 
  833.      
  834.      Adds a new item to the Master Grocery List. You may have up to 99
  835.      items in each category. A "Scrolling Choice Box" will appear on the
  836.      screen. [UP-ARROW|DOWN-ARROW] will allow you to move between choices.
  837.      Press [ENTER] to choose a category or [ESC] to abort.  VITTLES will
  838.      then proceed to calculate the next available item number in the
  839.      category you have selected.  The "Information Line" will display: 
  840.      
  841.          Description: 
  842.      
  843.      followed by a "Highlighted Input Box".  Type the description of the
  844.      item. VITTLES will add the new item to the database and it will be
  845.      displayed on your screen.  To edit any of the other fields, move to
  846.      the field and press [E].  The default "Multiplication Factor" is
  847.      '"Y". 
  848.      
  849.      
  850.          ***** [D] = DELETE ITEM 
  851.      
  852.      Deletes an item.  All following item numbers in the category will be
  853.      moved up to fill in the hole.  The "Information Line" will display: 
  854.      
  855.  
  856.                                        13
  857.  
  858.  
  859.  
  860.  
  861.                                   VITTLES 3.0
  862.  
  863.          Delete Item Number nnn [Y/N]: 
  864.      
  865.      followed by a "Highlighted Input Box". "nnn" is the assigned item
  866.      number. The default response is "N" and can be selected by pressing
  867.      [ENTER].  If you want to delete the item, press [Y]. 
  868.      
  869.      NOTE: You cannot delete category headings!
  870.      
  871.      (BE CAREFUL: If you have already added item numbers to your recipes,
  872.      this could cause problems!.  See HELPFUL HINTS.) 
  873.      
  874.      
  875.          ***** [E] = EDIT
  876.      
  877.      To edit a field, move the cursor to the field and press [E]. The only
  878.      way to change the item number is to move the item to another
  879.      category. A "Select Choice Box" will appear displaying the various
  880.      categories. When editing the unit size field, the "Information Line"
  881.      will display: 
  882.      
  883.          Enter New Unit Size: 
  884.      
  885.      followed by a "Highlighted Input Box".  Type the new information or
  886.      press [ENTER] without typing anything to keep the default. 
  887.      
  888.      When editing the description field, the "Information Line" will
  889.      display: 
  890.      
  891.          Enter new description: 
  892.      
  893.      followed by a "Highlighted Input Box".  Type the new information or
  894.      press [ENTER] without typing anything to keep the default. 
  895.      
  896.      When editing the unit price field, the "Information Line" will
  897.      display: 
  898.      
  899.          Enter new unit price: 
  900.      
  901.      followed by a "Highlighted Input Box".  Type the new information or
  902.      press [ENTER] without typing anything to keep the default. 
  903.      
  904.      Pressing [E] while the cursor is in the "Multiplying Factor" field
  905.      will toggle the field between "Y" and "N". 
  906.      
  907.      NOTE: You cannot edit category headings!
  908.      
  909.      
  910.          ***** [P] = PRINT
  911.      
  912.      Prints the entire master grocery list. 
  913.      
  914.      
  915.          ***** [ESC] = MAIN MENU" 
  916.      
  917.      Returns you to the "Main Options Screen".
  918.      
  919.      
  920.      ***** PRINT
  921.  
  922.                                        14
  923.  
  924.  
  925.  
  926.  
  927.                                   VITTLES 3.0
  928.  
  929.      
  930.      If you choose PRINT from the submenu, the entire Master Grocery list
  931.      will be printed. (This is the same as choosing [P] from the EDIT
  932.      window.)
  933.      
  934.      
  935.                    ********** SHOPPING ********** 
  936.      
  937.      The Shopping List is a "sub-set" of the Master Grocery list.  It
  938.      consists of the things you actually plan to purchase when you go to
  939.      the store.  
  940.      
  941.      If you choose SHOPPING  from the Main Menu, a submenu will appear on
  942.      your screen and you have the following choices:
  943.      
  944.          EDIT      DELETE ALL
  945.      
  946.      
  947.      ***** EDIT
  948.      
  949.      Use the arrow keys to move between fields and records. The following
  950.      options perform as indicated: 
  951.      
  952.          [=|+]     increment quantity 
  953.          [-]       decrement quantity 
  954.          [A]       add a new item to the list
  955.          [D]       delete item entirely 
  956.          [P]       print the list 
  957.          [ESC]     exit, return to the Main Menu 
  958.      
  959.      
  960.          ***** [=|+] = INCREMENT
  961.      
  962.      Increments the "Quantity" field by 1. The maximum value allowed in
  963.      the "Quantity" field is 99.99. You may not increment category titles.
  964.      
  965.      
  966.          ***** [-] = DECREMENT
  967.      
  968.      Decrements the "Quantity" field by 1.  If the value of the field is
  969.      already 1, the "Information Line" will display: 
  970.      
  971.          Use [D] to delete item. 
  972.      
  973.      You may not decrement category titles. 
  974.      
  975.      
  976.          ***** [A] = ADD ITEM 
  977.      
  978.      Add an item from the Master Grocery List to the Shopping List. If the
  979.      item is not on the Shopping List yet, it will be added and the
  980.      quantity will be set to 1. If the item is already on the Shopping
  981.      List and the multiplication factor field is "Y", the item will be
  982.      incremented by one. If the multiplication factor field is "N" and the
  983.      item is already on the Shopping List. Nothing will happen. A
  984.      "Scrolling Choice Box" will appear allowing you to select the item to
  985.      add to the Shopping List.  Press [ENTER] to choose an item or [ESC]
  986.      to abort.  You may not add category titles. 
  987.  
  988.                                        15
  989.  
  990.  
  991.  
  992.  
  993.                                   VITTLES 3.0
  994.  
  995.      
  996.          ***** [D] = DELETE ITEM 
  997.      
  998.      Deletes an item from the Shopping List. You may not delete category
  999.      titles. 
  1000.      
  1001.      
  1002.          ***** [P] = PRINT
  1003.      
  1004.      Prints the Shopping List. If the "Quantity" field contains a
  1005.      fractional amount, it will be rounded up to the next whole number
  1006.      before it is printed.  (My grocery store will not allow me to
  1007.      purchase 1/2 jar of peanut butter!) An estimated total cost will be
  1008.      printed at the bottom of the list.  The accuracy depends on the
  1009.      accuracy of the "Unit Price" fields in the Master Shopping List. 
  1010.      
  1011.      
  1012.          ***** [ESC] = MAIN MENU 
  1013.      
  1014.      Returns you to the "Main Options Screen". 
  1015.      
  1016.      
  1017.      ***** DELETE ALL
  1018.      
  1019.      Deletes all the old items in the Shopping List.  An "Alert Box" will
  1020.      appear giving you an opportunity to abort by pressing [ESC].  To
  1021.      continue, press [ENTER]. 
  1022.      
  1023.      
  1024.      
  1025.                    ********** RECIPES OPTIONS **********
  1026.      
  1027.      The recipe database consists of 6 fields:
  1028.      
  1029.          1. Recipe Number 
  1030.          2. Tagged (always Y or N) 
  1031.          3. Recipe Name 
  1032.          4. Key Ingredients 
  1033.          5. Source 
  1034.          6. Instructions 
  1035.      
  1036.      The "Recipe Number" field corresponds to the record number in the
  1037.      database. The "Tagged" field is used for batch operations.  The
  1038.      "Recipe name can be up to 40 characters in length.  The "Key
  1039.      Ingredients" field may have up to 30 characters. The "Source" field
  1040.      may contain up to 40 characters. The "Instructions" field may be up
  1041.      to 64K in length.  (I sure don't want to make anything that requires
  1042.      that much reading!) You may have up to 9,999 recipes in each file if
  1043.      disk space allows. 
  1044.      
  1045.      If you choose RECIPES from the Main Menu, a submenu will appear with
  1046.      the following choices:
  1047.      
  1048.          EDIT      MERGE     CREATE NEW     DELETE    IMPORT
  1049.      
  1050.      
  1051.      ***** EDIT
  1052.      
  1053.  
  1054.                                        16
  1055.  
  1056.  
  1057.  
  1058.  
  1059.                                   VITTLES 3.0
  1060.  
  1061.      This option allows you to add, modify, print and otherwise manipulate
  1062.      the selected recipe file.  If there are no recipe files on the disk,
  1063.      an "Alert Box" will appear.  Otherwise a "Scrolling Choice Box" will
  1064.      appear on the screen containing the available recipe file names. 
  1065.      Select the file you want to view. A window will open on the screen
  1066.      and you will be shown one recipe at a time, starting with the first
  1067.      recipe in the file, with as much of the instructions as fit in the
  1068.      window. The following key(s) perform the indicated actions: 
  1069.      
  1070.          [TAB|DOWN-ARROW]    next field
  1071.          [LEFT-ARROW|UP-ARROW]         previous field
  1072.          [+|=]                         next recipe
  1073.          [-]                           previous recipe
  1074.          [A]                           add a new recipe 
  1075.          [D]                           delete the recipe 
  1076.          [E]                           edit the highlighted
  1077.                                          field
  1078.          [F]                           search for a string of
  1079.                                                                       
  1080.          text                                 
  1081.          [G]                           choose the number of the
  1082.                                          recipe to view
  1083.          [H|F1]                        help                               
  1084.          [L]                           look at the                        
  1085.                                          "find" list
  1086.                                                                        
  1087.          [M]                           add this recipe to the
  1088.                                          menu file
  1089.          [P]                           print
  1090.          [S]                           add ingredients from
  1091.                                          recipe to Shopping List
  1092.          [T]                           toggles the tag between 
  1093.                                          No or Yes 
  1094.          [U]                           change ALL tag fields
  1095.                                          to "N"
  1096.          [X]                           change ALL tag fields
  1097.                                          to "Y"
  1098.          [PAGE-UP|PAGE-DOWN]           scroll thru instructions portion
  1099.          [ESC]                         exit, return to Main Menu 
  1100.      
  1101.      
  1102.          ***** [TAB|DOWN-ARROW] = NEXT FIELD 
  1103.      
  1104.      NOTE: [RIGHT-ARROW] and [DOWN-ARROW] do not appear on the list at the
  1105.      top of the EDIT window.
  1106.      
  1107.      Moves the cursor to the next field. The movement will wrap around to
  1108.      the beginning. Each field will be highlighted when the cursor is on
  1109.      it.  You cannot move the cursor to the "Recipe Number" or "Tagged"
  1110.      fields. 
  1111.      
  1112.      
  1113.          ***** [LEFT-ARROW|UP-ARROW] = PREVIOUS FIELD 
  1114.      
  1115.      NOTE: [LEFT-ARROW] and [UP-ARROW] do not appear on the list at the
  1116.      top of the EDIT window.
  1117.      
  1118.      Moves the cursor to the previous field. The movement will wrap around
  1119.  
  1120.                                        17
  1121.  
  1122.  
  1123.  
  1124.  
  1125.                                   VITTLES 3.0
  1126.  
  1127.      to the end. Each field will be highlighted when the cursor is on it.
  1128.      You cannot move the cursor to the "Recipe Number" or "Tagged" fields.
  1129.      
  1130.          ***** [+|=] = NEXT RECIPE 
  1131.      
  1132.      Displays the next recipe in the file.  If there are no more recipes,
  1133.      the "Information Line" at the bottom of the screen displays: 
  1134.      
  1135.          Bottom of file. 
  1136.      
  1137.      This display will go away when you press another key or all by itself
  1138.      in 5 seconds. 
  1139.      
  1140.      
  1141.          ***** [-] = PREVIOUS RECIPE 
  1142.      
  1143.      Displays the previous recipe in the file.  If there are no more
  1144.      recipes, the "Information Line" at the bottom of the screen displays:
  1145.      
  1146.          Top of file. 
  1147.      
  1148.      This display will go away when you press another key or all by itself
  1149.      in 5 seconds. 
  1150.      
  1151.      
  1152.          ***** [A] = ADD A NEW RECIPE
  1153.      
  1154.      Adds a new, blank recipe to the file. All new recipes are added to
  1155.      the end of the file. The recipe numbers will be calculated for you.
  1156.      The default "Tagged" field will be "N". 
  1157.      
  1158.      
  1159.          ***** [D] = DELETE THIS RECIPE 
  1160.      
  1161.      Deletes the displayed recipe. The following prompt will appear on the
  1162.      "Information Line": 
  1163.      
  1164.          Delete recipe number: n [Y/N]: 
  1165.      
  1166.      "n" is the recipe number to delete. The default response is "N". When
  1167.      you delete a recipe, the numbers move up to fill in the empty space. 
  1168.      
  1169.      
  1170.          ***** [E] = EDIT FIELD 
  1171.      
  1172.      Edit a field. To edit a field, move the highlighted bar to the field
  1173.      and press [E]. Type in the new information.  The name of the recipe
  1174.      will always be in capital letters. When you choose to edit the
  1175.      "Instructions" field, you will be allowed to scroll around the
  1176.      instructions window and edit the text.  If you are familiar with
  1177.      dBASE III or CLIPPER or WORDSTAR, you shouldn't have too much
  1178.      trouble. The following key(s) perform the indicated actions: 
  1179.      
  1180.          [UP-ARROW|CTRL-E]            up one line 
  1181.          [DOWN-ARROW|CTRL-X]          down one line 
  1182.          [LEFT-ARROW|CTRL-S]          left one character 
  1183.          [RIGHT-ARROW|CTRL-D]         right one character 
  1184.          [CTRL-LEFT-ARROW|CTRL-A]     left one word 
  1185.  
  1186.                                        18
  1187.  
  1188.  
  1189.  
  1190.  
  1191.                                   VITTLES 3.0
  1192.  
  1193.          [CTRL-RIGHT-ARROW|CTRL-F]    right one word 
  1194.          [HOME]                       beginning of current line 
  1195.          [END]                        end of current line 
  1196.          [CTRL-HOME]                  top of window 
  1197.          [CTRL-END]                   bottom of window 
  1198.          [PAGE-UP]                    up one "window" 
  1199.          [PAGE-DOWN]                  down one "window" 
  1200.          [CTRL-PAGE-UP]               top of instructions 
  1201.          [CTRL-PAGE-DOWN]             bottom of instructions 
  1202.          [CTRL-Y]                     delete line cursor is on 
  1203.          [CTRL-T]                     delete word right 
  1204.          [CTRL-B]                     reform paragraph 
  1205.          [F1]                         display help screen 
  1206.          [CTRL-W]                     stop editing, save changes 
  1207.          [ESC]                        stop editing, do not 
  1208.                                         save changes 
  1209.      
  1210.      The "@" character is special, and is reserved for adding items to the
  1211.      shopping list.  You should not use it for anything else in your
  1212.      instructions.
  1213.      
  1214.      ----------------< NEW FEATURE !!!! >------------------------
  1215.      
  1216.      If you are editing the "Instructions" area of a recipe, you can have
  1217.      VITTLES automatically fill in the item number from your master
  1218.      Grocery List! Position your cursor where you want the number to
  1219.      appear and press F2. VITTLES will display a list of categories to
  1220.      choose from. After you've chosen a category, VITTLES will display the
  1221.      list of items. When you press [ENTER] to select an item, VITTLES will
  1222.      insert the "@" and the item number right where your cursor was. This
  1223.      makes it fast and easy for those of you who are using the automated
  1224.      grocery/shopping functions.
  1225.      
  1226.      
  1227.      ----------------< NEW FEATURE !!!! >------------------------
  1228.      
  1229.          ***** [F] = FIND
  1230.      
  1231.      The screen will clear, and you will be asked for the text you want to
  1232.      search for. VITTLES does not distinguish between upper and lower case
  1233.      text. You may put different information in each field or leave some
  1234.      of them blank.
  1235.      
  1236.      After VITTLES has searched through all of the recipes in the file you
  1237.      are viewing, you will be shown a box with all of the matches listed
  1238.      by recipe number and name. To choose the one you want to look at,
  1239.      move the highlight bar to your choice and press [ENTER].
  1240.      
  1241.      
  1242.          ***** [G] = GOTO RECIPE # 
  1243.      
  1244.      The prompt: 
  1245.      
  1246.          Recipe number: 
  1247.      
  1248.      will appear on the "Information Line" followed by a "Highlighted
  1249.      Input Box".  Enter the number of the recipe you want to go to.
  1250.      VITTLES will attempt to find the recipe you requested.  If the number
  1251.  
  1252.                                        19
  1253.  
  1254.  
  1255.  
  1256.  
  1257.                                   VITTLES 3.0
  1258.  
  1259.      you type is greater than the highest recipe number, VITTLES will go
  1260.      to the last recipe in the file. 
  1261.      
  1262.      
  1263.      ----------------< NEW FEATURE !!!! >------------------------
  1264.      
  1265.          ***** [H] or [F1] = Help
  1266.          
  1267.      When you request help, VITTLES will now display a list of subjects.
  1268.      By choosing one from the list, a brief description of the available
  1269.      options and sometimes a simple explanation will be provided.
  1270.      
  1271.      
  1272.      ----------------< NEW FEATURE !!!! >------------------------
  1273.      
  1274.          ***** [L] = LOOK AT
  1275.          
  1276.      This works in conjunction with the [F]ind command. IF you have
  1277.      already searched for a text string, pressing [L] will display the
  1278.      list of recipes it found. If you have not already defined a search
  1279.      string, VITTLES will prompt you for the same information as in the
  1280.      [F]ind function.
  1281.      
  1282.      A couple of things makes VITTLES "forget" what it was looking for. If
  1283.      you [A]dd a new recipe, [D]elete a recipe or choose a different
  1284.      database to look at, you will have to give it the text you are
  1285.      searching for again.
  1286.      
  1287.          
  1288.          ***** [M] = ADD TO MENU
  1289.      
  1290.      Adds the name of the recipe, the recipe file name and the recipe
  1291.      number to the menu database.  No date or order will be assigned. 
  1292.      
  1293.      
  1294.          ***** [P] = PRINT 
  1295.      
  1296.      An "Alert Box" will be displayed offering several options. The
  1297.      following key(s) perform the indicated actions: 
  1298.      
  1299.          [C]       print a shortened list, consisting of 
  1300.                       the recipe number and the recipe name 
  1301.                       (Similar to a table of contents) 
  1302.          [A]       print all of the recipes in the file, 
  1303.                        one recipe to a page 
  1304.          [ENTER]   print the displayed recipe only 
  1305.      
  1306.      If you press [ENTER] (to print this recipe only,) you will be asked
  1307.      if you want to print to [P]rinter or [F]ile. If you choose [F], your
  1308.      recipe will be printed to a disk file. The name of this file will be
  1309.      Rnnnn.TXT. VITTLES will choose the "nnnn" (number), and will use
  1310.      sequential numbers. Files that already exist will NOT be
  1311.      over-written. VITTLES will simply go to the next consecutive number. 
  1312.      
  1313.          [ESC]     aborts from the print function 
  1314.      
  1315.      
  1316.          ***** [S] = ADD TO SHOPPING LIST 
  1317.  
  1318.                                        20
  1319.  
  1320.  
  1321.  
  1322.  
  1323.                                   VITTLES 3.0
  1324.  
  1325.      
  1326.      Add all of the specially marked items to the Shopping List.
  1327.      
  1328.      NOTE:  Before using the "S" option, read the instructions in HELPFUL
  1329.      HINTS for ADDING RECIPE INGREDIENTS TO THE SHOPPING LIST. 
  1330.      
  1331.      
  1332.          ***** [T] = TOGGLE TAGGED FIELD
  1333.      
  1334.      Toggles the "Tagged" field between "Y" (for yes) and "N" (for no). 
  1335.      
  1336.      
  1337.          ***** [U] = Untag All Recipes
  1338.      
  1339.      NOTE: This option doesn't appear on the list at the top of the EDIT
  1340.      window, but if you press [U] all of the TAG fields will be changed to
  1341.      "N" throughout the entire recipe file.
  1342.      
  1343.          ***** [X] = Tag All Recipes
  1344.      
  1345.      NOTE: This option doesn't appear on the list at the top of the EDIT
  1346.      window, but if you press [T] all of the TAG fields will be changed to
  1347.      "Y" throughout the entire recipe file.
  1348.      
  1349.          ***** [ESC] = EXIT 
  1350.      
  1351.      Returns you to the Main Menu. 
  1352.      
  1353.      
  1354.      ***** MERGE
  1355.      
  1356.      Choosing this option will allow you to move TAGGED recipe files from
  1357.      one database to another. When you choose this option from the RECIPE
  1358.      submenu, prompts will appear giving you the opportunity to choose the
  1359.      source and destination databases. Merging recipes will NOT delete
  1360.      them from the original file!
  1361.      
  1362.      
  1363.      ***** CREATE NEW
  1364.      
  1365.      This option allows you to create a new recipe file.  If you are using
  1366.      a floppy drive system, you should put a formatted disk in the data
  1367.      drive BEFORE choosing this option.  While you may have more than one
  1368.      recipe file on a floppy disk, it is not a good idea, especially if
  1369.      you plan to put a lot of recipes in each file.  The amount of space
  1370.      each recipe takes is variable depending on the length of the
  1371.      instructions. Watch your disk space carefully.  An "Alert Box" will
  1372.      appear. [ESC] will allow you to abort from this option without
  1373.      creating a new file.  When you press [ENTER] the following prompt
  1374.      will appear on the "Information Line":
  1375.      
  1376.          Filename: 
  1377.      
  1378.      followed by a "Highlighted Input Box".  Type in your file name. This
  1379.      may be any valid MS-DOS file name of 1 to 8 characters.  Do not type
  1380.      in an extension.  You may abort at this point by pressing [ENTER]
  1381.      without typing any file name. After entering the file name, an alert
  1382.      box will appear asking you to confirm your selection.  You may abort
  1383.  
  1384.                                        21
  1385.  
  1386.  
  1387.  
  1388.  
  1389.                                   VITTLES 3.0
  1390.  
  1391.      at this point by pressing [ESC].  If you choose to continue, a new
  1392.      recipe file will be created on the recipe disk/path.  An "Alert Box"
  1393.      will appear letting you know if the operation is successful or not.
  1394.      If it is, you may now add recipes to the new file. 
  1395.      
  1396.      
  1397.      ***** DELETE
  1398.      
  1399.      If you choose this option from the RECIPE submenu, you will be able
  1400.      to delete an ENTIRE recipe file ==< AND >== all of it's contents! 
  1401.      Use with discretion!
  1402.      
  1403.      ***** IMPORT
  1404.      
  1405.      
  1406.      VITTLES will now allow you to import an ASCII text file into your
  1407.      recipe database. The rules are:
  1408.      
  1409.          1. the file must have an extension of .TXT
  1410.          2. the file must be in the same directory/subdirectory
  1411.             as your recipe databases
  1412.          3. each RECIPE in the file must be less than 64K in length.
  1413.               (The size of the text file may be larger.)
  1414.      
  1415.      Follow the information printed on the screen. VITTLES will strip
  1416.      garbage characters from the file as it imports. You may have to
  1417.      reformat your paragraphs after the file is imported.
  1418.      
  1419.      You may put more than one recipe in your text file. Separate each
  1420.      recipe by the characters "&&&". They do not have to be on a line by
  1421.      themselves. Example:
  1422.      
  1423.          This is recipe #1 information.
  1424.          &&&
  1425.          This is recipe #2 information.
  1426.          &&&This is recipe #3 information.
  1427.      
  1428.      For the above example, VITTLES will create 3 recipes in the
  1429.      destination recipe database. ALL the recipes in a text file will go
  1430.      into the SAME recipe (destination) file.
  1431.      
  1432.      If you use the following format, the recipe name, main ingredients
  1433.      and the source will be filled in automatically:
  1434.      
  1435.      NAME:xxxxxxxxx     (maximum of 40 characters for the name)
  1436.      KEY:xxxxxxxx       (maximum of 30 characters for the ingredients)
  1437.      SOURCE:xxxxxx      (maximum of 40 characters for the source)
  1438.      
  1439.      You must have each item on a separate line. You must end each line
  1440.      with a carriage return. 
  1441.      
  1442.      It is not mandatory to put this information (NAME, KEY, SOURCE) in
  1443.      your text file. If you don't use it, VITTLES will fill in these
  1444.      fields with default values.
  1445.      
  1446.      
  1447.      
  1448.                    ********** MENU ********** 
  1449.  
  1450.                                        22
  1451.  
  1452.  
  1453.  
  1454.  
  1455.                                   VITTLES 3.0
  1456.  
  1457.      
  1458.      There are 5 fields in the menu database: 
  1459.      
  1460.          1. Date 
  1461.          2. Order 
  1462.          3. Description 
  1463.          4. Recipe File Name 
  1464.          5. Recipe Number 
  1465.      
  1466.      The date is represented as {mm/dd/yy} and is always 8 characters. 
  1467.      This database is sorted on the "Date" field plus "Order" field. The
  1468.      "Order" field may be from '0' to '99'. The "Description" field is the
  1469.      recipe name, or other information of your choosing.  The next two
  1470.      fields are not editable by the user.  They are filled in by pressing
  1471.      [M] while viewing recipe files. These fields are also used when
  1472.      adding items to the User's Shopping List. 
  1473.      
  1474.      If you choose MENU  from the Main Menu, a submenu will appear on your
  1475.      screen and you have the following choices:
  1476.      
  1477.          EDIT      DELETE ALL     SCRATCH SHEET
  1478.      
  1479.      
  1480.      ***** EDIT
  1481.      
  1482.      The following key(s) perform the indicated actions: 
  1483.      
  1484.          [S]       add ingredients from recipe to User's 
  1485.                      Shopping List 
  1486.          [A]       add new record 
  1487.          [D]       delete record 
  1488.          [E]       edit the highlighted field 
  1489.          [P]       print 
  1490.          [ESC]     exit, return to Main Menu 
  1491.      
  1492.      
  1493.          ***** [S] = ADD TO SHOPPING LIST
  1494.      
  1495.      Add ingredients from the recipe to the User's Shopping List. An
  1496.      "Alert Box" will be displayed offering several options. The following
  1497.      key(s) perform the indicated actions:  
  1498.      
  1499.          [ESC]     abort this option 
  1500.          [ENTER]   add the items for the highlighted record only 
  1501.          [A]       add the items from ALL the records 
  1502.          [B]       add items from records between two dates 
  1503.      
  1504.      If you do not have a hard disk drive, an "Alert Box" will appear
  1505.      prompting you to insert the needed recipe disks in the drive. If you
  1506.      choose to skip a particular disk (pressing [ESC] when asked for the
  1507.      disk) VITTLES will proceed to the next disk. 
  1508.      
  1509.      If you press [B] the "Information Line" will display the following
  1510.      prompt:
  1511.      
  1512.          First day: 
  1513.      
  1514.      followed by a "Highlighted Input Box".The default is:
  1515.  
  1516.                                        23
  1517.  
  1518.  
  1519.  
  1520.  
  1521.                                   VITTLES 3.0
  1522.  
  1523.      
  1524.          "  /  /  "
  1525.      
  1526.      which is equivalent to no date.  Type in the date using the following
  1527.      format: 
  1528.      
  1529.          {MM/DD/YY} 
  1530.      
  1531.      The "Information Line" will then display: 
  1532.      
  1533.          Last day: 
  1534.      
  1535.      followed by a "Highlighted Input Box".  The default is:
  1536.      
  1537.          "  /  /  "
  1538.      
  1539.      which is equivalent to no date.  Type in the date using the following
  1540.      format: 
  1541.      
  1542.          {MM/DD/YY} 
  1543.      
  1544.      If the "Last day" is less than the "First day" the "Information Line"
  1545.      at the bottom of the screen will display: 
  1546.      
  1547.          Date conflict. 
  1548.      
  1549.      and no items will be added to the User's Shopping List. 
  1550.      
  1551.      The length of time it takes to add the items to the User's Shopping
  1552.      List is directly proportional to the number of recipes you are
  1553.      adding.  The "Information Line" at the bottom of the screen will
  1554.      indicate the progress.  
  1555.      
  1556.      
  1557.          ***** [A] = ADD NEW ITEM
  1558.      
  1559.      Adds a new, empty record to the menu database.  You may then use [F8]
  1560.      to edit the fields. 
  1561.      
  1562.      
  1563.          ***** [D] = DELETE AN ITEM 
  1564.      
  1565.      Deletes the record the cursor is on. 
  1566.      
  1567.      
  1568.          ***** [E] = EDIT FIELD 
  1569.      
  1570.      You will not be allowed to edit the "Recipe Name" or "Recipe Number"
  1571.      fields. These fields are filled in automatically by pressing [M]
  1572.      while viewing recipe files. 
  1573.      
  1574.      To edit a field, move the cursor to that field and press [F8]. The
  1575.      "Information Line" will display a prompt asking for the new
  1576.      information, followed by a "Highlighted Input Box". Type the new
  1577.      information.  
  1578.      
  1579.      
  1580.          ***** [P] = PRINT 
  1581.  
  1582.                                        24
  1583.  
  1584.  
  1585.  
  1586.  
  1587.                                   VITTLES 3.0
  1588.  
  1589.      
  1590.      Prints records from the menu database. The "Information Line" will
  1591.      display: 
  1592.      
  1593.          First day to print: 
  1594.      
  1595.      followed by a "Highlighted Input Box".  Enter the date of the first
  1596.      day you want to be printed. The "Information Line" will then display:
  1597.      
  1598.          Last day to print: 
  1599.      
  1600.      followed by a "Highlighted Input Box".  Enter the date of the last
  1601.      day you want to be printed. 
  1602.      
  1603.      Each of the requested records will be printed on a separate line.  In
  1604.      addition to the date, the day of the week will be printed. If the
  1605.      menu item has been added from a recipe, the name of the recipe file
  1606.      and the recipe number will be printed. 
  1607.      
  1608.      
  1609.      ***** [ESC] =  EXIT 
  1610.      
  1611.      Returns you to the Main Menu.
  1612.      
  1613.      
  1614.      ***** DELETE ALL
  1615.      
  1616.      Erases all the old records in your MENU database.  An "Alert Box"
  1617.      will display a warning message and you will be given a chance to
  1618.      abort by pressing [ESC]. To continue press [ENTER]. 
  1619.      
  1620.      
  1621.      ***** SCRATCH SHEET
  1622.      
  1623.      Prints a blank menu scratch sheet that can be used to plan meals. 
  1624.      
  1625.      
  1626.      
  1627.                    ********** QUIT *********** 
  1628.      
  1629.      Choosing this option will allow you to exit the program and return to
  1630.      DOS. You may change your mind by choosing "No" from the submenu.
  1631.      
  1632.      
  1633.      
  1634.      ********** HELPFUL HINTS ********** 
  1635.      
  1636.      ***** BACKING UP YOUR FILES 
  1637.      
  1638.      The most important helpful hint I can give you is to BACK UP your
  1639.      files!  After you have gotten your master shopping list just the way
  1640.      you want it, it would be a shame to have to start all over again from
  1641.      scratch!  The same goes for your recipe files.  The cost of a disk is
  1642.      less than the value of the aggravation you will have from a lost
  1643.      file! 
  1644.      
  1645.      
  1646.      ***** DO YOUR MASTER SHOPPING LIST FIRST 
  1647.  
  1648.                                        25
  1649.  
  1650.  
  1651.  
  1652.  
  1653.                                   VITTLES 3.0
  1654.  
  1655.      
  1656.      It is a good idea to set up your master shopping list before anything
  1657.      else.  While it might seem like a lot of work, it will be worth it.
  1658.      If you are going to take advantage of adding items from recipes to
  1659.      your shopping list, you MUST do it first.  Enter all the items you
  1660.      buy on a regular basis. (You might want to go through your cupboards
  1661.      to see what you usually stock.) If you discover that you are having
  1662.      major problems getting a master grocery list set up, you can download
  1663.      one already made from the bulletin board systems listed under the
  1664.      "REGISTRATION" section of this manual. The file is called
  1665.      VITSHOP.ZIP. 
  1666.      
  1667.      
  1668.      ***** ADDING RECIPE INGREDIENTS TO THE SHOPPING LIST 
  1669.      
  1670.      Taking advantage of adding ingredients from your recipes to your
  1671.      shopping list can be very handy.  To do so, you will need to add a
  1672.      special "code" to your recipe files.  The format is as follows: 
  1673.      
  1674.                        {@ITEMNO QUANTITY} 
  1675.      
  1676.      The "@" tells the program that the following two numbers are
  1677.      important information.  The "ITEMNO" the item number from your Master
  1678.      Shopping List. The "QUANTITY" is optional. It represents the amount
  1679.      of the item you wish to add. This number can have up to 2 digits and
  1680.      2 decimal places. Examples: 
  1681.      
  1682.              RIGHT                    WRONG 
  1683.      
  1684.              @1234 6                  @1234 100 
  1685.              @1234 6.5                @1234 1.625 
  1686.              @1234 .25 
  1687.              @1234 0 
  1688.              @1234 more text 
  1689.      
  1690.      Being able to use decimal quantity amounts can be quite useful. 
  1691.      Consider onions.  We purchase them in a 5 lb. bag. I figure there are
  1692.      10 onions per bag.  If a recipe calls for "1/2 onion, chopped", I
  1693.      enter a quantity of ".05".  This works out fairly well, and we don't
  1694.      usually run out of onions. (I use this method with carrots, potatoes
  1695.      and other items that come in groups.) 
  1696.      
  1697.      If you use "0" (or leave out the quantity entirely,) VITTLES will
  1698.      make sure the item is on your list, but it will not increment the
  1699.      amount.  This is useful if you want to make sure you have paprika,
  1700.      but don't need 4 bottles of it if you've added 4 recipes that call
  1701.      for it! 
  1702.      
  1703.      You may place the "code" anywhere in your file.  I usually put it on
  1704.      the line with the list of ingredients, so I can see what I am
  1705.      referring to. If you put in an item number which is not assigned to
  1706.      anything in your master list, VITTLES will ignore it. If you choose
  1707.      to add a recipe to the shopping list that you have not "coded", don't
  1708.      worry, VITTLES will still check to see if there is anything to add,
  1709.      but nothing else will happen. 
  1710.      
  1711.      In addition, VITTLES has a special feature available to you while
  1712.      your are editing the instructions portion of a recipe. Pressing F2
  1713.  
  1714.                                        26
  1715.  
  1716.  
  1717.  
  1718.  
  1719.                                   VITTLES 3.0
  1720.  
  1721.      allows you to choose from your grocery list and enters the code for
  1722.      you automatically. See the RECIPE section of this manual for more
  1723.      details.
  1724.      
  1725.      
  1726.      ***** USING THE SCRATCH SHEET 
  1727.      
  1728.      Use the scratch sheet to plan out balanced meals before you sit down
  1729.      at the computer. (Laurie was big on desserts and main dishes, but she
  1730.      often forgot vegetables!) We punch holes in the sides of the old ones
  1731.      and save them in our recipe book. They are handy to refer back to
  1732.      when you can't decide what to put together to make a complete meal. 
  1733.      
  1734.      You could also print the scratch sheet to a disk file and then edit
  1735.      it with your favorite word processor. We've started doing this with
  1736.      suggested menus printed in magazines and cookbooks. When I can't make
  1737.      up my mind what to serve with something, I can use these menus for
  1738.      ideas!
  1739.      
  1740.      
  1741.                   ********** FINAL NOTES *********** 
  1742.      
  1743.      I hope you enjoy using VITTLES and find it useful for your menu
  1744.      planning. Used properly, it can be a very powerful program. If you
  1745.      find any bugs, have any comments, or want to establish a "recipe
  1746.      exchange", let me know. Changes and improvements in the program are
  1747.      dependent on the response of the users.
  1748.      
  1749.      
  1750.          ********** APPENDIX A - VITTLES SYSTEM FILES ********** 
  1751.      
  1752.      System files: 
  1753.      
  1754.      VITTLES.DOC   Documentation file
  1755.      VITTLES.EXE   Program
  1756.      SYSPARM.MEM   A small file containing the system
  1757.                     default parameters
  1758.      AISLE.DBF     The database containing the various product
  1759.                     categories
  1760.      ASLE.NTX      An index of the aisle order for the
  1761.                     AISLE database
  1762.      CATEG.NTX     An index of the category numbers for
  1763.                     the AISLE database.
  1764.      MASSHOP.DBF   The database containing the master
  1765.                     shopping list. 
  1766.      ITEMNO.NTX    An index of the item numbers for the 
  1767.                     MASSHOP database.
  1768.      USHOP.DBF     The database containing the user
  1769.                     shopping list
  1770.      UITEM.NTX     An index of the item numbers for the
  1771.                     USHOP database.
  1772.      MENU.DBF      The database containing the menu records.
  1773.      MDATE.NTX     An index of the menu dates and order numbers
  1774.                     for the MENU database. 
  1775.      
  1776.      The recipe files consist of the filename and the following
  1777.      extensions:
  1778.      
  1779.  
  1780.                                        27
  1781.  
  1782.  
  1783.  
  1784.  
  1785.                                   VITTLES 3.0
  1786.  
  1787.      filename.DBF    The database containing the recipe header
  1788.                       information.
  1789.      filename.DBT    The database containing the recipe
  1790.                       instructions.
  1791.      filename.NTX    An index of the recipe numbers for the
  1792.                      .DBF file. 
  1793.      
  1794.      
  1795.      
  1796.          ********** APPENDIX B - THE AISLE CATEGORIES ********** 
  1797.      
  1798.      The Aisle Categories are as follows: 
  1799.      
  1800.           1. VEGETABLES - FRESH 
  1801.           2. FRUIT - FRESH 
  1802.           3. CONDIMENTS 
  1803.           4. SALAD DRESSINGS 
  1804.           5. BAKING 
  1805.           6. CAKE MIXES 
  1806.           7. FROSTINGS 
  1807.           8. JELL-O 
  1808.           9. PUDDING 
  1809.          10. DRIED MIXES 
  1810.          11. SPICES 
  1811.          12. FRUIT - CANNED 
  1812.          13. DRINKS - JUICE 
  1813.          14. VEGETABLES - CANNED 
  1814.          15. SOUP - CANNED 
  1815.          16. SOUP - DRY 
  1816.          17. PASTA 
  1817.          18. DRY STAPLES 
  1818.          19. ETHNIC 
  1819.          20. BREAKFAST 
  1820.          21. SNACKS - MUNCHIES 
  1821.          22. BEEF 
  1822.          23. PORK 
  1823.          24. LAMB 
  1824.          25. CHICKEN 
  1825.          26. TURKEY 
  1826.          27. FISH 
  1827.          28. PAPER GOODS 
  1828.          29. TOILETRIES 
  1829.          30. MEDICINAL 
  1830.          31. CLEANING 
  1831.          32. FROZEN 
  1832.          33. VEGETABLES - FROZEN 
  1833.          34. FRUIT - FROZEN 
  1834.          35. BREAD 
  1835.          36. DAIRY 
  1836.          37. CHEESE 
  1837.          38. BABY PRODUCTS 
  1838.          39. PET SUPPLIES 
  1839.          41. DELI 
  1840.          42. MISCELLANEOUS 
  1841.          43. SOFT DRINKS 
  1842.  
  1843.  
  1844.  
  1845.  
  1846.                                        28
  1847.  
  1848.  
  1849.