home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / ka2_12.zip / kitchen.hlp (.txt) < prev    next >
OS/2 Help File  |  1994-11-26  |  55KB  |  1,689 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. General Help For Kitchen Assistance ΓòÉΓòÉΓòÉ
  3.  
  4.                            KITCHEN Assistant/2 Ver 1.0
  5.                         (C) Copyrighted Allan Nancoz 1994
  6.  
  7. The KA/2 main Window provide access to the many function available to maintain 
  8. and access the recipe files. Multiple recipe files can be maintain if desired. 
  9.  
  10. The recipe files is consist of four files, recipe, ingredient, group, and title 
  11. file.  A recipe(s) can be retrieved with the search function, using one or more 
  12. of the following criteria's: 
  13.  
  14. Γûá Title(s) 
  15. Γûá Group(s) 
  16. Γûá Ingredient(s) 
  17.  
  18. The search parameters allow for logical functions (and, or, not, and xor) to 
  19. provide for advance search abilities. 
  20.  
  21. The menubar at the top of the window provides access to the following 
  22. functions. 
  23.  
  24. Menu Item      Functions 
  25.  
  26. File           New, Open, Import, Export, View log 
  27.  
  28. Maintenance    Database Maintenance.  Pack, Default INI. 
  29.  
  30. Options        Default Options for KA/2. 
  31.  
  32. Help           Access to the on-line help and product information window. 
  33.  
  34. The next area contains the three search parameter entry fields, Title, Group, 
  35. Ingredient. 
  36.  
  37. The third area is a listbox that will contain the recipe that match your search 
  38. parameters or the recipes that have been imported, if the add2list option is 
  39. selected when importing recipes. One or more of these recipes can be selected 
  40. and the following function can be performed. 
  41.  
  42. Function       Description 
  43.  
  44. View           View the selected recipe(s). 
  45.  
  46. Edit           Edit the selected file(s) 
  47.  
  48. Print          Print the selected file(s) 
  49.  
  50. Delete         Delete the selected file(s) from the recipe file. 
  51.  
  52. The control buttons available in this window are: 
  53.  
  54. Control        Function 
  55.  
  56. * View         View the selected recipe(s). 
  57.  
  58. * Edit         Edit the selected file. 
  59.  
  60. * Print        Print the selected file(s). 
  61.  
  62. * Delete       Delete the selected file(s) from the database. 
  63.  
  64. New            Enter a new recipe into the database. 
  65.  
  66. Search         Begin search function. 
  67.  
  68. ** Select All  Select all recipes contain in listbox. 
  69.  
  70. DeSelect       * Deselect all recipes in listbox. 
  71.  
  72. Exit           Exit Program. 
  73.  
  74. The buttons marked with * will be disabled if their are no recipes selected in 
  75. the listbox The button marked with ** will be disabled until the listbox 
  76. contains recipes. 
  77.  
  78. Note:  MEAL-MASTER is a registered trademark of Episoft Systems. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 1.1. Search ΓòÉΓòÉΓòÉ
  82.  
  83. Search
  84.  
  85. The Search function provides the ability to find recipes that meet search 
  86. parameters you entered in on or more of the entry fields, Title, Group, and 
  87. ingredients. 
  88.  
  89. Group List Help
  90.  
  91. When making entries into the Group Search entry field, if you press the right 
  92. mouse while the mouse cursor is in the entry field, a listbox will open 
  93. containing the predefined Groups.  Select one or more groups, then press enter 
  94. (or double click with the left mouse) or press one of the logic selector button 
  95. located below the list box.  If do not use the logic buttons the groups will be 
  96. transfered the group search entry field with a space serperating them.  If you 
  97. press one of the logic buttons at the bottom, the logic operator character 
  98. selected will be inserted before each group added to the entry field. 
  99.  
  100. To close the list without adding transfering any group to the entry field, 
  101. double click on the system menu button in the upper left corner of the list 
  102. window. 
  103.  
  104. SEARCH PARAMETERS FORMAT 
  105.  
  106.    ΓûáAll searches are not case sensitive. 
  107.  
  108.    ΓûáIf a full word search is desired enclose the word(s) with leading and 
  109.    trailing spaces in quotes.  A title search for the word ham, will find the 
  110.    following recipes: 
  111.        "Baked Ham Southern Style",  "Hamburgers" 
  112.    While a search for " Ham " would only find, 
  113.        "Baked Ham Southern Style" 
  114.    and not titles that contain "Hamburgers" since the search was for Ham with a 
  115.    leading and trailing space. 
  116.  
  117.    ΓûáMultiple words that are not separated by search operators will be taken as 
  118.    a phrase. 
  119.  
  120. The search parameter can contain logical operator to perform advanced search 
  121. function. 
  122.  
  123. Operator            Description 
  124. &                   performs AND function. 
  125. |                   performs OR function. 
  126. ^                   performs a exclusive OR function. 
  127. \                   performs NOT function 
  128. ()                  Use to modify the left to right ordering of operations. 
  129.  
  130. Examples  (using title or ingredient search parameter as examples) 
  131.                blue & cheese 
  132.           This would a find recipes title such as  "Blueberry Cheesecake" 
  133.           because both "blue" AND "cheese" in the title. 
  134.  
  135.     Blue | cream 
  136. This would find the titles such as "Blueberry Cheesecake ", "Strawberry Ice 
  137. Cream" because they contain "blue" OR "cream" somewhere in the title. 
  138.  
  139.    coffee ^ cake 
  140. This would find any recipe with either coffee or cake in in the title, but 
  141. would reject recipes that had both coffee and cake in the title. Example: Rum 
  142. Cake would be found, but Coffee cake would not be found. 
  143.  
  144.    \onion & garlic 
  145. This would find recipes that did NOT contain "onion", but did contain garlic. 
  146.  
  147. For a recipe to meet the search criteria all the parameter that are specified 
  148. in the three search fields must be meet.  If the field is blank, it is ignored. 
  149.  
  150. After you enter all the search parameter that you wish to use, press the Search 
  151. button to start the search.  The button color will change to Yellow and the 
  152. text will change to "Stop". The database will be search first using the title 
  153. parameter, if specified. As each recipe that match the search parameter is 
  154. found it will be entered into the listbox, in sorted ordered and the count of 
  155. found recipes will be display in the lower left status box.  At anytime you can 
  156. cancel the search by pressing the yellow stop button. 
  157.  
  158. When the title search is completed, the group search will start.  If a title 
  159. search was specified, the group search will use the titles found by the title 
  160. search for its search.  In this case if the found title does not match the 
  161. group search parameter it will be removed from the listbox and the found count 
  162. will be reduced by 1. 
  163.  
  164. If no title search was specified, the group search will search all the recipes 
  165. in the database for matches and add them to the listbox and found count. 
  166.  
  167. After the group search is completed, the ingredient search will be performed in 
  168. the same manner as the other searches. 
  169.  
  170. The search can be cancelled at any time by pressing the "Stop" button.  Any 
  171. recipes found will remain in the list box. 
  172.  
  173. Warning: Due to a the current OS/2 limitation to the amount of text that a 
  174. listbox can contain, a search may find more recipes that can be contained in 
  175. the list box.  In this case a warning message will be displayed and the search 
  176. will stop. 
  177.  
  178. Upon completion of all the search, the Stop button will return to it's default 
  179. color and the text will go back to "Search". 
  180.  
  181. The recipes found now can be selected for further operations. 
  182.  
  183. ALL TITLES 
  184. If the All title checkbox is checked, all the titles found in the recipe file 
  185. will be placed in the list box.  Any entries in the search entry fields will be 
  186. ignored. 
  187. For a large database this may exceed the listbox limitation mentioned above. 
  188.  
  189.  
  190. ΓòÉΓòÉΓòÉ 1.2. Edit ΓòÉΓòÉΓòÉ
  191.  
  192. Recipe Editor
  193.  
  194. The Edit button will open the Recipe Editor with the current recipe displayed 
  195. ready to be modified. 
  196.  
  197. See Editor 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 1.3. Recipe Print ΓòÉΓòÉΓòÉ
  201.  
  202. View window         Prints all the selected recipes. 
  203. Editor Window       Prints the currently displayed recipe. 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ 1.4. New Recipe ΓòÉΓòÉΓòÉ
  207.  
  208. New Recipe
  209.  
  210. The New button opens the recipe editor window ready for you to entry a new 
  211. recipe.  The title edit window will be opened so that you can enter the new 
  212. recipe's title.  The title is not checked for duplicate title at this point. 
  213. The check is made when the recipe is saved. 
  214.  
  215. See Editor 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 1.5. Delete Recipe ΓòÉΓòÉΓòÉ
  219.  
  220. Recipe Delete
  221.  
  222. The delete button will be enabled whenever one or more recipes in the listbox 
  223. is selected.  When the delete button is pressed, you will be asked to confirm 
  224. the deletion request.  If you response "Yes" all the selected recipes will be 
  225. deleted from the recipe file. 
  226.  
  227. Warning: Once the recipe(s) are deleted there is no way to recover them. 
  228.  
  229. The disk space used by the deleted recipe(s) will be made available to Kitchen 
  230. Assistant/2 for new or edited recipes. To make the disk space available to 
  231. other programs on your system the Pack function will have to be run.  This 
  232. should not be neccessary, since KA/2 will reuse the space release by deleted 
  233. recipes.  If you delete a large amount of recipes and do not plan to add any 
  234. new recipes, then you may want to run the Pack function to make the space 
  235. available to other programs. 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 1.6. Select All ΓòÉΓòÉΓòÉ
  239.  
  240. Select All
  241.  
  242. The Select All Push Button will select all the recipes currently in the list 
  243. box.  This button will be disabled until the listbox contains recipes titles. 
  244.  
  245.  
  246. ΓòÉΓòÉΓòÉ 1.7. Deselect recipe(s) ΓòÉΓòÉΓòÉ
  247.  
  248. Deselect All Recipes
  249.  
  250. The DeSelect button will become enabled when one or more recipes are selected 
  251. in the listbox.  When the button is activated all recipes will be deselected. 
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ 1.8. Exit ΓòÉΓòÉΓòÉ
  255.  
  256. Program Exit
  257.  
  258. When the Exit button is push you will be prompted if you want to exit the 
  259. program.  If you response by pressing "Yes", all recipe files will be saved and 
  260. Kitchen Assistant/2 will exited. 
  261.  
  262.  
  263. ΓòÉΓòÉΓòÉ 2. File Menu ΓòÉΓòÉΓòÉ
  264.  
  265. File Menu
  266.  
  267. The file dropdown menu consist of several items that pertain to the KA/2 recipe 
  268. file handling.  Also KA/2 can be exited from this menu. 
  269.  
  270. Menu Item           Function 
  271.  
  272. New Recipe File     Create a new initialized set of recipe files. 
  273.  
  274. Open                Opens a already create recipe file and makes it the active 
  275.                     recipe file.  KA/2 can maintain as many recipes files as 
  276.                     you wish.  The only limit is your disk space. 
  277.  
  278. Import              Import recipes in three different formats. 
  279.  
  280.                     KA/2  Recipes export in the KA/2 special format.  This 
  281.                     format is not in a user readable format and is intended 
  282.                     mainly for internal use by KA/2. 
  283.  
  284.                     Formatted Text  This will import recipes in the following 
  285.                     formats:  KA/2 text, Meal-Master (tm), MasterCook II and 
  286.                     Compchef. 
  287.  
  288. Export              Exports recipes in the folowing formats. 
  289.  
  290.                     KA/2  The special KA/2 format which is not a user readable 
  291.                     format. 
  292.  
  293.                     KA/2 Text  This format is user readble and intended for 
  294.                     recipe exchange via BBS's and other email services. This 
  295.                     format can be imported by KA/2. 
  296.  
  297.                      KAMM  This format can be imported by KA/2 and Meal-Master 
  298.                     v8.x.  This will permit exchang of KA/2 recipe with 
  299.                     Meal-Master users. 
  300.  
  301. View Log            View the log for the current recipe.  The optional log is 
  302.                     maintained if it has been enabled the option notebook. 
  303.  
  304.  
  305. ΓòÉΓòÉΓòÉ 2.1. New DataBase ΓòÉΓòÉΓòÉ
  306.  
  307.                               Creating a New Recipe
  308. files
  309.  
  310. This function will create a new initialized recipe file. Enter the name of the 
  311. new recipe file you want to create without a extension.  Then press OK. 
  312.  
  313. If a recipe file already exist with the name you entered, you will be asked if 
  314. you want to delete the existing recipe file. 
  315.  
  316. Warning: If you answer Yes, all data in the existing recipe file will be lost 
  317. and a empty recipe file, with the same name will be created. 
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 2.2. Open Database ΓòÉΓòÉΓòÉ
  321.  
  322. Open Recipe File
  323.  
  324. You can open another existing recipe file.  The current recipe file will be 
  325. close and a File Dialog window will be opened with the default Drive and 
  326. Directory set.  You can change the Drive and Directory if the recipe file you 
  327. want to open is not located in the default location. The default  Path  can be 
  328. set in Option, Path. 
  329.  
  330. All the existing recipe files that are in the specified path will be displayed. 
  331. Select the recipe file that you want to open by clicking on it, then pressing 
  332. OK.  You can also just double click on the recipe file to open it.  The opened 
  333. recipe file will become the active recipe file. The active recipe file's name 
  334. will be displayed in the title bar of the main window. 
  335.  
  336. If you want to create a new recipe file,  use File, New Recipe File 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 2.3. Import Recipes ΓòÉΓòÉΓòÉ
  340.  
  341. Recipe Import
  342.  
  343. Five formats are acceptable for import into KA/2. The first two are KA/2 
  344. formats and the others are recipes formats generated by other popular recipe 
  345. management programs. 
  346.  
  347. Format 
  348.  
  349. KA                  This format is not intended to be user readable. See Export 
  350.                     Kitchen Assistant. 
  351.  
  352. KA Text             This format is in ASCII text format, that is in a readable 
  353.                     and printable form. See Export Text 
  354.  
  355. Meal-Master         Recipes that were exported by the Meal-Master (tm) Ver 6.x 
  356.                     - 8.0 program. 
  357.  
  358. MasterCook II       Recipes that were exported by the MasterCook II program. 
  359.  
  360. Compu-Chef          Recipes that were exported by the Compu-Chef program. 
  361.  
  362.  The "KA" menu item in the file, import menu will import the KA format.  All 
  363. the other formats will be imported by the "Formatted Text" menu item in the 
  364. file, import menu. These formats can be intermixed in the same import file. See 
  365. Formatted. Text 
  366.  
  367.                              Measurement Translation
  368.  
  369. When recipes are imported or edited, the unit of measure for ingredients will 
  370. be check to see that it is a 1-3 character KA/2 abbreviation.  If the unit of 
  371. measure is not abbreviation, KA/2 will attempt to convert it the standard KA/2 
  372. abbreviation.  The table below shows the units of measure and what it will be 
  373. converted to. If KA/2 does not recognize the unit of measure no conversion will 
  374. be made. The user define UOM table will be used as part of this conversion, if 
  375. there is one defined. 
  376.  
  377. KA/2      Unit of measures in imported/edited recipe 
  378. <blank>   x, - 
  379. bn        bunch, bns, bunches 
  380. can       cn, cns, cans 
  381. cg        centigram, cgs, centigrams 
  382. cl        centiliter, cls, centiliters 
  383. clv       clove, cloves 
  384. ctn       carton, ct, ctns, cartons, cts 
  385. cup       c, cups, C 
  386. dg        decigram, dgs, decigrams 
  387. dl        deciliter, dls, deciliters 
  388. dr        drop, drs, drops 
  389. ds        dash, dashs 
  390. ea        each 
  391. env       envelope, envelopes 
  392. fl        fluid ounce, fl oz, fluid ounces, fls 
  393. g         gram, gm, gr, grs, gms, grams 
  394. gal       gallon, ga, gals, gallons 
  395. in        inch, inches 
  396. kg        kilogram, kgm, kgms, kgs, kilograms 
  397. l         liter, lit, lits, liters 
  398. lb        pound, lbs, pounds 
  399. lg        large, lge 
  400. md        medium, med, m 
  401. mg        milligram, mgs, milliliters 
  402. ml        milliliter, mls, milliliters 
  403. oz        ounce, ozs, ounces 
  404. pkg       package, pk, pkgs, pks, packages 
  405. pn        pinch, pns, pinches 
  406. pt        pint, pints, pts 
  407. qt        quart, q, quarts, qts 
  408. sl        slice, sls, slices 
  409. sm        small, s 
  410. tbs       tablespoon, tb, tbls, tbsp, T 
  411. tsp       teaspoon, t, ts, teaspoons, tsps 
  412.  
  413. Recipe Error file.
  414.  
  415. When KA/2 detects a error in a recipe being imported or edited, the recipe will 
  416. be written to a file with the recipe file name and a extension of ".err".  The 
  417. file will be in KA text format.  The type of error will be in the start of 
  418. recipe header.  You can edit this file with a ASCII editor to fix the problem, 
  419. then reimport the file using the file, import, KA text function.  The type of 
  420. error that KA/2 will find that would cause a error is a duplicate title name. 
  421. In this case all you would have to do is change the title in some way such as 
  422. adding a "#2". 
  423.  
  424. Note:  Changing the title to uppercase will not work.  Title checks are done 
  425. without regard to the case of the letter in the title. 
  426.  
  427.  
  428. ΓòÉΓòÉΓòÉ 2.3.1. Import, Kitchen Assistance ΓòÉΓòÉΓòÉ
  429.  
  430.                          Import Kitchen Assistant Format
  431.  
  432. This will import recipes that were exported in the Kitchen Assistant/2 export 
  433. format.  This format is not intended to be user readable. 
  434.  
  435.  
  436. ΓòÉΓòÉΓòÉ 2.3.2. ImpFmtTxt ΓòÉΓòÉΓòÉ
  437.  
  438.                             Universal Recipe Importer
  439.  
  440. This will import recipes contained in a ASCII file in one or more of the 
  441. following text formats. 
  442.  
  443. o Kitchen Assistant 
  444. o Meal-Master 
  445. o MasterCook II 
  446. o Compu-Chef 
  447. Recipes of different formats can be intermixed in the same file.  Recipes in 
  448. formats other than the ones listed above will not be imported. 
  449.  
  450. KA/2 will determine the format that each recipe is in and import it.  Any text 
  451. that is not within valid "Start of Recipe" and "End of Recipe" marker will be 
  452. ignored. Recipes in this file can be ones that were save from sources such as 
  453. the Fidonet cooking echo messages.  Only the recipe text will be imported. 
  454.  
  455. A File Dialog window will be open with the default Drive and Directory set. 
  456. Also the file mask will be set to the import/export extension set in the 
  457. Options notebook. The default setting is "*.TXT".  You can change the default 
  458. setting in the Options notebook, Paths  The file to be imported can have any 
  459. extension.  The only requirement for the import to be successful is that the 
  460. recipes contained in the file be in valid formats of the above recipes formats. 
  461. Recipes that do not meet this requiement will not be imported. 
  462.  
  463.  
  464. ΓòÉΓòÉΓòÉ 2.3.3. Import Text ΓòÉΓòÉΓòÉ
  465.  
  466.                           Recipe Import, KA Text Format
  467.  
  468. This will import recipes that were exported in the KA text format. 
  469.  
  470. A File Dialog window will be open with the default Drive and Directory set. 
  471. Also the file mask will be set to the import/export extension set in the 
  472. Options notebook. The default setting is *.KAF.  You can change the default 
  473. setting in the Options notebook, Paths  The file to be imported can have any 
  474. extension.  The only requirement for the import to be successful is that the 
  475. recipes in the file be formatted correctly. 
  476.  
  477. CAUTION:
  478. Only use this format only to import KA text files. To import a KA Export file 
  479. use File, Import, KA. 
  480. To import Meal-Master (tm) text recipes, use File, Import, Meal-Master (tm). 
  481.  
  482. After the file to be imported has been selected, the Import Window will be 
  483. open. 
  484.  
  485.  
  486. ΓòÉΓòÉΓòÉ 2.3.3.1. Format for Kitchen Assistance Text ΓòÉΓòÉΓòÉ
  487.  
  488.                          KA/2 Text Format Specifications
  489.  
  490. A recipe in ASCII text that can be import by Kitchen Assistant/2 must conform 
  491. to the following specification. 
  492.  
  493.  1. Key word will separate sections of the recipe. 
  494.  2. All text until the start of recipe will be ignored. 
  495.  3. All Key Words must start at column 1 of the line and end with a ":". 
  496.  4. Key Words can be Upper or lower case or mixed. 
  497.  5. Text associated with the Key Word can follow on the same line as the key 
  498.     word or start on the next line. 
  499.  6. The current section is terminated when another Key Word is detected or the 
  500.     end of file is encountered.. 
  501.  7. Blank lines are ignored unless noted below. 
  502.  8. The Key Words can be in any order between the "start of recipe" line and 
  503.     the "End of Recipe" line. 
  504.  
  505. Start of Recipe          5 or more of the same characters repeated starting at 
  506.                          column 1 of the line and the words "Kitchen Assistant" 
  507.                          some where on the line after the leading repeated 
  508.                          characters. 
  509. End of recipe            5 or more of the same characters repeated starting at 
  510.                          column 1 of the line. 
  511.  
  512. Keyword             Description 
  513. Title:              Followed by the Title text. 
  514. Group:              Followed by each group(s) associated with this recipe 
  515.                     separated by a comma and a space. 
  516. Description:        Followed by the description text.  The description text is 
  517.                     not formatted in anyway. 
  518. Yield:              Followed by a numeric Qty, 1 or more spaces and then the 
  519.                     unit of measure. 
  520. Preparation Time:   Followed by the preparation time text, 
  521. Cooking Time:       Followed by the cooking time text. The preparation time and 
  522.                     the Cooking time can be on the same line. This text must 
  523.                     not exceed one line. 
  524. Source/Author:      Followed by the source text. 
  525. Ingredients:        Followed by each ingredient line or header line. 
  526.                     The Header line must be in the following format: 
  527.  
  528.                     5 or more of the same character followed by the header 
  529.                     text, followed by a optional 5 or more of the same 
  530.                     character. The leading and trailing (if used) characters 
  531.                     must be the same character. 
  532.  
  533.                     Each Ingredient line must have the following format: 
  534.  
  535.                     A Qty, (valid characters are 1234567890/ .), 2 or more 
  536.                     spaces followed by a unit of measure, abbreviated to two 
  537.                     characters, 2 or more spaces. 
  538.  
  539.                     Next will be ingredient text.  This text is free form. KA/2 
  540.                     uses the text up to the first "," or ";" as the text for 
  541.                     it's ingredient index. If you enter the ingredient text in 
  542.                     the following format the number of indexes will be reduced 
  543.                     and operation will be sped up. 
  544.                           1  c  flour, Unbleached 
  545.                     In this case only the word "flour" will be used as a 
  546.                     ingredient index. But remember that KA/2 will work fine 
  547.                     even if you leave out the comma. 
  548.  
  549.                     If the ingredient text continues on the next line, the Qty 
  550.                     field must blank or contain only a "." and Measurement 
  551.                     fields must be blank. 
  552.  
  553.                     If the ingredient does not contain a Qty or Unit of 
  554.                     measure, enter a - in the qty field.  If you do not the 
  555.                     ingredient line will be taken as a continuation line. 
  556.  
  557.                     Warning: At the current time 2 column format for 
  558.                     ingredients is not supported 
  559.  
  560.  
  561. Instructions:       Followed by the instruction text.  Instructions are stored 
  562.                     as paragraphs. The start of a paragraph will be detected if 
  563.                     a header line line is found or if a blank line is found 
  564.                     between two text lines within the instruction section. 
  565.  
  566.                     The Header line must be in the following format: 
  567.  
  568.                     5 or more characters repeated followed by the header text, 
  569.                     followed by a optional 5 or more repeated characters.  All 
  570.                     the leading and trailing (if used) characters must be the 
  571.                     same character.  This is the same format as Ingredient 
  572.                     header lines. 
  573.  
  574.                                         CAUTION:
  575.                     Blank lines are not ignored within the instruction section. 
  576.  
  577.  
  578. Nutrition           The Key Word "Nutrition:" start this section. The following 
  579.                     Sub Key words are used to located the values to be stored. 
  580.                     Sub Key Words can appear any where on the line, in any 
  581.                     order and multiple Sub Key Words can appear on a line 
  582.                     except as noted below. 
  583.  
  584.     "per:"        Must NOT be on a line with another Sub Key Word. Followed by 
  585.                   the unit of measure text. 
  586.  
  587.    "Calories:"    Followed by a numeric value. 
  588.  
  589.    "Protein:"     Followed by a numeric value. 
  590.  
  591.    "Sodium:"      Followed by a numeric value. 
  592.  
  593.    "Total Fat:"   Followed by a numeric value. 
  594.  
  595.    "Saturated Fat:" Followed by a numeric value. 
  596.  
  597.    "Cholesterol:" Followed by a numeric value. 
  598.  
  599.    "Carbohydrates:" Followed by a numeric value. 
  600. Notes:              Followed by the note text. This text is not formatted in 
  601.                     any way. 
  602.  
  603.  
  604. ΓòÉΓòÉΓòÉ 2.3.4. Recipe Import Errors ΓòÉΓòÉΓòÉ
  605.  
  606. Recipe Error file.
  607.  
  608. When KA/2 detects a error in a recipe being imported or edited, the recipe will 
  609. be written to a file with the recipe file name and a extension of ".err".  The 
  610. file will be in KA text format.  The type of error will be in the start of 
  611. recipe header.  You can edit this file with a ASCII editor to fix the problem, 
  612. then reimport the file using the file, import, KA text function.  The type of 
  613. error that KA/2 will find that would cause a error is a duplicate title name. 
  614. In this case all you would have to do is change the title in some way such as 
  615. adding a "#2". 
  616.  
  617. Note:  Changing the title to uppercase will not work.  Title checks are done 
  618. without regard to the case of the letter in the title. 
  619.  
  620.  
  621. ΓòÉΓòÉΓòÉ 2.4. Export Recipe ΓòÉΓòÉΓòÉ
  622.  
  623.                                   Recipe Export
  624.  
  625. Kitchen Assistant/2 exports recipes in three different formats. 
  626.  
  627. Format                   Description 
  628.  
  629. Kitchen Assistant/2      This format is not intended to be user readable.  It's 
  630.                          primary purpose is for internal KA/2 use or where user 
  631.                          will not read it directly.  It is designed for quicker 
  632.                          importing into KA/2. 
  633.  
  634. Text                     This format is in a readable, printable ASCII format. 
  635.                          It is intended for use where someone is going to read 
  636.                          it, such as e-mail.  KA/2 will also import this 
  637.                          format.  If the recipe is generated by some other 
  638.                          source, other than KA/2, it must comply to the KA/2 
  639.                          text format so KA/2 can use it. See Text Format for 
  640.                          further information on this format. 
  641.  
  642. KA/MM Text               This format can be imported by KA/2 or Meal-Master 
  643.                          V8.x. 
  644.  
  645.  
  646. ΓòÉΓòÉΓòÉ 2.4.1. Export Kitchen Assistance ΓòÉΓòÉΓòÉ
  647.  
  648. Export KA/2 Format
  649.  
  650. The KA/2 export format is not intended to be user readable. It is intended for 
  651. faster importing by Import, KA function and for internal use by KA/2. 
  652.  
  653. For a user readable export format see Export Text.  This format is used for 
  654. printing a recipe or for recipes being included in e-mail messages or any other 
  655. application where the recipe will be read. 
  656.  
  657.  
  658. ΓòÉΓòÉΓòÉ 2.4.2. Export Text ΓòÉΓòÉΓòÉ
  659.  
  660. Export KA/2 Text
  661.  
  662. The text format exports recipes in a readable and printable ASCII text form. 
  663. The recipe is formatted with a key word at the start of each section.  If their 
  664. is no text in a section, the key word will not be printed.  The print function 
  665. uses the same format. 
  666.  
  667. See  Text Format for a full description of the text format. 
  668.  
  669.  
  670. ΓòÉΓòÉΓòÉ 2.4.3. KA/2-MM ΓòÉΓòÉΓòÉ
  671.  
  672.                        Export KA/2/Meal-Master (tm) Format
  673.  
  674. This recipe format is designed to be imported by both Kitchen Assistant/2 and 
  675. Meal-Master V8.x.  The purpose of this format is so that Kitchen Assistant user 
  676. can exchange recipes with Meal-Master users via BBS's or other electronic 
  677. means.  This format will also enable KA/2 users on these BBS's to import the 
  678. recipe in their System and maintain the full benfits of KA/2's addition 
  679. sections. This format will be automatically import by KA/2's "Formatted Text" 
  680. in the file, import menu. 
  681.  
  682. When a recipe is exported in this format, the additional section such as 
  683. Description, Nutrition etc. are placed with the recipe instruction area.  This 
  684. is done so that Meal-Master can import the recipe.  When KA/2 imports this 
  685. format, the ka/2 section that were placed in the instruction area will be 
  686. extracted and appear in their correct position with the recipe. 
  687.  
  688. Warning: This format can be imported by Meal-Master (tm) V8.x. Other version of 
  689. Meal-Master (tm) may not work and will not be supported by this format. 
  690.  
  691.  
  692. ΓòÉΓòÉΓòÉ 2.5. View Log ΓòÉΓòÉΓòÉ
  693.  
  694. View Log
  695.  
  696. The View Log will display the contents of the log for the current recipe file. 
  697. One log entry is displayed per line.  Use the scroll bar to move through the 
  698. file. 
  699.  
  700. CONTROLS 
  701.  
  702. OK                Return to main window. 
  703.  
  704. Delete            Deletes the selected entries from the log file. 
  705.  
  706. Erase File        Deletes the log file. 
  707.  
  708.  
  709. ΓòÉΓòÉΓòÉ 3. Maintenance Menu ΓòÉΓòÉΓòÉ
  710.  
  711. Maintenance Menu
  712.  
  713. The maintenance menu provides functions to do housekeeping on the recipe 
  714. database. 
  715.  
  716. Menu Item      Function 
  717.  
  718. Default INI    Creates a default ini file. 
  719.  
  720. Pack           Compresses the recipe files and makes disk space that deleted 
  721.                recipes was using available to your system. 
  722.  
  723.  
  724. ΓòÉΓòÉΓòÉ 3.1. Create Default INI ΓòÉΓòÉΓòÉ
  725.  
  726.                                Create Default INI
  727. file
  728.  
  729. This function will create a default INI file.  You will be asked if you really 
  730. want to create the new default INI file. 
  731.  
  732. Warning: If you response Yes, your current INI file will be replaced with a new 
  733. file.  All your current option setting will be lost. 
  734.  
  735.  
  736. ΓòÉΓòÉΓòÉ 3.2. Pack Database ΓòÉΓòÉΓòÉ
  737.  
  738. Recipe File Pack
  739.  
  740. The pack function is used to release any unused space in the recipe files for 
  741. use by other programs.  When you delete or modify recipes space used by the 
  742. recipes deleted or modified are mark as available for KA/2 use. This space will 
  743. be used first by KA/2 for new or modified recipes.  The only time you may have 
  744. to use this function is if you did a large scale deletion of recipes and you 
  745. want to make the disk space available to you system. 
  746.  
  747. Note:  The pack function DOES NOT compress the KA/2 files. 
  748.  
  749. The pack procedure is done by first exporting the recipes in KA/2 format, to a 
  750. file named "<recipeFileName>.KA$", then renames the recipe files to temporary 
  751. files.  The names of these temporary file are in the log file, if you have the 
  752. log file option enabled. Next a new set of recipe files is created with the 
  753. same name as the original recipe files, then the exported file is import into 
  754. the new recipe file.  At the end all temporary are deleted.  The export file 
  755. *.KA$ is not deleted until the next pack of this recipe file. 
  756.  
  757. Warning: Packing the recipe file can take a long time if the recipe file is 
  758. large 
  759.  
  760.  
  761. ΓòÉΓòÉΓòÉ 4. Option Menu ΓòÉΓòÉΓòÉ
  762.  
  763. Options Notebook
  764.  
  765. The options notebook permits you to change the default parameters for Kitchen 
  766. Assistant/2 
  767.  
  768. Page                     Functions 
  769.  
  770. Paths                    Set the default path and recipe file name. 
  771.  
  772. Fonts                    Set the display fonts used by KA/2.. 
  773.  
  774. Printer                  Selects the printer to be used by KA/2. 
  775.  
  776. Groups                   Sets the Groups used by recipe files. 
  777.  
  778. Measures                 Sets the Unit of measure to be used in place of the 
  779.                          KA/2 standard Unit of Measure for recipe printing and 
  780.                          display. 
  781.  
  782. Ingredients              Sets the user defined ingredient list. 
  783.  
  784. Yield                    Sets the measurements used for yield and nutritional 
  785.                          information. 
  786.  
  787. Print Formats            User defined recipe formats used for print or 
  788.                          Exporting text file. 
  789.  
  790. Screen Position          Defines at what position the main window will open at 
  791.                          start up. 
  792.  
  793. Source                   Adds or append text to the source line when a recipe 
  794.                          is imported or inputted. 
  795.  
  796. Misc                     Misc. toggles that control functions of KA/2 
  797.  
  798. To exit the notebook double-click on the system menu icon in the upper left 
  799. corner of the of the notebook.  The changes you have made will not be saved 
  800. until you close the notebook. 
  801.  
  802.  
  803. ΓòÉΓòÉΓòÉ 4.1. Paths ΓòÉΓòÉΓòÉ
  804.  
  805. hp7.Paths
  806.  
  807. The paths and file extensions used by KA/2 can be set by selecting Option, 
  808. Path. 
  809.  
  810. Default Recipe           This is the recipe file that is opened when the KA/2 
  811.                          starts up. 
  812.  
  813. Working directory        This is the directory that the recipe files and other 
  814.                          files that are generated by the program are stored by 
  815.                          default.  You will be able to specify another 
  816.                          directory if you wish for most file operation. 
  817.  
  818. File Extensions          These are the default extensions that will be used for 
  819.                          Import and Export operation.  You can specify other 
  820.                          extensions when the import or export operation is 
  821.                          performed if you wish.. 
  822.  
  823.  
  824. ΓòÉΓòÉΓòÉ 4.2. Display Font ΓòÉΓòÉΓòÉ
  825.  
  826. Display Font
  827. You can change the font used for different display areas of KA/2 by selecting 
  828. Options, Font.  The currently selected font are display next to the control 
  829. buttons for each area.  The push buttons for each area are: 
  830.  
  831. Control             Function 
  832. Controls            This is the font that will used for the text that appears 
  833.                     in push buttons. 
  834. Entry Field         This is the font that will used for the text that appear 
  835.                     within entry fields. 
  836. Recipes             This is the font that will used for the text in the recipe 
  837.                     editor or viewer.  It is recommended that you choose a fix 
  838.                     font for this area.  I you use a proportional font the 
  839.                     alignment of some portions of the recipe, such as the 
  840.                     ingredient list will not be correct. 
  841. Labels              This is the font that will used for the text used for radio 
  842.                     buttons and other areas.  If the display area does not fit 
  843.                     in one of the other definitions, it will used this font for 
  844.                     display. 
  845. Tabs                This is the font that will used for the text of the options 
  846.                     notebook tabs. 
  847.  
  848. When one of the controls is selected, a font dialog will open.  Select the font 
  849. and font size you want to use for that area. 
  850.  
  851. CAUTION:
  852. Due to the size of the controls and other areas that the text appears, 
  853. selecting a large font may cause the text to be clipped. 
  854.  
  855.  
  856. ΓòÉΓòÉΓòÉ 4.3. Printer Options ΓòÉΓòÉΓòÉ
  857.  
  858. Print Parameters
  859.  
  860. You can change the recipe print parameters used by KA/2 by selecting Option, 
  861. Printer. 
  862.  
  863. Top Margin          The Top margin specified in inches. 
  864.  
  865. Left Margin         The left margin specified in inches. 
  866.  
  867. Right Margin        The right margin specified in inches. 
  868.  
  869. Bottom Margin       The bottom margin specified in inches. 
  870.  
  871. Printer             The printer that KA/2 will used to print recipes to. This 
  872.                     is a read only field.  To change the selected printer, 
  873.                     press the Printer  push button and a printer selection 
  874.                     dialog will open.  You can select from a list of printer 
  875.                     that have been define in your system.  You can also select 
  876.                     the font to use from a list of available fonts for the 
  877.                     selected printer. 
  878.  
  879. Recipe/page         If this is check KA/2 will only print one recipe to a page. 
  880.  
  881.  
  882. ΓòÉΓòÉΓòÉ 4.3.1. Printer Dialog ΓòÉΓòÉΓòÉ
  883.  
  884.                              Print Selection Dialog
  885.  
  886. The printer selection dialog is accessed via the option notebook.  Select the 
  887. printer tab and the printer parameter page will open.  The current selected 
  888. printer will be displayed in the printer box.  To change to another printer, 
  889. press the printer button and the printer section dialog will open.  You can 
  890. define a "recipe" printer if you should want a special setup to print your 
  891. recipes. 
  892.  
  893. A list of printers that are installed in the system will be displayed.  Place 
  894. the mouse cursor on the printer you want KA/2 to use and click the left mouse 
  895. button. 
  896.  
  897. To select the font that will be used, press the Fonts... button and the font 
  898. dialog will open.  Select the font, style, size and atributes you want, then 
  899. press the OK button. 
  900.  
  901. When you have made all the selection, press the OK button to save them. 
  902.  
  903.  
  904. ΓòÉΓòÉΓòÉ 4.4. Group Options ΓòÉΓòÉΓòÉ
  905.  
  906. Predefined Groups
  907.  
  908. The predefined groups for are define by selecting Options, Groups.  There are 
  909. no limited to the number of groups that a recipe file can contain.  There is a 
  910. limit of 50 fro the predefine groups.  The predefined groups will be available 
  911. in a left listbox when you are editing or creating the groups in a recipe.  New 
  912. groups entered while editing recipes are not entered into the predefined list. 
  913. If you want to add the group to the predefined list you must enter it in the 
  914. Options window. 
  915.  
  916. Recipes that are being imported will used the groups in the recipe, unless you 
  917. select to change them manually by selecting the verify option in the Import 
  918. window. 
  919.  
  920. New groups can be add to the predefined list by entering them to the top entry 
  921. field.  To delete groups from the list, select the group(s) you want to delete, 
  922. then press the delete button. 
  923.  
  924.  
  925. ΓòÉΓòÉΓòÉ 4.5. Predefined Ingredients ΓòÉΓòÉΓòÉ
  926.  
  927. Predefined Ingredients List
  928.  
  929. The ingredients can be added to the predefined ingredient list by selecting 
  930. Options, Ingredient.  There is a limit of 100 predefined ingredients.  This 
  931. list will be available when you are editing or creating a recipe.  You are not 
  932. limited to the using only the ingredients in this list.  The purpose of the 
  933. list is to provide a easy method to enter ingredients that you use often or for 
  934. any other reason such as ingredients with unusual spelling. 
  935.  
  936. Recipes that are being imported will used the ingredients contained in the 
  937. imported recipe, unless you select to change them manually by selecting the 
  938. verify option in the Import window. 
  939.  
  940. New ingredients can be add to the predefined list by entering them to the top 
  941. entry field, then pressing return. 
  942.  
  943. To delete ingredients from the list select the ingredient(s) you want to 
  944. delete, then press the delete button. 
  945.  
  946. If you try to enter more than 100 ingredients a warning message will be 
  947. displayed. 
  948.  
  949.  
  950. ΓòÉΓòÉΓòÉ 4.6. User Defined Unit of Measure ΓòÉΓòÉΓòÉ
  951.  
  952.                            User Define Unit of Measure
  953.  
  954. You can redefine the unit of measure (UOM) that will be used when displaying or 
  955. printing recipes.  The UOM that is stored in the recipe files are the standard 
  956. KA/2 UOM.  The standard UOM's will also be used when recipes are exported. This 
  957. is done to maintain exchangeablity of recipes since the user that's import a 
  958. recipes does not need to be concern with the exporter's user defined table. 
  959. For example a user in Germany can export a recipe from his KA/2 that is using 
  960. UOM that are converted to German and a KA/2 user in Sweden can import the 
  961. recipe and have the UOM display and print in Swedish, if he has set up the user 
  962. defined UOM for Swedish UOM's. 
  963.  
  964.                          How to setup User defined table
  965. When the Measure is selected in the option notebook, the User Define UOM page 
  966. will open with the first KA/2 Standard UOM display after the word "For 
  967.  
  968.  1. The user enters as the first entry in the entry field the 1-3 character 
  969.     abbreviation that will be used in place of the standard KA/2 UOM. 
  970.  2. Place a comma after this entry. 
  971.  3. Next enter the long name of this UOM ending it with a comma if more entries 
  972.     are to follow for this UOM. 
  973.  4. Next enter any other forms of this UOM that you want KA/2 to recognize. 
  974.     Remember to separate each entry with a comma. 
  975.  5. Press the Next button to define the next UOM. 
  976.  
  977. KA/2 will use the first entry in the user define UOM table as the entry in the 
  978. UOM for recipes that are displayed or printed.  If KA/2 encounters one of the 
  979. other form of the UOM that you defined it will convert it to the first entry. 
  980. The standard KA/2 UOM will be used for all recipes that are imported or 
  981. exported. 
  982.  
  983.  
  984. ΓòÉΓòÉΓòÉ 4.7. Yield Measurments ΓòÉΓòÉΓòÉ
  985.  
  986.                               Yield Unit of Measure
  987.  
  988. The predefined unit of measure for yields are set in the Options, Yield. There 
  989. is no limit to what unit of measure you use in a recipe. The number of 
  990. predefined units is limited to 20, and are used when editing or creating 
  991. recipes as a short cut.  You can use one of the predefined yield measurement or 
  992. enter some other measurement while editing recipes.  If you enter new yield 
  993. measure it will not be entered into the predefined list of yield measurements. 
  994. If your want the measurement in the predefined list, you have to enter them in 
  995. this option notebook. 
  996.  
  997. Recipes that are being imported will used the yield measurement in the import 
  998. recipe, unless you selected the verify option in the Import window.  Selecting 
  999. this option will allow you to edit the recipe as it's being imported. 
  1000.  
  1001. New yield measurement can be add to the predefined list by entering them to the 
  1002. top entry field. Then pressing enter on the keyboard. 
  1003.  
  1004. To delete groups from the list select the group(s) you want to delete, then 
  1005. press the delete button. 
  1006.  
  1007.  
  1008. ΓòÉΓòÉΓòÉ 4.8. Screen Open Position ΓòÉΓòÉΓòÉ
  1009.  
  1010.                                  Screen Position
  1011.  
  1012. You can set the screen position where you want the Main  Kitchen Assistant/2 
  1013. window to open on program start up in Options, Position. 
  1014.  
  1015. There are 9 buttons which represent the following screen positions: 
  1016.  
  1017.                      Upper Left,  Upper Center,  Upper Right
  1018.                       Middle Left, Middle,     Middle Right
  1019.                      Lower Left,  Lower Center, Lower Right
  1020.  
  1021. There is also a check box, which if check will cause the main window position 
  1022. to be saved when you exit the program.  This saved position will be used as the 
  1023. starting position the next time you load KA/2. 
  1024.  
  1025.  
  1026. ΓòÉΓòÉΓòÉ 4.9. Source ΓòÉΓòÉΓòÉ
  1027.  
  1028.                                   Recipe Source
  1029.  
  1030. The Optional Source text to be inserted into recipes can be set in Option, 
  1031. Source.  This text will be inserted into the Source/Author line of a recipe. 
  1032. The text that will be added will be a standard text line or a custom line 
  1033. defined by the user. There are two standard text lines, one for recipes 
  1034. inputted by the user, " Inputted by <RegisterName>", and one for imported 
  1035. recipes "Imported from XXXX".  XXXX will be the name of the recipe manager that 
  1036. created the recipe that's being imported.  As part of the text line a marker 
  1037. (~~) is placed at the beginning of the text.  If this marker is found in the 
  1038. Source/Author line of the imported recipe, no text will be added. 
  1039.  
  1040. Add text       If this is checked, the standard or custom text will be added 
  1041.                only if the Source/Author line in the recipe is blank. 
  1042.  
  1043. Append text    If this is checked, the standard or custom text will be appended 
  1044.                to the existing text in the Source/Author line. 
  1045.  
  1046. Custom Text    If this is check the text that you enter in the entry field will 
  1047.                be used in place of the standard text. 
  1048.  
  1049.  
  1050. ΓòÉΓòÉΓòÉ 4.10. Print/Export Text Format ΓòÉΓòÉΓòÉ
  1051.  
  1052.                                Recipe Print Format
  1053.  
  1054. Up to three user defined print/export formats can be defined in Option, Format. 
  1055.  
  1056. You select the sections you wish to include in the recipe. You can also specify 
  1057. if this format is to be used as the default format.  There is a default format 
  1058. which includes all section.  At the start of the print or export, you will be 
  1059. given the opportunity to select another format, if you have specified any of 
  1060. the user formats. 
  1061. For the format to become available you must provide a name for the format. 
  1062.  
  1063. Note:  These formats apply only to printed recipes or recipes exported in the 
  1064. text format. 
  1065.  
  1066.  
  1067. ΓòÉΓòÉΓòÉ 4.11. Options Misc Help ΓòÉΓòÉΓòÉ
  1068.  
  1069.                                  Options, Misc.
  1070.  
  1071. These setting can be made in Options, Misc. 
  1072.  
  1073. Item           Function 
  1074.  
  1075. Header Character This is the character that is used before and after a 
  1076.                ingredient or Instruction header. 
  1077.  
  1078. MMMM option    Check this box if you are exporting recipes in the 
  1079.                KA2/Meal-Master format and sending them via BBS's that does not 
  1080.                permit "---" to start a line.  Fidonet BBS's convert the 1st 
  1081.                three "---" to underscores.  This prevents Meal-Master (tm) and 
  1082.                KA/2 from importing them.  Meal-Master will accept "MMMMM" in 
  1083.                place of "-----".  KA/2 will put "MMMMM" at the start of recipe 
  1084.                header, ingredient and instruction headers to maintain the 
  1085.                ability of both KA/2 and MM to import recipes sent over these 
  1086.                BBS nets. 
  1087.  
  1088. Log File       If this is checked, a log file will be maintained in the working 
  1089.                dir.  The file name will be kitchen.log.  The log file can be 
  1090.                view by selecting the menu item, file, View Log  You can also 
  1091.                erase the file or delete entries from the file from the View Log 
  1092.                window.  Should the file size exceed 500KB a message will be 
  1093.                display when you start up KA/2 
  1094.  
  1095. New Log File   If this is checked the old log file will be erased when KA/2 
  1096.                starts up and all entries to the log file for the current 
  1097.                session will be made to a new log file. 
  1098.  
  1099. USA/Metric     This sets the default measurement conversion mode. The three 
  1100.                modes available are: 
  1101.  
  1102.    ΓûáNone     No conversion done.  Recipe is displayed, exported, or printed as 
  1103.              it is stored in the recipe file. 
  1104.  
  1105.    ΓûáUSA      The Unit of measure in the ingredient section is converted to a 
  1106.              USA measure abbreviation if the unit of is found in KA/2's table. 
  1107.  
  1108.    ΓûáMetric   The Unit of measure in the ingredient section is converted to a 
  1109.              Metric measure abbreviation if the unit of is found in KA/2's 
  1110.              table. 
  1111.  
  1112. Note:  Measure that are not found in the KA/2 table are not converted and will 
  1113.        appear as they are stored in the recipe file. 
  1114.  
  1115.  
  1116. ΓòÉΓòÉΓòÉ 5. View Window ΓòÉΓòÉΓòÉ
  1117.  
  1118.                                   Recipe Viewer
  1119.  
  1120. The view recipe window consists of two areas, the Multiline view area and the 
  1121. control buttons.  You cannot modify a recipe directly in this window.  If you 
  1122. wish to modify the recipe being viewed, press the Edit Button. 
  1123.  
  1124. Only recipes that are selected in the KA/2 main window can be viewed in this 
  1125. window. 
  1126.  
  1127. The control buttons available in this window are: 
  1128.  
  1129. Control        Function 
  1130.  
  1131. First          Moves to the first selected recipe.  This button will be 
  1132.                disabled if you are at the first selected recipe. 
  1133.  
  1134. Last           Moves to the last selected recipe.  This button will be disabled 
  1135.                if you are at the last selected recipe. 
  1136.  
  1137. Previous       Moves to the previous selected recipe.  This button will be 
  1138.                disabled if you are at the first selected recipe. 
  1139.  
  1140. Next           Moves to the next selected recipe.  This button will be disabled 
  1141.                if you are at the last selected recipe. 
  1142.  
  1143. Edit           Edit the current recipe. 
  1144.  
  1145. Print          Print the current recipe. 
  1146.  
  1147. Exit           Returns to the main window. 
  1148.  
  1149.  
  1150. ΓòÉΓòÉΓòÉ 6. Recipe Editor ΓòÉΓòÉΓòÉ
  1151.  
  1152.                                   Recipe Editor
  1153.  
  1154. The Recipe Editor is use to entered a new recipe or to modify an existing 
  1155. recipe.  The window consist of two main areas, the recipe area and the control 
  1156. area. 
  1157.  
  1158. RECIPE AREA    The recipe will be displayed in this area, along with the 
  1159.                section headings.  If you selected a new recipe a entry area 
  1160.                will be blank and the Title entry window will be opened so you 
  1161.                can enter the recipes title. There is one control button for 
  1162.                each section of the recipe. 
  1163. CONTROL AREA   The control button are use to open a editor window for the a 
  1164.                section.  The control buttons are: 
  1165.  
  1166.    Title 
  1167.    Group 
  1168.    Description 
  1169.    Ingredient 
  1170.    Instruction 
  1171.    Save 
  1172.    Preparation 
  1173.    Serving 
  1174.    Source 
  1175.    Notes 
  1176.    Nutrition 
  1177.    Cancel 
  1178.  
  1179. The entries or modification will not be saved to the recipe file until you 
  1180. press the save button.  Pressing the cancel button will not save the change you 
  1181. may have made in this editing session. 
  1182.  
  1183.  
  1184. ΓòÉΓòÉΓòÉ 6.1. Title Editor ΓòÉΓòÉΓòÉ
  1185.  
  1186.                                   Title Editor
  1187.  
  1188. If a title already exist for the recipe being edited, it will appear in the 
  1189. entry box.  You can edit it or enter a new title. 
  1190.  
  1191. Control   Function 
  1192.  
  1193. OK        Transfers the text in the entry field to the Recipe Editor window. 
  1194.  
  1195. Cancel    Exits without transferring the text to the Recipe Editor Window.  All 
  1196.           changes will be lost. 
  1197.  
  1198. Kitchen Assistant/2 does not allow duplicate titles in the database.  If a 
  1199. duplicate title is entered, a warning message box will be displayed when you 
  1200. save the recipe. 
  1201.  
  1202.  
  1203. ΓòÉΓòÉΓòÉ 6.2. Group Edit ΓòÉΓòÉΓòÉ
  1204.  
  1205. Group Editor
  1206.  
  1207. The Group Editor window is used to attached one or more group(s) to a recipe. 
  1208.  
  1209. The Group editor windows contains 2 listboxes, the left one contains the 
  1210. predefined groups and the right one contains the Groups to be attached to the 
  1211. current recipe.  The window also has a entry field to permit you to enter a 
  1212. group that is not contained in the predfined list. 
  1213.  
  1214. CAUTION:
  1215. A group that has be entered in the "New" entry field will not be add to the 
  1216. predfined list.  If you wish to have the new group add to the predefined list, 
  1217. you will have go to the Options, Groups window and add it to the 
  1218. ppredfinedgroup list there. 
  1219.  
  1220. If the recipe being edited already contains attached group(s) they will appear 
  1221. in the right listbox when group edit window is opened and if any of these 
  1222. groups appear in the predefined listbox they will be removed for the predfined 
  1223. listbox. This is done so that you do not attach duplicate groups to a recipe. 
  1224.  
  1225. To attach one or more group(s) to the recipe from the predfined list, select 
  1226. the group(s) you want from the left listbox, then press the Add button.  To 
  1227. select multiple groups, Hold the Ctrl key down while make the selection with 
  1228. the mouse or the keyboard. You can select groups from the predefined list and 
  1229. enter a new group in the new entry field in one operation. 
  1230.  
  1231. Warning: The number of groups that can be attached to a recipe is 10. 
  1232.  
  1233. Controls       Function 
  1234.  
  1235. Add >>         Adds the selected groups for the predfined listbox, and the if 
  1236.                the "New" entry filed contains a group to the recipe group 
  1237.                listbox. 
  1238.  
  1239. << Remove      The remove Button will remove any selected groups from the 
  1240.                Recipe Groups listbox and place them in the predfined listbox. 
  1241.  
  1242. <<Deselect>>   All select items in BOTH listboxes will be deselected. 
  1243.  
  1244. OK             Transfers the text in the entry field to the Recipe Editor 
  1245.                window. 
  1246.  
  1247. Cancel         Exits without transferring the text to the Recipe Editor Window. 
  1248.                All changes will be lost. 
  1249.  
  1250.  
  1251. ΓòÉΓòÉΓòÉ 6.3. Description Edit ΓòÉΓòÉΓòÉ
  1252.  
  1253. Recipe Description
  1254.  
  1255. The recipe description is created or edited in the recipe editor.  Do not enter 
  1256. carriage returns, unless you need them for some special formatting.  It is 
  1257. advised that you do not since they may mess up the recipe formatting done by 
  1258. Kitchen Assistant/2 . 
  1259.  
  1260. Control   Function 
  1261.  
  1262. OK        Transfers the text in the entry field to the Recipe Editor window. 
  1263.  
  1264. Cancel    Exits without transferring the text to the Recipe Editor Window.  All 
  1265.           changes will be lost. 
  1266.  
  1267.  
  1268. ΓòÉΓòÉΓòÉ 6.4. Ingredients Edit ΓòÉΓòÉΓòÉ
  1269.  
  1270.                                 Ingredient Editor
  1271.  
  1272. The Ingredient Edit window is activated from the recipe editor window by the 
  1273. Ingredient button. 
  1274.  
  1275. The ingredient information can be entered or edited in the appropriate column 
  1276. only when in the edit mode.  The Ingredient edit will open in the edit mode 
  1277. with the first quantity field as the edit focus.  The edit focus is shown by a 
  1278. box drawn around the field.  Normal edit keys function are available while in 
  1279. the edit mode.  The edit mode can also be entered by pressing the Edit button 
  1280. at the bottom of the screen.  This will place the edit box on the first 
  1281. quantity field.  You can also open the edit box on the field of your choice by 
  1282. moving the mouse to the field and hold the the Alt key down while you click the 
  1283. left mouse button.  Once you have finished entering or editing the field, you 
  1284. can move to the next field by pressing the Tab key or the Enter key.  Press 
  1285. Shift-Tab will move back one field.  While editing the Unit of measure field or 
  1286. the Ingredint field, you can get a list of measure or user define ingredients 
  1287. by pressing the right mouse button while the mouse pointer is with the edit 
  1288. field.  You can then select the desired item from the list, then press enter or 
  1289. double clicking the item with the left mouse button. 
  1290.  
  1291. To insert a header into the ingredient list, the quantity and measure field 
  1292. must be blank.  Enter the header text with 5 or more of the same characters 
  1293. before the header text.  For example: -------Filling. Or you can just enter the 
  1294. header text, then press the Header button at the bottom of the screen. 
  1295.  
  1296. If while manually entering unit of measure you enter a unit of measure that is 
  1297. not one of contained in the measure list, KA/2 will try to convert it.  For 
  1298. example: you can enter "c" for cup and KA/2 will convert it to "cup" and insert 
  1299. it into the edit field. 
  1300.  
  1301. Controls       Function 
  1302.  
  1303. Delete         Deletes the selected ingredient line(s).  This button will be 
  1304.                enabled when one or more lines are selected. 
  1305.  
  1306. Insert         Insets a empty line below the first selected line. 
  1307.  
  1308. Up Arrow       Moves the selected item(s) up one line.  This button is enabled 
  1309.                when one or more lines are selected and if the First line is not 
  1310.                one of the selected lines. 
  1311.  
  1312. Down Arrow     Moves the selected item(s) down one line.  This button is 
  1313.                enabled when one or more lines are selected and if the Last line 
  1314.                is not one of the selected lines. 
  1315.  
  1316. Header         This button will be enabled if you are in the ingredient field 
  1317.                and the quantity and Measure field are blank. Pressing the 
  1318.                button will convert the text currently in the ingredient field 
  1319.                into a header. 
  1320.  
  1321. Edit           Places you in the edit mode, at the first quantity field. 
  1322.  
  1323. OK             Transfers the text in the entry field to the Recipe Editor 
  1324.                window. 
  1325.  
  1326. Cancel         Exits without transferring the text to the Recipe Editor Window. 
  1327.                All changes will be lost. 
  1328.  
  1329.  
  1330. ΓòÉΓòÉΓòÉ 6.5. Instruction Editor ΓòÉΓòÉΓòÉ
  1331.  
  1332.                                Recipe Instruction
  1333. Edit
  1334.  
  1335. The Instruction section is where you enter the step by step instruction for the 
  1336. recipe.  The instructions are stored as paragraph, with a blank line or a 
  1337. header denoting the beginning of a paragraph. You should let the program format 
  1338. the lines in a paragraph. 
  1339.  
  1340. You can create a heading by enter the heading text, selecting it, then press 
  1341. the header button.  If the selected text is in the middle of the line the line 
  1342. will be split and the header will be place on the next line, by it's self with 
  1343. the remaining text following on the next line. 
  1344.  
  1345. Header can be entered directly into the instruction field if the correct format 
  1346. is observed.  The header should be on a line by it's self and should be 
  1347. preceeded by 5 or more Header Characters, optionally followed by 5 or more 
  1348. Header characters The default Header Character is defined in the Option, 
  1349. printer notebook page. 
  1350.  
  1351. Control   Function 
  1352.  
  1353. Header    Creates a Header line from the selected text. 
  1354.  
  1355. Add       Adds the ingredient information in the upper entry fields to the main 
  1356.           entry area. 
  1357.  
  1358. OK        Transfers the text in the entry field to the Recipe Editor window. 
  1359.  
  1360. Cancel    Exits without transferring the text to the Recipe Editor Window.  All 
  1361.           changes will be lost. 
  1362.  
  1363.  
  1364. ΓòÉΓòÉΓòÉ 6.6. Save Edited Recipe ΓòÉΓòÉΓòÉ
  1365.  
  1366. Save Button
  1367.  
  1368. The Save button will save the recipe if it a new recipe or if the recipe has 
  1369. been modified.  The Editor window will be exited and you will return to the 
  1370. previous window. 
  1371.  
  1372.  
  1373. ΓòÉΓòÉΓòÉ 6.7. Preparation Edit ΓòÉΓòÉΓòÉ
  1374.  
  1375.                               Preparation & Cooking
  1376. Time
  1377.  
  1378. This Edit window is used to enter the preparation and cooking times for a 
  1379. recipe. 
  1380.  
  1381. Controls  Function 
  1382.  
  1383. OK        Transfers the text in the entry field to the Recipe Editor window. 
  1384.  
  1385. Cancel    Exits without transferring the text to the Recipe Editor Window.  All 
  1386.           changes will be lost. 
  1387.  
  1388.  
  1389. ΓòÉΓòÉΓòÉ 6.8. Serving Edit ΓòÉΓòÉΓòÉ
  1390.  
  1391. Yield Information
  1392.  
  1393. This Edit window is used to enter the Yield information for the recipe. Enter a 
  1394. numeric qty in the Qty entry field.  The Unit of Measure is selected from the 
  1395. dropdown list box. 
  1396.  
  1397. Control   Description 
  1398.  
  1399. OK        Transfers the text in the entry field to the Recipe Editor window. 
  1400.  
  1401. Cancel    Exits without transferring the text to the Recipe Editor Window.  All 
  1402.           changes will be lost. 
  1403.  
  1404.  
  1405. ΓòÉΓòÉΓòÉ 6.9. Source Edit ΓòÉΓòÉΓòÉ
  1406.  
  1407. Source/Author
  1408.  
  1409. The Source Edit window is used to enter the Source or author information for 
  1410. the recipe.  Enter a single line of text in the entry field. 
  1411.  
  1412. Control   Function 
  1413.  
  1414. OK        Transfers the text in the entry field to the Recipe Editor window. 
  1415.  
  1416. Cancel    Exits without transferring the text to the Recipe Editor Window.  All 
  1417.           changes will be lost. 
  1418.  
  1419.  
  1420. ΓòÉΓòÉΓòÉ 6.10. Notes Edit ΓòÉΓòÉΓòÉ
  1421.  
  1422. Notes
  1423.  
  1424. The Note Edit Window is used for any miscellaneous notation for the recipe. 
  1425.  
  1426. While you can enter the text with carriage return, I would recommend that you 
  1427. enter the text without them and let the program handle the line formatting. 
  1428. This may avoid problems later on when you try to print the recipe. 
  1429.  
  1430. Controls  Function 
  1431.  
  1432. OK        Transfers the text in the entry field to the Recipe Editor window. 
  1433.  
  1434. Cancel    Exits without transferring the text to the Recipe Editor Window.  All 
  1435.           changes will be lost. 
  1436.  
  1437.  
  1438. ΓòÉΓòÉΓòÉ 6.11. Nutrition Edit ΓòÉΓòÉΓòÉ
  1439.  
  1440.                                    Nutritional
  1441. Information
  1442.  
  1443. This Edit window used to enter the Nutritional information for the recipe. 
  1444.  
  1445. Use the per spin button to select the unit of measure that the nutritional 
  1446. values are based on.  The measurements used here are same as used for the 
  1447. recipe Yield field.  You can add addition units of measure to this box by using 
  1448. the Option, Yield from the menu bar and adding the new units to the Yield list. 
  1449. Complete entering numeric values for the rest of the fields in this window. 
  1450. Valid characters are 1234567890.\ and space. Do not enter the unit of measure, 
  1451. such as grams. 
  1452.  
  1453. Controls  Functions 
  1454.  
  1455. OK        Transfers the text in the entry field to the Recipe Editor window. 
  1456.  
  1457. Cancel    Exits without transferring the text to the Recipe Editor Window.  All 
  1458.           changes will be lost. 
  1459.  
  1460.  
  1461. ΓòÉΓòÉΓòÉ 7. Import Window ΓòÉΓòÉΓòÉ
  1462.  
  1463. Import Window
  1464.  
  1465. The Import Window provides the user with the ability to select some options via 
  1466. checkboxes before starting a import.  This window is opened after you have 
  1467. selected the file to be imported. 
  1468.  
  1469. The name of the file to be imported appears in the title bar of the window.  If 
  1470. you wish to change to another file, use the File button in this window. 
  1471.  
  1472. Checkbox       Function 
  1473. Verify         If this is checked the Editor window will be opened for each 
  1474.                recipe imported.  This will give the user the ability to edit 
  1475.                the recipe before it's added to the recipe file. 
  1476. Add to List Box If this is checked, as each recipe is imported, it will be 
  1477.                added to the Listbox. 
  1478.  
  1479. The import of the file will begin when you press the Start button.  During the 
  1480. import process the title of the recipe will be displayed in the entry field and 
  1481. added to the listbox if you have checked the Add to Listbox checkbox.  The 
  1482. count of recipes imported will be displayed in the left status bar.  The Right 
  1483. status bar will contain the count of import error.  The Log can be viewed to 
  1484. determine the reason for the error. 
  1485.  
  1486. The import can be cancelled by pressing the Cancel Button. Upon completion of 
  1487. the import, the Start Button will change to OK.  Pressing the OK button will 
  1488. return you to the main window. 
  1489.  
  1490.  
  1491. ΓòÉΓòÉΓòÉ 8. File Dialog ΓòÉΓòÉΓòÉ
  1492.  
  1493. File Dialog
  1494.  
  1495. The File Dialog window permits you to navigate the systems file structure. 
  1496.  
  1497. The drive, directory, and file can be selected or changed as needed. KA/2 will 
  1498. provide the default file mask, drive, and directory. You can use these or enter 
  1499. another drive, directory.  The defaults can be changed in the options notebook. 
  1500.  
  1501.  
  1502. ΓòÉΓòÉΓòÉ 9. RegisterHlp ΓòÉΓòÉΓòÉ
  1503.  
  1504. Registration Window
  1505.  
  1506. Enter the registered name, serial number, and the registration number you 
  1507. received when you registered KA/2 in the entry fields then press the OK button. 
  1508.  
  1509. Warning: If the registration information you entered is incorrect a warning 
  1510. message will be displayed. 
  1511.  
  1512. You can abort the register screen by pressing the the cancel button. 
  1513.  
  1514. To register KA/2 or for pricing information see the REGISTER.FRM file that is 
  1515. included in the zip file. 
  1516.  
  1517. Warning: If you upload the KA/2 package to a BBS, or give it to someone, DO NOT 
  1518. include the KITCHEN.INI file.  This is your INI file and you are not allowed to 
  1519. give it or transfer it anyone else. 
  1520.  
  1521.  
  1522. ΓòÉΓòÉΓòÉ 10. Print/Export Styles ΓòÉΓòÉΓòÉ
  1523.  
  1524. Print Window
  1525.  
  1526. This window will open when you print a recipe and if you have defined 1 or more 
  1527. user print format in the Options Notebook. The default format will be selected, 
  1528. with the other formats that you have defined available for selection.  After 
  1529. selecting the format you wish to use, press OK. 
  1530.  
  1531.  
  1532. ΓòÉΓòÉΓòÉ 11. Beta Version ΓòÉΓòÉΓòÉ
  1533.  
  1534. Beta Release Information
  1535.  
  1536. The Beta version release of Kitchen Assistant/2 is made available to any one 
  1537. who wants to help in testing the program. This version does not contain the 
  1538. "nag" screen, but does contain a time limit.  See Registering for more 
  1539. information on the "nag" screen. 
  1540. When the time limit expires, the Beta Kitchen Assistant/2 will revert to a 
  1541. standard unregistered version. 
  1542.  
  1543. CAUTION:
  1544. Of course any bug that that existed will still exist. You should upgrade to the 
  1545. latest release as soon as possible. 
  1546.  
  1547. You can register the Beta version at no cost before the Beta Limit date or 
  1548. until the next GA (General Availability) version is released.  As a register 
  1549. beta user you will receive a no discount on the GA registration fee.  Also you 
  1550. will be notified of any new beta release of this version and notification of 
  1551. the GA release.  If you encounter any problems with Kitchen Assistant/2 please 
  1552. contact support to report the problem. 
  1553.  
  1554. Note:  See the register.txt file included with the program for full information 
  1555. on registering Kitchen Assistant/2 
  1556.  
  1557.  
  1558. ΓòÉΓòÉΓòÉ 12. Support ΓòÉΓòÉΓòÉ
  1559.  
  1560. Questions and problems can be sent to: 
  1561.  
  1562.                     Internet addresses: anancoz@interport.net
  1563.                               Compuserve: 73777,13
  1564.                                 US Mail address:
  1565.                                   Allan Nancoz
  1566.                                  349 Quincy Ave.
  1567.                               Bronx, NY 10465-3011
  1568. Include the following Information. Version # 
  1569. Problem/symptoms/Question: 
  1570. Serial Number (from Product info screen if there is one): 
  1571. Your Name and address. 
  1572. Your E-mail address: (if you have one) 
  1573. If you have a Email address I will acknowledge receipt of the problem report. 
  1574. You will be informed of the resolution. How you can get a fix will depend on 
  1575. the severity of the problem, if you are a register user.  We are committed to 
  1576. providing the end user with a reliable, working product.  Even if you not a 
  1577. registered user, I want to hear about any problem you are having with KA/2 and 
  1578. I will get them resolved. 
  1579.  
  1580.  
  1581. ΓòÉΓòÉΓòÉ 13. Licence ΓòÉΓòÉΓòÉ
  1582.  
  1583. License
  1584.  
  1585. Kitchen Assistant/2 is a copyrighted program. It is not public domain or free 
  1586. software.  A limited license is granted for the purpose of determining 
  1587. suitability of the program. Registration is required for any use beyond a 30 
  1588. day evaluation period. Unregistered copies of this program may be distributed 
  1589. providing that all the materials in this package are included in an unaltered 
  1590. form. Individual copies may not be sold or fees charged for more than the cost 
  1591. of the media without permission of the author.  Kitchen Assistant/2 may be 
  1592. included in shareware collections providing that the files are not altered in 
  1593. any way.  Distributors of shareware collection can get the latest version from 
  1594. the author. 
  1595.  
  1596.  Registered users have the right to use this program for their personal use on 
  1597. one or more computers provided that only 1 copy is in use at the same time. 
  1598. Registered users can distribute the KA/2 package as long as they do not include 
  1599. their INI file in the package. 
  1600.  
  1601. Copyright (C) Allan Nancoz 1994
  1602.  
  1603. DISCLAIMER
  1604. This software is provided as is with no warranties expressed or implied. Under 
  1605. no circumstances will the author be liable for any loss of time, data or monies 
  1606. caused by your use of this program. 
  1607.  
  1608.  
  1609. ΓòÉΓòÉΓòÉ 14. Product Infomation ΓòÉΓòÉΓòÉ
  1610.  
  1611. Product Information
  1612.  
  1613. The Product Information display the version of this copy of  Kitchen 
  1614. Assistant/2  Along with the the Name and serial number if this is a registered 
  1615. copy. 
  1616.  
  1617. If this is not a registered copy, a register button will be at the bottom of 
  1618. the window.  Press the button to open the register window in which you can 
  1619. enter your registration information. 
  1620.  
  1621. At the top of the window there will a icon button which is used to close the 
  1622. window. This button will be replaced with a count down dial when this window is 
  1623. displayed for unregistered KA/2 at the start and end of KA/2 excution. In this 
  1624. case the window will close when the dial reachs zero. 
  1625.  
  1626. If the copy is a active Beta release, the words "BETA VERSION" and the 
  1627. expiration date will appear in the lower box.  After the expiration data the 
  1628. beta copy will behave as a unregistered copy. 
  1629. For unregistered copies this window will be open at the start up and close down 
  1630. of the program for a predetermined time. 
  1631.  
  1632.  
  1633. ΓòÉΓòÉΓòÉ 15. USA/Metric Conversions ΓòÉΓòÉΓòÉ
  1634.  
  1635.                              Metric/USA Measurement
  1636. Conversion
  1637.  
  1638. The mode of measurement conversions are controlled in the following ways. 
  1639. tsize=15 break=none. 
  1640.  
  1641. Options   The default mode is set here. This will be the mode that KA/2 starts 
  1642.           up in. 
  1643.  
  1644. Main Window The metric/USA button is located on the right side of the main 
  1645.           window control below the search control. The current mode in effect 
  1646.           displayed in the button and in the window title bar.  Pressing the 
  1647.           button will cycle the conversion mode through the three possible 
  1648.           setting.  tsize=20 break=none. 
  1649.  
  1650.    No Convert This will displayed the measures as they were entered or 
  1651.              imported. 
  1652.  
  1653.    USA Measures All metric units will be converted to USA units. 
  1654.  
  1655.    Metric Measure All USA units will be converted to metric units. 
  1656.  
  1657. View Window Same operation a the kitchen metric button except for the 
  1658.           following. The button is located at the bottom of the window. The 
  1659.           recipe will be displayed with the measurements based on the current 
  1660.           state of the metric control. 
  1661. For the conversion to be performed the unit of measure in the recipe must meet 
  1662. the following conditions. 
  1663.  
  1664. o The quantity must not be blank. 
  1665.  
  1666. o The quantity must have a valid numeric value. 
  1667.  
  1668. o The unit of measure must not be blank. 
  1669.  
  1670. o The unit of measure must be valid 3 character abbreviation. 
  1671. If the conversion cannot be made the values will appear in their original form. 
  1672.  
  1673.  
  1674. ΓòÉΓòÉΓòÉ 16. Group Search List Help ΓòÉΓòÉΓòÉ
  1675.  
  1676. Group List Help
  1677.  
  1678. When making entries into the Group Search entry field, if you press the right 
  1679. mouse while the mouse cursor is in the entry field, a listbox will open 
  1680. containing the predefined Groups.  Select one or more groups, then press enter 
  1681. (or double click with the left mouse) or press one of the logic selector button 
  1682. located below the list box.  If do not use the logic buttons the groups will be 
  1683. transfered the group search entry field with a space serperating them.  If you 
  1684. press one of the logic buttons at the bottom, the logic operator character 
  1685. selected will be inserted before each group added to the entry field. 
  1686.  
  1687. To close the list without adding transfering any group to the entry field, 
  1688. double click on the system menu button in the upper left corner of the list 
  1689. window.