home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / grocry41.zip / GROCERY.DOC < prev    next >
Text File  |  1994-11-04  |  17KB  |  356 lines

  1.                         THE GROCERY SHOPPER
  2.                              Ver. 4.0
  3.                      A Product of Clark Systems
  4.                            Copyright 1994
  5.  
  6.     Welcome to The GROCERY SHOPPER, version 4.0. The GROCERY SHOPPER is
  7. an unpretentious little program whose sole purpose in life is to make
  8. your grocery shopping chores a little easier, more organized and more
  9. fun (at least in the planning stages). It won't keep you from having to
  10. go to the store, but it might help you get in and out a little quicker.
  11.  
  12.     We hope that you find the GROCERY SHOPPER useful and encourage your
  13. comments and suggestions, even if you decide not to register and not to
  14. continue use of The GROCERY SHOPPER. We invite you to contact us at the
  15. address given in the SHAREWARE and REGISTRATION section.
  16. _______________________________________________________________________
  17.  
  18.                               SUMMARY
  19.  
  20.     The GROCERY SHOPPER assumes two things. (1) That you normally shop
  21. for your groceries at the same store, and (2) that you can speed up your
  22. shopping trip by getting all grocery items in one pass up one Aisle and
  23. down the next. The GROCERY SHOPPER helps you accomplish this by making
  24. it simple to develop a shopping list of items you normally buy, then
  25. printing the list out with the items organized by aisle. Now in version
  26. 4.0, The GROCERY SHOPPER can also tell you which grocery items you have
  27. a Coupon for.
  28.  
  29.     The GROCERY SHOPPER maintains an inventory, or database if you will,
  30. of grocery items available in your regular grocery store. You create
  31. this database initially, then simply add to and maintain it as long as
  32. you use the program. The minimum information you must maintain in the
  33. ITEMS database is the description of the grocery item itself and the
  34. AISLE in which it is located, but you may add considerably more detail,
  35. up to and including the COST PER for each item and COUPON details (which
  36. will give you a very detailed shopping list, indeed). Every time you
  37. need something new you simply and quickly add it to the database of
  38. shopping items or coupons (at your option) where it remains available to
  39. you for future use on a future list. Unnecessary items can be easily
  40. removed at any time.
  41.  
  42.     Since the GROCERY SHOPPER includes extensive on-line help, there
  43. won't be a lot of details this documentation, just generalized
  44. information about program objectives, operation and navigational
  45. controls.
  46.  
  47.                               DISCLAIMER
  48.  
  49.     Clark Systems and its agents make no claim of any kind, express or
  50. implied, including without limitation, any warranties of merchantability
  51. and/or fitness for a particular purpose. Clark Systems and its' agents
  52. shall not be liable for any damages, whether direct or indirect, special
  53. or consequential arising from a failure of this program.
  54.  
  55.     In no event shall Clark Systems or its' agents be liable to you for
  56. any damages, including lost profits, lost savings or other incidental or
  57. consequential damages arising from use or inability to use this product
  58. or any claim by any other party.
  59.  
  60.  
  61.                       SHAREWARE and REGISTRATION
  62.  
  63.     GROCERY SHOPPER, v. 4.0 is distributed as Shareware, meaning that it
  64. is not free but is being made available to you on a trial basis. If you
  65. use The GROCERY SHOPPER beyond a reasonable trial period you are
  66. requested to register your copy with Clark Systems for the minimal fee
  67. of $15.00. In return you will receive one free update as the next one
  68. becomes available and our eternal gratitude which, along with $.60 might
  69. get you a cup of coffee.
  70.  
  71.     To register your copy of The GROCERY SHOPPER complete the
  72. registration form and send your check or money order in the amount of
  73. $15.00 made payable to Clark Systems to:
  74.  
  75.                         The GROCERY SHOPPER
  76.                            Clark Systems
  77.                           129 Pitney Road
  78.                         Absecon, N.J. 08201
  79.  
  80.     You may print a registration form from the closing sceeen of The
  81. GROCERY SHOPPER by pressing the letter 'p' while the message is on the
  82. screen. Be sure the printer is ready. Otherwise, the file REG_FORM.TXT
  83. is also a registration form, and can be used by sending the file to the
  84. printer (use the DOS command line 'TYPE REG_FORM.TXT>PRN' without the
  85. quotes). If your want to get really fancy, use your favorite editor or
  86. word processor to type the information into the REG_FORM.TXT file,
  87. then print it from your editor or word processor.
  88.  
  89.     Clark Systems and the GROCERY SHOPPER are not associated in any way
  90. with any Shareware distributor, and any fee paid to any such distributor
  91. does not constitute registration of The GROCERY SHOPPER. Only payment
  92. made directly to Clark Systems constitutes registration as discussed
  93. above.
  94.  
  95.     The GROCERY SHOPPER may be copied and distributed so long as no fee
  96. is charged beyond minimal shipping and handling costs, and provided that
  97. all files listed below are included.
  98.  
  99.  
  100.                        FILES YOU SHOULD HAVE
  101.  
  102.     The following and only the following files should be included in
  103. your ZIPped copy of The GROCERY SHOPPER:
  104.  
  105.                     Grocery.exe     S_coup.frm
  106.                     Grocery.dbf     C_coup.frm
  107.                     Grocery.doc     Items.frm
  108.                     Coupon.dbf      Items2.frm
  109.                     Help.dbf        Gro_scrn.com
  110.                     Help.dbt        Readme.1st
  111.                     File_id.diz     Reg_form.txt
  112.                     Coupons.frm     Whats_up.doc
  113.  
  114.     Registered users will also have recieved:
  115.  
  116.                     Convert.me3     Convert3.exe
  117.  
  118.  
  119.                     WHAT'S NEW IN VERSION 4.0
  120.  
  121.     Coupons, coupons, coupons! Now the GROCERY SHOPPER allows you to
  122. track, print and use information about your coupons on screen and on
  123. your printed shopping lists. If you enter minimal coupon information,
  124. each grocery item for which you have a coupon will be highlighted on
  125. screen with an arrow (>) and on your printout with a slightly different
  126. arrow (<-).
  127.  
  128.  
  129.                       RUNNING THE PROGRAM
  130.  
  131.     The GROCERY SHOPPER should be run from a hard disk. While it may be
  132. run from floppy (provided that adequate disk space is available), much
  133. of what GROCERY SHOPPER does is disk intensive.  Therefore, performance
  134. will suffer when attempting to run the GROCERY SHOPPER from a diskette.
  135.  
  136.     There are no fancy installation steps for The Grocery Shopper.
  137. Simply determine where on your hard disk you want to keep The GROCERY
  138. SHOPPER (either by selecting an existing or creating a new directory)
  139. and copy all files listed above to that directory. The Grocery Shopper
  140. will create its' index files (*.ntx) during the initial startup of the
  141. program.
  142.  
  143. 1.    Summary of Operations
  144.  
  145.     The GROCERY SHOPPER has two important operations for the user,
  146. creating and printing a shopping list and (2) building and maintaining a
  147. database of grocery items . The ITEMS database must be developed before
  148. the list can be created, but once the basic database is completed there
  149. is little that must be done in future session except add the occasional
  150. new grocery item that wasn't purchased before, or modify existing item's
  151. aisle location, description, etc.
  152.  
  153.     If you're a coupon clipper you can take advantage of the COUPON
  154. database and have the program indicate to you the grocery items for
  155. which you've saved coupons. When you print your list, an arrow will
  156. indicate those items you've chosen for your shopping list for which
  157. you've saved a coupon.
  158.  
  159.     When the GROCERY SHOPPER is started, the user is presented with a
  160. horizontal MAIN MENU across the top of the screen from which various
  161. operations or commands may be chosen. In the right center portion of the
  162. screen is the item selection box which is where the various grocery
  163. items are displayed and, when activated with the CREATE A LIST command,
  164. where the actual list is made up.
  165.  
  166.     The GROCERY SHOPPER comes with a database of 144-odd items which,
  167. unless you have identical tastes and use the same store as we do, will
  168. need some modification.
  169.  
  170.     The EDIT ITEMS command will jump the user to the ITEMS sub-system
  171. where all information about grocery items is added and maintained. Here
  172. the user can modify the existing items according to the Aisle, Cost Per,
  173. Category and Sub Category the user prefers. In addition, the user should
  174. enter as many different items as he or she can think of which are
  175. normally purchased, in order to have those items available when it comes
  176. time to make up the actual shopping list.
  177.  
  178.     The COUPONS command will likewise jump you to the COUPONS sub-system
  179. where you'll keep all your information about the COUPONs you've saved.
  180. This section operates just like the other components of The GROCERY
  181. SHOPPER, except that the information captured is specific to grocery
  182. COUPONs.
  183.  
  184.     The GROCERY SHOPPER utilizes the relatively common programming
  185. concept of making it feel that the user is going down and coming back up
  186. a ladder. Some commands act directly, some take you only one step and
  187. some commands when chosen will reveal more commands which are available
  188. or which must be utilized. In order to back out of any operation, or
  189. move back up to a previous level (consider the initial screen or MAIN
  190. MENU the 'top') simply press the <Esc> key.
  191.  
  192. 2.    Start Up.
  193.  
  194.     Log onto the directory where The GROCERY SHOPPER files are located.
  195. Be certain that all files are present, then simply type 'GROCERY' from
  196. the DOS prompt. You will be presented with an Introduction screen, the
  197. index files will be created and then you will be delivered to the
  198. GROCERY SHOPPERs' MAIN MENU. The index files will only be created the
  199. first time the system is started or any time thereafter when the program
  200. can't find it's index files (ie: they've been erased - see the PROBLEMS
  201. section, below).
  202.  
  203. 3.  Navigation
  204.  
  205.     The MAIN MENU and the EDIT ITEMS MENU are Lotus-Style Horizontal
  206. highlight bar devices. Other menus, such as the one presented when PRINT
  207. is selected from the MAIN MENU utilize Vertical highlight bars.
  208. Navigation around menus is controlled by use of the arrow keys. Each
  209. command, or operation on the MAIN MENU and EDIT ITEMS MENU can be
  210. selected either by moving the highlight bar to the command and pressing
  211. the <Enter> or <Return> key or by pressing the first letter of the
  212. command (ie: 'c' or 'C' for Creat A List, 'd' or 'D' for Delete).
  213. Vertical menus can only be operated by moving the highlight bar to the
  214. selection with th w arrow keys and pressing <Enter>.
  215.  
  216.     When using the CREATE A LIST command a highlight bar is activated in
  217. the item selection box. Here navigation is controlled by the <PgUp> and
  218. <PgDn> keys in addition to the arrow keys. To jump directly to the first
  219. record press the <Ctrl> and the <PgUp> keys simultaneously. Similarly,
  220. to go to the last record, press the <Ctrl> and the <PgDn> keys
  221. simultaneously.
  222.  
  223.     From the EDIT ITEMS MENU, when ADDing or UPDATEing an item
  224. navigation keys work identically as described above.
  225.  
  226.     Note that when going to the first or last records, if a FILTER is in
  227. effect the first and last records are the first and last in the group
  228. being FILTERed.
  229.  
  230.  
  231. 4.    MAIN MENU
  232.  
  233.     When you select CREATE A LIST the highlight bar is activated in the
  234. item selection box on screen. Navigate up and down through the items by
  235. using the key combinations described above. When you want to place an
  236. item on your list, put the highlight bar on the item and press enter. A
  237. check mark will appear under the "Buy" column indicating that the item
  238. has been selected for purchase and will appear on the printed list.
  239.  
  240.     Entering an amount (or quantity) is optional except if you're going
  241. to utilize the costing report/list. To do so, press the letter 'a' or
  242. 'A'. A field will appear under the 'Amount' column and the cursor will
  243. be activated in this field. Type in the amount and press <Enter>.
  244.  
  245.     To UN-select one item (remove it from the list), move the highlight
  246. bar to that item and press the letter 'D' or 'd' (for delete).
  247.  
  248.     To start a new list 'from scratch', utilize the DELETE command.
  249.  
  250.     Any grocery items for which you've entered a coupon (using the
  251. COUPON command, below) will be displayed with an arrow ('>') in front of
  252. it indicating that you have a coupon for that item.
  253.  
  254.     A summary of the function of each command/operation and instructions
  255. for use is available through on-line help, accessed by pressing the <F1>
  256. key. Select the command then press <F1>.
  257.  
  258. 5.  EDIT ITEMS Menu
  259.  
  260.     When you select EDIT ITEMS from the MAIN MENU you jump 'down' to a
  261. second horizontal bar menu which gives you access to individual items.
  262. You can flip through these items by using the navigational keys
  263. described above until you find the one you want to work on. <PgDn> and
  264. the down arrow move you 'down' item by item. <PgUp> and the up arrow key
  265. does the opposite.
  266.  
  267.     A summary of the functions of each command/operation and
  268. instructions for use is available through on-line help, accessed by
  269. pressing the F1 key.
  270.  
  271. 6.     COUPONs Menu
  272.  
  273.     When you select COUPON from the MAIN MENU you also jump down a level
  274. to the COUPON s horizontal menu bar. This operates identically to the
  275. EDIT ITEMS menu, and you navigate through the COUPONs database by using
  276. the same handful of keys.
  277.  
  278.     Any grocery items for which you've entered a coupon (using the
  279. COUPON command, below) will be displayed with an arrow ('>') in front of
  280. it indicating that you have a coupon for that item.
  281.  
  282.  
  283. 7.    SEARCHing
  284.  
  285.     The SEARCH operation, found on both the MAIN and EDIT ITEMS menus,
  286. actually performs two primary functions. The first as you might expect,
  287. is to help you find a grocery item by item, aisle, category or
  288. sub-category.
  289.  
  290.     When you SEARCH, a Search menu drops down. From this you choose your
  291. search 'key', either Aisle, Item, Category or Sub-Category. You then
  292. enter the name of the Aisle, Item, etc. for which you want to search and
  293. press <Enter>. The program will search for the appropriate piece of
  294. information you entered and, if it's found, will display it on screen.
  295. If not found, a message will pop-up to that effect. The match between
  296. the 'key' and the target (ie: the AISLE or the ITEM) must be exact.
  297.  
  298.     The second purpose is to reset the index to the search 'key' which
  299. you have selected. Whether or not the item you're searching for is found
  300. the indexes will be reset to that index 'key', again, either Aisle,
  301. Item, Category or Sub-Category. So, if you search by ITEM, the database
  302. will be reset and will appear in alphabetical order by item. This can be
  303. very helpful if, for example you want to view you grocery items in order
  304. of category, where all dairy will be grouped together, or all meat
  305. grouped together, etc. Try it out.
  306.  
  307.  
  308.                                HELP
  309.  
  310.     All Clark Systems programs, including the GROCERY SHOPPER, include
  311. HELP systems which can be edited and changed by the user. When help is
  312. called up by pressing the <F1> key the cursor is active in the HELP
  313. screen. Move around the HELP screens using navigation keys discussed
  314. above. If you want to make changes, <Ins>, <Del>, <Backspace> and other
  315. keys are available for editing, as in any typical word processor.
  316.  
  317.     On some occasions HELP may not have been included. In this case the
  318. program will tell you that that portion of the program is Help- less and
  319. ask if you want to add some. Respond to the prompt accordingly.
  320.  
  321.     NOTE!!! IN ORDER TO SAVE YOUR CHANGES or additions to HELP, you must
  322. exit the editing session by pressing the <Ctrl> and 'W' keys
  323. simultaneously. Using <Esc> to exit will not save your changes.
  324.  
  325.  
  326.                              PROBLEMS
  327.  
  328.     In all cases you should periodically back up your files to avoid
  329. loss of data due to unexpected problems like electrical outages, spilled
  330. coffee, etc. Simply keep a copy of all original files in a safe place
  331. and periodically copy all (and only) the .DBF, .DBT, and .TBK files to a
  332. separate diskette, either using the DOS copy or xcopy commands, or a
  333. reasonably good commercial backup program (NOT the DOS Backup). If your
  334. files do get clobbered first erase all existing GROCERY SHOPPER files,
  335. copy all original files to your operating directory or disk, THEN copy
  336. the backed up .DBF, .DBT and .TBK files to that directory or disk. This
  337. should help you avoid having to re- enter a lot of data should a problem
  338. arise.
  339.  
  340.     The only other serious problem might result from corruption of the
  341. indexes. Symptoms of such corruption are the inability to find grocery
  342. items through the SEARCH function, failure of the program to display or
  343. print items which you KNOW should be there, Help screens that don't
  344. correspond to the appropriate area, etc.
  345.  
  346.     If you suspect such a problem you may correct it easily by
  347. (CAREFULLY) erasing all index files, ie: those with the extension .NTX.
  348. Do this either individually or with the DOS command 'ERASE *.NTX'
  349. (without the quotes). The next time the program starts up it will
  350. automatically create the needed index files properly indexed.
  351.  
  352. _______________________________________________________________________
  353.  
  354.                                ENJOY!!
  355.  
  356.