═══ 1. General Help For Kitchen Assistance ═══ KITCHEN Assistant/2 Ver 1.0 (C) Copyrighted Allan Nancoz 1994 The KA/2 main Window provide access to the many function available to maintain and access the recipe files. Multiple recipe files can be maintain if desired. The recipe files is consist of four files, recipe, ingredient, group, and title file. A recipe(s) can be retrieved with the search function, using one or more of the following criteria's: ■ Title(s) ■ Group(s) ■ Ingredient(s) The search parameters allow for logical functions (and, or, not, and xor) to provide for advance search abilities. The menubar at the top of the window provides access to the following functions. Menu Item Functions File New, Open, Import, Export, View log Maintenance Database Maintenance. Pack, Default INI. Options Default Options for KA/2. Help Access to the on-line help and product information window. The next area contains the three search parameter entry fields, Title, Group, Ingredient. The third area is a listbox that will contain the recipe that match your search parameters or the recipes that have been imported, if the add2list option is selected when importing recipes. One or more of these recipes can be selected and the following function can be performed. Function Description View View the selected recipe(s). Edit Edit the selected file(s) Print Print the selected file(s) Delete Delete the selected file(s) from the recipe file. The control buttons available in this window are: Control Function * View View the selected recipe(s). * Edit Edit the selected file. * Print Print the selected file(s). * Delete Delete the selected file(s) from the database. New Enter a new recipe into the database. Search Begin search function. ** Select All Select all recipes contain in listbox. DeSelect * Deselect all recipes in listbox. Exit Exit Program. The buttons marked with * will be disabled if their are no recipes selected in the listbox The button marked with ** will be disabled until the listbox contains recipes. Note: MEAL-MASTER is a registered trademark of Episoft Systems. ═══ 1.1. Search ═══ Search The Search function provides the ability to find recipes that meet search parameters you entered in on or more of the entry fields, Title, Group, and ingredients. Group List Help When making entries into the Group Search entry field, if you press the right mouse while the mouse cursor is in the entry field, a listbox will open containing the predefined Groups. Select one or more groups, then press enter (or double click with the left mouse) or press one of the logic selector button located below the list box. If do not use the logic buttons the groups will be transfered the group search entry field with a space serperating them. If you press one of the logic buttons at the bottom, the logic operator character selected will be inserted before each group added to the entry field. To close the list without adding transfering any group to the entry field, double click on the system menu button in the upper left corner of the list window. SEARCH PARAMETERS FORMAT ■All searches are not case sensitive. ■If a full word search is desired enclose the word(s) with leading and trailing spaces in quotes. A title search for the word ham, will find the following recipes: "Baked Ham Southern Style", "Hamburgers" While a search for " Ham " would only find, "Baked Ham Southern Style" and not titles that contain "Hamburgers" since the search was for Ham with a leading and trailing space. ■Multiple words that are not separated by search operators will be taken as a phrase. The search parameter can contain logical operator to perform advanced search function. Operator Description & performs AND function. | performs OR function. ^ performs a exclusive OR function. \ performs NOT function () Use to modify the left to right ordering of operations. Examples (using title or ingredient search parameter as examples) blue & cheese This would a find recipes title such as "Blueberry Cheesecake" because both "blue" AND "cheese" in the title. Blue | cream This would find the titles such as "Blueberry Cheesecake ", "Strawberry Ice Cream" because they contain "blue" OR "cream" somewhere in the title. coffee ^ cake This would find any recipe with either coffee or cake in in the title, but would reject recipes that had both coffee and cake in the title. Example: Rum Cake would be found, but Coffee cake would not be found. \onion & garlic This would find recipes that did NOT contain "onion", but did contain garlic. For a recipe to meet the search criteria all the parameter that are specified in the three search fields must be meet. If the field is blank, it is ignored. After you enter all the search parameter that you wish to use, press the Search button to start the search. The button color will change to Yellow and the text will change to "Stop". The database will be search first using the title parameter, if specified. As each recipe that match the search parameter is found it will be entered into the listbox, in sorted ordered and the count of found recipes will be display in the lower left status box. At anytime you can cancel the search by pressing the yellow stop button. When the title search is completed, the group search will start. If a title search was specified, the group search will use the titles found by the title search for its search. In this case if the found title does not match the group search parameter it will be removed from the listbox and the found count will be reduced by 1. If no title search was specified, the group search will search all the recipes in the database for matches and add them to the listbox and found count. After the group search is completed, the ingredient search will be performed in the same manner as the other searches. The search can be cancelled at any time by pressing the "Stop" button. Any recipes found will remain in the list box. Warning: Due to a the current OS/2 limitation to the amount of text that a listbox can contain, a search may find more recipes that can be contained in the list box. In this case a warning message will be displayed and the search will stop. Upon completion of all the search, the Stop button will return to it's default color and the text will go back to "Search". The recipes found now can be selected for further operations. ALL TITLES If the All title checkbox is checked, all the titles found in the recipe file will be placed in the list box. Any entries in the search entry fields will be ignored. For a large database this may exceed the listbox limitation mentioned above. ═══ 1.2. Edit ═══ Recipe Editor The Edit button will open the Recipe Editor with the current recipe displayed ready to be modified. See Editor ═══ 1.3. Recipe Print ═══ View window Prints all the selected recipes. Editor Window Prints the currently displayed recipe. ═══ 1.4. New Recipe ═══ New Recipe The New button opens the recipe editor window ready for you to entry a new recipe. The title edit window will be opened so that you can enter the new recipe's title. The title is not checked for duplicate title at this point. The check is made when the recipe is saved. See Editor ═══ 1.5. Delete Recipe ═══ Recipe Delete The delete button will be enabled whenever one or more recipes in the listbox is selected. When the delete button is pressed, you will be asked to confirm the deletion request. If you response "Yes" all the selected recipes will be deleted from the recipe file. Warning: Once the recipe(s) are deleted there is no way to recover them. The disk space used by the deleted recipe(s) will be made available to Kitchen Assistant/2 for new or edited recipes. To make the disk space available to other programs on your system the Pack function will have to be run. This should not be neccessary, since KA/2 will reuse the space release by deleted recipes. If you delete a large amount of recipes and do not plan to add any new recipes, then you may want to run the Pack function to make the space available to other programs. ═══ 1.6. Select All ═══ Select All The Select All Push Button will select all the recipes currently in the list box. This button will be disabled until the listbox contains recipes titles. ═══ 1.7. Deselect recipe(s) ═══ Deselect All Recipes The DeSelect button will become enabled when one or more recipes are selected in the listbox. When the button is activated all recipes will be deselected. ═══ 1.8. Exit ═══ Program Exit When the Exit button is push you will be prompted if you want to exit the program. If you response by pressing "Yes", all recipe files will be saved and Kitchen Assistant/2 will exited. ═══ 2. File Menu ═══ File Menu The file dropdown menu consist of several items that pertain to the KA/2 recipe file handling. Also KA/2 can be exited from this menu. Menu Item Function New Recipe File Create a new initialized set of recipe files. Open Opens a already create recipe file and makes it the active recipe file. KA/2 can maintain as many recipes files as you wish. The only limit is your disk space. Import Import recipes in three different formats. KA/2 Recipes export in the KA/2 special format. This format is not in a user readable format and is intended mainly for internal use by KA/2. Formatted Text This will import recipes in the following formats: KA/2 text, Meal-Master (tm), MasterCook II and Compchef. Export Exports recipes in the folowing formats. KA/2 The special KA/2 format which is not a user readable format. KA/2 Text This format is user readble and intended for recipe exchange via BBS's and other email services. This format can be imported by KA/2. KAMM This format can be imported by KA/2 and Meal-Master v8.x. This will permit exchang of KA/2 recipe with Meal-Master users. View Log View the log for the current recipe. The optional log is maintained if it has been enabled the option notebook. ═══ 2.1. New DataBase ═══ Creating a New Recipe files This function will create a new initialized recipe file. Enter the name of the new recipe file you want to create without a extension. Then press OK. If a recipe file already exist with the name you entered, you will be asked if you want to delete the existing recipe file. Warning: If you answer Yes, all data in the existing recipe file will be lost and a empty recipe file, with the same name will be created. ═══ 2.2. Open Database ═══ Open Recipe File You can open another existing recipe file. The current recipe file will be close and a File Dialog window will be opened with the default Drive and Directory set. You can change the Drive and Directory if the recipe file you want to open is not located in the default location. The default Path can be set in Option, Path. All the existing recipe files that are in the specified path will be displayed. Select the recipe file that you want to open by clicking on it, then pressing OK. You can also just double click on the recipe file to open it. The opened recipe file will become the active recipe file. The active recipe file's name will be displayed in the title bar of the main window. If you want to create a new recipe file, use File, New Recipe File ═══ 2.3. Import Recipes ═══ Recipe Import Five formats are acceptable for import into KA/2. The first two are KA/2 formats and the others are recipes formats generated by other popular recipe management programs. Format KA This format is not intended to be user readable. See Export Kitchen Assistant. KA Text This format is in ASCII text format, that is in a readable and printable form. See Export Text Meal-Master Recipes that were exported by the Meal-Master (tm) Ver 6.x - 8.0 program. MasterCook II Recipes that were exported by the MasterCook II program. Compu-Chef Recipes that were exported by the Compu-Chef program. The "KA" menu item in the file, import menu will import the KA format. All the other formats will be imported by the "Formatted Text" menu item in the file, import menu. These formats can be intermixed in the same import file. See Formatted. Text Measurement Translation When recipes are imported or edited, the unit of measure for ingredients will be check to see that it is a 1-3 character KA/2 abbreviation. If the unit of measure is not abbreviation, KA/2 will attempt to convert it the standard KA/2 abbreviation. The table below shows the units of measure and what it will be converted to. If KA/2 does not recognize the unit of measure no conversion will be made. The user define UOM table will be used as part of this conversion, if there is one defined. KA/2 Unit of measures in imported/edited recipe x, - bn bunch, bns, bunches can cn, cns, cans cg centigram, cgs, centigrams cl centiliter, cls, centiliters clv clove, cloves ctn carton, ct, ctns, cartons, cts cup c, cups, C dg decigram, dgs, decigrams dl deciliter, dls, deciliters dr drop, drs, drops ds dash, dashs ea each env envelope, envelopes fl fluid ounce, fl oz, fluid ounces, fls g gram, gm, gr, grs, gms, grams gal gallon, ga, gals, gallons in inch, inches kg kilogram, kgm, kgms, kgs, kilograms l liter, lit, lits, liters lb pound, lbs, pounds lg large, lge md medium, med, m mg milligram, mgs, milliliters ml milliliter, mls, milliliters oz ounce, ozs, ounces pkg package, pk, pkgs, pks, packages pn pinch, pns, pinches pt pint, pints, pts qt quart, q, quarts, qts sl slice, sls, slices sm small, s tbs tablespoon, tb, tbls, tbsp, T tsp teaspoon, t, ts, teaspoons, tsps Recipe Error file. When KA/2 detects a error in a recipe being imported or edited, the recipe will be written to a file with the recipe file name and a extension of ".err". The file will be in KA text format. The type of error will be in the start of recipe header. You can edit this file with a ASCII editor to fix the problem, then reimport the file using the file, import, KA text function. The type of error that KA/2 will find that would cause a error is a duplicate title name. In this case all you would have to do is change the title in some way such as adding a "#2". Note: Changing the title to uppercase will not work. Title checks are done without regard to the case of the letter in the title. ═══ 2.3.1. Import, Kitchen Assistance ═══ Import Kitchen Assistant Format This will import recipes that were exported in the Kitchen Assistant/2 export format. This format is not intended to be user readable. ═══ 2.3.2. ImpFmtTxt ═══ Universal Recipe Importer This will import recipes contained in a ASCII file in one or more of the following text formats. o Kitchen Assistant o Meal-Master o MasterCook II o Compu-Chef Recipes of different formats can be intermixed in the same file. Recipes in formats other than the ones listed above will not be imported. KA/2 will determine the format that each recipe is in and import it. Any text that is not within valid "Start of Recipe" and "End of Recipe" marker will be ignored. Recipes in this file can be ones that were save from sources such as the Fidonet cooking echo messages. Only the recipe text will be imported. A File Dialog window will be open with the default Drive and Directory set. Also the file mask will be set to the import/export extension set in the Options notebook. The default setting is "*.TXT". You can change the default setting in the Options notebook, Paths The file to be imported can have any extension. The only requirement for the import to be successful is that the recipes contained in the file be in valid formats of the above recipes formats. Recipes that do not meet this requiement will not be imported. ═══ 2.3.3. Import Text ═══ Recipe Import, KA Text Format This will import recipes that were exported in the KA text format. A File Dialog window will be open with the default Drive and Directory set. Also the file mask will be set to the import/export extension set in the Options notebook. The default setting is *.KAF. You can change the default setting in the Options notebook, Paths The file to be imported can have any extension. The only requirement for the import to be successful is that the recipes in the file be formatted correctly. CAUTION: Only use this format only to import KA text files. To import a KA Export file use File, Import, KA. To import Meal-Master (tm) text recipes, use File, Import, Meal-Master (tm). After the file to be imported has been selected, the Import Window will be open. ═══ 2.3.3.1. Format for Kitchen Assistance Text ═══ KA/2 Text Format Specifications A recipe in ASCII text that can be import by Kitchen Assistant/2 must conform to the following specification. 1. Key word will separate sections of the recipe. 2. All text until the start of recipe will be ignored. 3. All Key Words must start at column 1 of the line and end with a ":". 4. Key Words can be Upper or lower case or mixed. 5. Text associated with the Key Word can follow on the same line as the key word or start on the next line. 6. The current section is terminated when another Key Word is detected or the end of file is encountered.. 7. Blank lines are ignored unless noted below. 8. The Key Words can be in any order between the "start of recipe" line and the "End of Recipe" line. Start of Recipe 5 or more of the same characters repeated starting at column 1 of the line and the words "Kitchen Assistant" some where on the line after the leading repeated characters. End of recipe 5 or more of the same characters repeated starting at column 1 of the line. Keyword Description Title: Followed by the Title text. Group: Followed by each group(s) associated with this recipe separated by a comma and a space. Description: Followed by the description text. The description text is not formatted in anyway. Yield: Followed by a numeric Qty, 1 or more spaces and then the unit of measure. Preparation Time: Followed by the preparation time text, Cooking Time: Followed by the cooking time text. The preparation time and the Cooking time can be on the same line. This text must not exceed one line. Source/Author: Followed by the source text. Ingredients: Followed by each ingredient line or header line. The Header line must be in the following format: 5 or more of the same character followed by the header text, followed by a optional 5 or more of the same character. The leading and trailing (if used) characters must be the same character. Each Ingredient line must have the following format: A Qty, (valid characters are 1234567890/ .), 2 or more spaces followed by a unit of measure, abbreviated to two characters, 2 or more spaces. Next will be ingredient text. This text is free form. KA/2 uses the text up to the first "," or ";" as the text for it's ingredient index. If you enter the ingredient text in the following format the number of indexes will be reduced and operation will be sped up. 1 c flour, Unbleached In this case only the word "flour" will be used as a ingredient index. But remember that KA/2 will work fine even if you leave out the comma. If the ingredient text continues on the next line, the Qty field must blank or contain only a "." and Measurement fields must be blank. If the ingredient does not contain a Qty or Unit of measure, enter a - in the qty field. If you do not the ingredient line will be taken as a continuation line. Warning: At the current time 2 column format for ingredients is not supported Instructions: Followed by the instruction text. Instructions are stored as paragraphs. The start of a paragraph will be detected if a header line line is found or if a blank line is found between two text lines within the instruction section. The Header line must be in the following format: 5 or more characters repeated followed by the header text, followed by a optional 5 or more repeated characters. All the leading and trailing (if used) characters must be the same character. This is the same format as Ingredient header lines. CAUTION: Blank lines are not ignored within the instruction section. Nutrition The Key Word "Nutrition:" start this section. The following Sub Key words are used to located the values to be stored. Sub Key Words can appear any where on the line, in any order and multiple Sub Key Words can appear on a line except as noted below. "per:" Must NOT be on a line with another Sub Key Word. Followed by the unit of measure text. "Calories:" Followed by a numeric value. "Protein:" Followed by a numeric value. "Sodium:" Followed by a numeric value. "Total Fat:" Followed by a numeric value. "Saturated Fat:" Followed by a numeric value. "Cholesterol:" Followed by a numeric value. "Carbohydrates:" Followed by a numeric value. Notes: Followed by the note text. This text is not formatted in any way. ═══ 2.3.4. Recipe Import Errors ═══ Recipe Error file. When KA/2 detects a error in a recipe being imported or edited, the recipe will be written to a file with the recipe file name and a extension of ".err". The file will be in KA text format. The type of error will be in the start of recipe header. You can edit this file with a ASCII editor to fix the problem, then reimport the file using the file, import, KA text function. The type of error that KA/2 will find that would cause a error is a duplicate title name. In this case all you would have to do is change the title in some way such as adding a "#2". Note: Changing the title to uppercase will not work. Title checks are done without regard to the case of the letter in the title. ═══ 2.4. Export Recipe ═══ Recipe Export Kitchen Assistant/2 exports recipes in three different formats. Format Description Kitchen Assistant/2 This format is not intended to be user readable. It's primary purpose is for internal KA/2 use or where user will not read it directly. It is designed for quicker importing into KA/2. Text This format is in a readable, printable ASCII format. It is intended for use where someone is going to read it, such as e-mail. KA/2 will also import this format. If the recipe is generated by some other source, other than KA/2, it must comply to the KA/2 text format so KA/2 can use it. See Text Format for further information on this format. KA/MM Text This format can be imported by KA/2 or Meal-Master V8.x. ═══ 2.4.1. Export Kitchen Assistance ═══ Export KA/2 Format The KA/2 export format is not intended to be user readable. It is intended for faster importing by Import, KA function and for internal use by KA/2. For a user readable export format see Export Text. This format is used for printing a recipe or for recipes being included in e-mail messages or any other application where the recipe will be read. ═══ 2.4.2. Export Text ═══ Export KA/2 Text The text format exports recipes in a readable and printable ASCII text form. The recipe is formatted with a key word at the start of each section. If their is no text in a section, the key word will not be printed. The print function uses the same format. See Text Format for a full description of the text format. ═══ 2.4.3. KA/2-MM ═══ Export KA/2/Meal-Master (tm) Format This recipe format is designed to be imported by both Kitchen Assistant/2 and Meal-Master V8.x. The purpose of this format is so that Kitchen Assistant user can exchange recipes with Meal-Master users via BBS's or other electronic means. This format will also enable KA/2 users on these BBS's to import the recipe in their System and maintain the full benfits of KA/2's addition sections. This format will be automatically import by KA/2's "Formatted Text" in the file, import menu. When a recipe is exported in this format, the additional section such as Description, Nutrition etc. are placed with the recipe instruction area. This is done so that Meal-Master can import the recipe. When KA/2 imports this format, the ka/2 section that were placed in the instruction area will be extracted and appear in their correct position with the recipe. Warning: This format can be imported by Meal-Master (tm) V8.x. Other version of Meal-Master (tm) may not work and will not be supported by this format. ═══ 2.5. View Log ═══ View Log The View Log will display the contents of the log for the current recipe file. One log entry is displayed per line. Use the scroll bar to move through the file. CONTROLS OK Return to main window. Delete Deletes the selected entries from the log file. Erase File Deletes the log file. ═══ 3. Maintenance Menu ═══ Maintenance Menu The maintenance menu provides functions to do housekeeping on the recipe database. Menu Item Function Default INI Creates a default ini file. Pack Compresses the recipe files and makes disk space that deleted recipes was using available to your system. ═══ 3.1. Create Default INI ═══ Create Default INI file This function will create a default INI file. You will be asked if you really want to create the new default INI file. Warning: If you response Yes, your current INI file will be replaced with a new file. All your current option setting will be lost. ═══ 3.2. Pack Database ═══ Recipe File Pack The pack function is used to release any unused space in the recipe files for use by other programs. When you delete or modify recipes space used by the recipes deleted or modified are mark as available for KA/2 use. This space will be used first by KA/2 for new or modified recipes. The only time you may have to use this function is if you did a large scale deletion of recipes and you want to make the disk space available to you system. Note: The pack function DOES NOT compress the KA/2 files. The pack procedure is done by first exporting the recipes in KA/2 format, to a file named ".KA$", then renames the recipe files to temporary files. The names of these temporary file are in the log file, if you have the log file option enabled. Next a new set of recipe files is created with the same name as the original recipe files, then the exported file is import into the new recipe file. At the end all temporary are deleted. The export file *.KA$ is not deleted until the next pack of this recipe file. Warning: Packing the recipe file can take a long time if the recipe file is large ═══ 4. Option Menu ═══ Options Notebook The options notebook permits you to change the default parameters for Kitchen Assistant/2 Page Functions Paths Set the default path and recipe file name. Fonts Set the display fonts used by KA/2.. Printer Selects the printer to be used by KA/2. Groups Sets the Groups used by recipe files. Measures Sets the Unit of measure to be used in place of the KA/2 standard Unit of Measure for recipe printing and display. Ingredients Sets the user defined ingredient list. Yield Sets the measurements used for yield and nutritional information. Print Formats User defined recipe formats used for print or Exporting text file. Screen Position Defines at what position the main window will open at start up. Source Adds or append text to the source line when a recipe is imported or inputted. Misc Misc. toggles that control functions of KA/2 To exit the notebook double-click on the system menu icon in the upper left corner of the of the notebook. The changes you have made will not be saved until you close the notebook. ═══ 4.1. Paths ═══ hp7.Paths The paths and file extensions used by KA/2 can be set by selecting Option, Path. Default Recipe This is the recipe file that is opened when the KA/2 starts up. Working directory This is the directory that the recipe files and other files that are generated by the program are stored by default. You will be able to specify another directory if you wish for most file operation. File Extensions These are the default extensions that will be used for Import and Export operation. You can specify other extensions when the import or export operation is performed if you wish.. ═══ 4.2. Display Font ═══ Display Font You can change the font used for different display areas of KA/2 by selecting Options, Font. The currently selected font are display next to the control buttons for each area. The push buttons for each area are: Control Function Controls This is the font that will used for the text that appears in push buttons. Entry Field This is the font that will used for the text that appear within entry fields. Recipes This is the font that will used for the text in the recipe editor or viewer. It is recommended that you choose a fix font for this area. I you use a proportional font the alignment of some portions of the recipe, such as the ingredient list will not be correct. Labels This is the font that will used for the text used for radio buttons and other areas. If the display area does not fit in one of the other definitions, it will used this font for display. Tabs This is the font that will used for the text of the options notebook tabs. When one of the controls is selected, a font dialog will open. Select the font and font size you want to use for that area. CAUTION: Due to the size of the controls and other areas that the text appears, selecting a large font may cause the text to be clipped. ═══ 4.3. Printer Options ═══ Print Parameters You can change the recipe print parameters used by KA/2 by selecting Option, Printer. Top Margin The Top margin specified in inches. Left Margin The left margin specified in inches. Right Margin The right margin specified in inches. Bottom Margin The bottom margin specified in inches. Printer The printer that KA/2 will used to print recipes to. This is a read only field. To change the selected printer, press the Printer push button and a printer selection dialog will open. You can select from a list of printer that have been define in your system. You can also select the font to use from a list of available fonts for the selected printer. Recipe/page If this is check KA/2 will only print one recipe to a page. ═══ 4.3.1. Printer Dialog ═══ Print Selection Dialog The printer selection dialog is accessed via the option notebook. Select the printer tab and the printer parameter page will open. The current selected printer will be displayed in the printer box. To change to another printer, press the printer button and the printer section dialog will open. You can define a "recipe" printer if you should want a special setup to print your recipes. A list of printers that are installed in the system will be displayed. Place the mouse cursor on the printer you want KA/2 to use and click the left mouse button. To select the font that will be used, press the Fonts... button and the font dialog will open. Select the font, style, size and atributes you want, then press the OK button. When you have made all the selection, press the OK button to save them. ═══ 4.4. Group Options ═══ Predefined Groups The predefined groups for are define by selecting Options, Groups. There are no limited to the number of groups that a recipe file can contain. There is a limit of 50 fro the predefine groups. The predefined groups will be available in a left listbox when you are editing or creating the groups in a recipe. New groups entered while editing recipes are not entered into the predefined list. If you want to add the group to the predefined list you must enter it in the Options window. Recipes that are being imported will used the groups in the recipe, unless you select to change them manually by selecting the verify option in the Import window. New groups can be add to the predefined list by entering them to the top entry field. To delete groups from the list, select the group(s) you want to delete, then press the delete button. ═══ 4.5. Predefined Ingredients ═══ Predefined Ingredients List The ingredients can be added to the predefined ingredient list by selecting Options, Ingredient. There is a limit of 100 predefined ingredients. This list will be available when you are editing or creating a recipe. You are not limited to the using only the ingredients in this list. The purpose of the list is to provide a easy method to enter ingredients that you use often or for any other reason such as ingredients with unusual spelling. Recipes that are being imported will used the ingredients contained in the imported recipe, unless you select to change them manually by selecting the verify option in the Import window. New ingredients can be add to the predefined list by entering them to the top entry field, then pressing return. To delete ingredients from the list select the ingredient(s) you want to delete, then press the delete button. If you try to enter more than 100 ingredients a warning message will be displayed. ═══ 4.6. User Defined Unit of Measure ═══ User Define Unit of Measure You can redefine the unit of measure (UOM) that will be used when displaying or printing recipes. The UOM that is stored in the recipe files are the standard KA/2 UOM. The standard UOM's will also be used when recipes are exported. This is done to maintain exchangeablity of recipes since the user that's import a recipes does not need to be concern with the exporter's user defined table. For example a user in Germany can export a recipe from his KA/2 that is using UOM that are converted to German and a KA/2 user in Sweden can import the recipe and have the UOM display and print in Swedish, if he has set up the user defined UOM for Swedish UOM's. How to setup User defined table When the Measure is selected in the option notebook, the User Define UOM page will open with the first KA/2 Standard UOM display after the word "For 1. The user enters as the first entry in the entry field the 1-3 character abbreviation that will be used in place of the standard KA/2 UOM. 2. Place a comma after this entry. 3. Next enter the long name of this UOM ending it with a comma if more entries are to follow for this UOM. 4. Next enter any other forms of this UOM that you want KA/2 to recognize. Remember to separate each entry with a comma. 5. Press the Next button to define the next UOM. KA/2 will use the first entry in the user define UOM table as the entry in the UOM for recipes that are displayed or printed. If KA/2 encounters one of the other form of the UOM that you defined it will convert it to the first entry. The standard KA/2 UOM will be used for all recipes that are imported or exported. ═══ 4.7. Yield Measurments ═══ Yield Unit of Measure The predefined unit of measure for yields are set in the Options, Yield. There is no limit to what unit of measure you use in a recipe. The number of predefined units is limited to 20, and are used when editing or creating recipes as a short cut. You can use one of the predefined yield measurement or enter some other measurement while editing recipes. If you enter new yield measure it will not be entered into the predefined list of yield measurements. If your want the measurement in the predefined list, you have to enter them in this option notebook. Recipes that are being imported will used the yield measurement in the import recipe, unless you selected the verify option in the Import window. Selecting this option will allow you to edit the recipe as it's being imported. New yield measurement can be add to the predefined list by entering them to the top entry field. Then pressing enter on the keyboard. To delete groups from the list select the group(s) you want to delete, then press the delete button. ═══ 4.8. Screen Open Position ═══ Screen Position You can set the screen position where you want the Main Kitchen Assistant/2 window to open on program start up in Options, Position. There are 9 buttons which represent the following screen positions: Upper Left, Upper Center, Upper Right Middle Left, Middle, Middle Right Lower Left, Lower Center, Lower Right There is also a check box, which if check will cause the main window position to be saved when you exit the program. This saved position will be used as the starting position the next time you load KA/2. ═══ 4.9. Source ═══ Recipe Source The Optional Source text to be inserted into recipes can be set in Option, Source. This text will be inserted into the Source/Author line of a recipe. The text that will be added will be a standard text line or a custom line defined by the user. There are two standard text lines, one for recipes inputted by the user, " Inputted by ", and one for imported recipes "Imported from XXXX". XXXX will be the name of the recipe manager that created the recipe that's being imported. As part of the text line a marker (~~) is placed at the beginning of the text. If this marker is found in the Source/Author line of the imported recipe, no text will be added. Add text If this is checked, the standard or custom text will be added only if the Source/Author line in the recipe is blank. Append text If this is checked, the standard or custom text will be appended to the existing text in the Source/Author line. Custom Text If this is check the text that you enter in the entry field will be used in place of the standard text. ═══ 4.10. Print/Export Text Format ═══ Recipe Print Format Up to three user defined print/export formats can be defined in Option, Format. You select the sections you wish to include in the recipe. You can also specify if this format is to be used as the default format. There is a default format which includes all section. At the start of the print or export, you will be given the opportunity to select another format, if you have specified any of the user formats. For the format to become available you must provide a name for the format. Note: These formats apply only to printed recipes or recipes exported in the text format. ═══ 4.11. Options Misc Help ═══ Options, Misc. These setting can be made in Options, Misc. Item Function Header Character This is the character that is used before and after a ingredient or Instruction header. MMMM option Check this box if you are exporting recipes in the KA2/Meal-Master format and sending them via BBS's that does not permit "---" to start a line. Fidonet BBS's convert the 1st three "---" to underscores. This prevents Meal-Master (tm) and KA/2 from importing them. Meal-Master will accept "MMMMM" in place of "-----". KA/2 will put "MMMMM" at the start of recipe header, ingredient and instruction headers to maintain the ability of both KA/2 and MM to import recipes sent over these BBS nets. Log File If this is checked, a log file will be maintained in the working dir. The file name will be kitchen.log. The log file can be view by selecting the menu item, file, View Log You can also erase the file or delete entries from the file from the View Log window. Should the file size exceed 500KB a message will be display when you start up KA/2 New Log File If this is checked the old log file will be erased when KA/2 starts up and all entries to the log file for the current session will be made to a new log file. USA/Metric This sets the default measurement conversion mode. The three modes available are: ■None No conversion done. Recipe is displayed, exported, or printed as it is stored in the recipe file. ■USA The Unit of measure in the ingredient section is converted to a USA measure abbreviation if the unit of is found in KA/2's table. ■Metric The Unit of measure in the ingredient section is converted to a Metric measure abbreviation if the unit of is found in KA/2's table. Note: Measure that are not found in the KA/2 table are not converted and will appear as they are stored in the recipe file. ═══ 5. View Window ═══ Recipe Viewer The view recipe window consists of two areas, the Multiline view area and the control buttons. You cannot modify a recipe directly in this window. If you wish to modify the recipe being viewed, press the Edit Button. Only recipes that are selected in the KA/2 main window can be viewed in this window. The control buttons available in this window are: Control Function First Moves to the first selected recipe. This button will be disabled if you are at the first selected recipe. Last Moves to the last selected recipe. This button will be disabled if you are at the last selected recipe. Previous Moves to the previous selected recipe. This button will be disabled if you are at the first selected recipe. Next Moves to the next selected recipe. This button will be disabled if you are at the last selected recipe. Edit Edit the current recipe. Print Print the current recipe. Exit Returns to the main window. ═══ 6. Recipe Editor ═══ Recipe Editor The Recipe Editor is use to entered a new recipe or to modify an existing recipe. The window consist of two main areas, the recipe area and the control area. RECIPE AREA The recipe will be displayed in this area, along with the section headings. If you selected a new recipe a entry area will be blank and the Title entry window will be opened so you can enter the recipes title. There is one control button for each section of the recipe. CONTROL AREA The control button are use to open a editor window for the a section. The control buttons are: Title Group Description Ingredient Instruction Save Preparation Serving Source Notes Nutrition Cancel The entries or modification will not be saved to the recipe file until you press the save button. Pressing the cancel button will not save the change you may have made in this editing session. ═══ 6.1. Title Editor ═══ Title Editor If a title already exist for the recipe being edited, it will appear in the entry box. You can edit it or enter a new title. Control Function OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. Kitchen Assistant/2 does not allow duplicate titles in the database. If a duplicate title is entered, a warning message box will be displayed when you save the recipe. ═══ 6.2. Group Edit ═══ Group Editor The Group Editor window is used to attached one or more group(s) to a recipe. The Group editor windows contains 2 listboxes, the left one contains the predefined groups and the right one contains the Groups to be attached to the current recipe. The window also has a entry field to permit you to enter a group that is not contained in the predfined list. CAUTION: A group that has be entered in the "New" entry field will not be add to the predfined list. If you wish to have the new group add to the predefined list, you will have go to the Options, Groups window and add it to the ppredfinedgroup list there. If the recipe being edited already contains attached group(s) they will appear in the right listbox when group edit window is opened and if any of these groups appear in the predefined listbox they will be removed for the predfined listbox. This is done so that you do not attach duplicate groups to a recipe. To attach one or more group(s) to the recipe from the predfined list, select the group(s) you want from the left listbox, then press the Add button. To select multiple groups, Hold the Ctrl key down while make the selection with the mouse or the keyboard. You can select groups from the predefined list and enter a new group in the new entry field in one operation. Warning: The number of groups that can be attached to a recipe is 10. Controls Function Add >> Adds the selected groups for the predfined listbox, and the if the "New" entry filed contains a group to the recipe group listbox. << Remove The remove Button will remove any selected groups from the Recipe Groups listbox and place them in the predfined listbox. <> All select items in BOTH listboxes will be deselected. OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 6.3. Description Edit ═══ Recipe Description The recipe description is created or edited in the recipe editor. Do not enter carriage returns, unless you need them for some special formatting. It is advised that you do not since they may mess up the recipe formatting done by Kitchen Assistant/2 . Control Function OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 6.4. Ingredients Edit ═══ Ingredient Editor The Ingredient Edit window is activated from the recipe editor window by the Ingredient button. The ingredient information can be entered or edited in the appropriate column only when in the edit mode. The Ingredient edit will open in the edit mode with the first quantity field as the edit focus. The edit focus is shown by a box drawn around the field. Normal edit keys function are available while in the edit mode. The edit mode can also be entered by pressing the Edit button at the bottom of the screen. This will place the edit box on the first quantity field. You can also open the edit box on the field of your choice by moving the mouse to the field and hold the the Alt key down while you click the left mouse button. Once you have finished entering or editing the field, you can move to the next field by pressing the Tab key or the Enter key. Press Shift-Tab will move back one field. While editing the Unit of measure field or the Ingredint field, you can get a list of measure or user define ingredients by pressing the right mouse button while the mouse pointer is with the edit field. You can then select the desired item from the list, then press enter or double clicking the item with the left mouse button. To insert a header into the ingredient list, the quantity and measure field must be blank. Enter the header text with 5 or more of the same characters before the header text. For example: -------Filling. Or you can just enter the header text, then press the Header button at the bottom of the screen. If while manually entering unit of measure you enter a unit of measure that is not one of contained in the measure list, KA/2 will try to convert it. For example: you can enter "c" for cup and KA/2 will convert it to "cup" and insert it into the edit field. Controls Function Delete Deletes the selected ingredient line(s). This button will be enabled when one or more lines are selected. Insert Insets a empty line below the first selected line. Up Arrow Moves the selected item(s) up one line. This button is enabled when one or more lines are selected and if the First line is not one of the selected lines. Down Arrow Moves the selected item(s) down one line. This button is enabled when one or more lines are selected and if the Last line is not one of the selected lines. Header This button will be enabled if you are in the ingredient field and the quantity and Measure field are blank. Pressing the button will convert the text currently in the ingredient field into a header. Edit Places you in the edit mode, at the first quantity field. OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 6.5. Instruction Editor ═══ Recipe Instruction Edit The Instruction section is where you enter the step by step instruction for the recipe. The instructions are stored as paragraph, with a blank line or a header denoting the beginning of a paragraph. You should let the program format the lines in a paragraph. You can create a heading by enter the heading text, selecting it, then press the header button. If the selected text is in the middle of the line the line will be split and the header will be place on the next line, by it's self with the remaining text following on the next line. Header can be entered directly into the instruction field if the correct format is observed. The header should be on a line by it's self and should be preceeded by 5 or more Header Characters, optionally followed by 5 or more Header characters The default Header Character is defined in the Option, printer notebook page. Control Function Header Creates a Header line from the selected text. Add Adds the ingredient information in the upper entry fields to the main entry area. OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 6.6. Save Edited Recipe ═══ Save Button The Save button will save the recipe if it a new recipe or if the recipe has been modified. The Editor window will be exited and you will return to the previous window. ═══ 6.7. Preparation Edit ═══ Preparation & Cooking Time This Edit window is used to enter the preparation and cooking times for a recipe. Controls Function OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 6.8. Serving Edit ═══ Yield Information This Edit window is used to enter the Yield information for the recipe. Enter a numeric qty in the Qty entry field. The Unit of Measure is selected from the dropdown list box. Control Description OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 6.9. Source Edit ═══ Source/Author The Source Edit window is used to enter the Source or author information for the recipe. Enter a single line of text in the entry field. Control Function OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 6.10. Notes Edit ═══ Notes The Note Edit Window is used for any miscellaneous notation for the recipe. While you can enter the text with carriage return, I would recommend that you enter the text without them and let the program handle the line formatting. This may avoid problems later on when you try to print the recipe. Controls Function OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 6.11. Nutrition Edit ═══ Nutritional Information This Edit window used to enter the Nutritional information for the recipe. Use the per spin button to select the unit of measure that the nutritional values are based on. The measurements used here are same as used for the recipe Yield field. You can add addition units of measure to this box by using the Option, Yield from the menu bar and adding the new units to the Yield list. Complete entering numeric values for the rest of the fields in this window. Valid characters are 1234567890.\ and space. Do not enter the unit of measure, such as grams. Controls Functions OK Transfers the text in the entry field to the Recipe Editor window. Cancel Exits without transferring the text to the Recipe Editor Window. All changes will be lost. ═══ 7. Import Window ═══ Import Window The Import Window provides the user with the ability to select some options via checkboxes before starting a import. This window is opened after you have selected the file to be imported. The name of the file to be imported appears in the title bar of the window. If you wish to change to another file, use the File button in this window. Checkbox Function Verify If this is checked the Editor window will be opened for each recipe imported. This will give the user the ability to edit the recipe before it's added to the recipe file. Add to List Box If this is checked, as each recipe is imported, it will be added to the Listbox. The import of the file will begin when you press the Start button. During the import process the title of the recipe will be displayed in the entry field and added to the listbox if you have checked the Add to Listbox checkbox. The count of recipes imported will be displayed in the left status bar. The Right status bar will contain the count of import error. The Log can be viewed to determine the reason for the error. The import can be cancelled by pressing the Cancel Button. Upon completion of the import, the Start Button will change to OK. Pressing the OK button will return you to the main window. ═══ 8. File Dialog ═══ File Dialog The File Dialog window permits you to navigate the systems file structure. The drive, directory, and file can be selected or changed as needed. KA/2 will provide the default file mask, drive, and directory. You can use these or enter another drive, directory. The defaults can be changed in the options notebook. ═══ 9. RegisterHlp ═══ Registration Window Enter the registered name, serial number, and the registration number you received when you registered KA/2 in the entry fields then press the OK button. Warning: If the registration information you entered is incorrect a warning message will be displayed. You can abort the register screen by pressing the the cancel button. To register KA/2 or for pricing information see the REGISTER.FRM file that is included in the zip file. Warning: If you upload the KA/2 package to a BBS, or give it to someone, DO NOT include the KITCHEN.INI file. This is your INI file and you are not allowed to give it or transfer it anyone else. ═══ 10. Print/Export Styles ═══ Print Window This window will open when you print a recipe and if you have defined 1 or more user print format in the Options Notebook. The default format will be selected, with the other formats that you have defined available for selection. After selecting the format you wish to use, press OK. ═══ 11. Beta Version ═══ Beta Release Information The Beta version release of Kitchen Assistant/2 is made available to any one who wants to help in testing the program. This version does not contain the "nag" screen, but does contain a time limit. See Registering for more information on the "nag" screen. When the time limit expires, the Beta Kitchen Assistant/2 will revert to a standard unregistered version. CAUTION: Of course any bug that that existed will still exist. You should upgrade to the latest release as soon as possible. You can register the Beta version at no cost before the Beta Limit date or until the next GA (General Availability) version is released. As a register beta user you will receive a no discount on the GA registration fee. Also you will be notified of any new beta release of this version and notification of the GA release. If you encounter any problems with Kitchen Assistant/2 please contact support to report the problem. Note: See the register.txt file included with the program for full information on registering Kitchen Assistant/2 ═══ 12. Support ═══ Questions and problems can be sent to: Internet addresses: anancoz@interport.net Compuserve: 73777,13 US Mail address: Allan Nancoz 349 Quincy Ave. Bronx, NY 10465-3011 Include the following Information. Version # Problem/symptoms/Question: Serial Number (from Product info screen if there is one): Your Name and address. Your E-mail address: (if you have one) If you have a Email address I will acknowledge receipt of the problem report. You will be informed of the resolution. How you can get a fix will depend on the severity of the problem, if you are a register user. We are committed to providing the end user with a reliable, working product. Even if you not a registered user, I want to hear about any problem you are having with KA/2 and I will get them resolved. ═══ 13. Licence ═══ License Kitchen Assistant/2 is a copyrighted program. It is not public domain or free software. A limited license is granted for the purpose of determining suitability of the program. Registration is required for any use beyond a 30 day evaluation period. Unregistered copies of this program may be distributed providing that all the materials in this package are included in an unaltered form. Individual copies may not be sold or fees charged for more than the cost of the media without permission of the author. Kitchen Assistant/2 may be included in shareware collections providing that the files are not altered in any way. Distributors of shareware collection can get the latest version from the author. Registered users have the right to use this program for their personal use on one or more computers provided that only 1 copy is in use at the same time. Registered users can distribute the KA/2 package as long as they do not include their INI file in the package. Copyright (C) Allan Nancoz 1994 DISCLAIMER This software is provided as is with no warranties expressed or implied. Under no circumstances will the author be liable for any loss of time, data or monies caused by your use of this program. ═══ 14. Product Infomation ═══ Product Information The Product Information display the version of this copy of Kitchen Assistant/2 Along with the the Name and serial number if this is a registered copy. If this is not a registered copy, a register button will be at the bottom of the window. Press the button to open the register window in which you can enter your registration information. At the top of the window there will a icon button which is used to close the window. This button will be replaced with a count down dial when this window is displayed for unregistered KA/2 at the start and end of KA/2 excution. In this case the window will close when the dial reachs zero. If the copy is a active Beta release, the words "BETA VERSION" and the expiration date will appear in the lower box. After the expiration data the beta copy will behave as a unregistered copy. For unregistered copies this window will be open at the start up and close down of the program for a predetermined time. ═══ 15. USA/Metric Conversions ═══ Metric/USA Measurement Conversion The mode of measurement conversions are controlled in the following ways. tsize=15 break=none. Options The default mode is set here. This will be the mode that KA/2 starts up in. Main Window The metric/USA button is located on the right side of the main window control below the search control. The current mode in effect displayed in the button and in the window title bar. Pressing the button will cycle the conversion mode through the three possible setting. tsize=20 break=none. No Convert This will displayed the measures as they were entered or imported. USA Measures All metric units will be converted to USA units. Metric Measure All USA units will be converted to metric units. View Window Same operation a the kitchen metric button except for the following. The button is located at the bottom of the window. The recipe will be displayed with the measurements based on the current state of the metric control. For the conversion to be performed the unit of measure in the recipe must meet the following conditions. o The quantity must not be blank. o The quantity must have a valid numeric value. o The unit of measure must not be blank. o The unit of measure must be valid 3 character abbreviation. If the conversion cannot be made the values will appear in their original form. ═══ 16. Group Search List Help ═══ Group List Help When making entries into the Group Search entry field, if you press the right mouse while the mouse cursor is in the entry field, a listbox will open containing the predefined Groups. Select one or more groups, then press enter (or double click with the left mouse) or press one of the logic selector button located below the list box. If do not use the logic buttons the groups will be transfered the group search entry field with a space serperating them. If you press one of the logic buttons at the bottom, the logic operator character selected will be inserted before each group added to the entry field. To close the list without adding transfering any group to the entry field, double click on the system menu button in the upper left corner of the list window.