home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR22 / MMDUP2.ZIP / MMDUP.DOC next >
Text File  |  1993-10-27  |  9KB  |  247 lines
  1.                                 MMDUP2
  2.  
  3.  WHAT IT IS:
  4.  
  5.    This little utility is being released to enable users of the Meal Master
  6. recipe database program to check for records with duplicate recipe titles
  7. in their database. Although Meal Master has a duplicate checker built in
  8. for importing, it is possible for duplicate recipe titles and/or duplicate
  9. recipes to slip into the database during manual importing. (Like many
  10. users, I have a large number of recipes in multiple subdirectories so I
  11. import new recipes manually).
  12.  
  13.    My husband, Neil wrote this small program to save me time checking for
  14. duplicate recipe titles. We have decided to release it into the computing
  15. community as freeware (no registration fee). It may be freely distributed
  16. provided the code is not altered or no fee is charged without the
  17. permission of Neil or Anne MacLellan.
  18.  
  19.  
  20. LEGAL STUFF:
  21.  
  22.   We have no connection with Episoft or Scott Welliver and this program is
  23. not endorsed by Episoft. Meal Master is a registered trademark of Episoft
  24. Inc. The authors are not responsible for any damage that may arise to one's
  25. computer or data using this program. (This should not be problem if this
  26. program is obtained from a BBS with reliable virus screening procedures.)
  27.  
  28.   I urge anyone using the shareware version of Meal Master to register the
  29. program with Episoft. It is good program with great support by its author
  30. and he deserves payment for his efforts.
  31.  
  32.  
  33. HOW IT WORKS
  34.  
  35.  
  36. There are several steps to using MMDUP2.EXE.
  37. MMDUP2.EXE should be put in the same directory as MM.EXE (Meal Master).
  38.  
  39.  
  40. 1) From within Meal Master, select the Utilities menu. Choose "T" Title
  41. Index and 'O' to change Output to write it to a file (TLINDEX.TXT).
  42.  
  43. 2) Exit Meal Master to the Dos prompt.
  44.  
  45. 3) Type MMDUP2
  46.    The following options will appear:
  47.  
  48.   F - write list of duplicate title to file MMDUP.TXT
  49.       and display on screen
  50.  
  51.   P - print list of duplicate titles
  52.       and display on screen
  53.  
  54.   Press any other key to display duplicate titles on screen only
  55.  
  56. The program will search for duplicate recipe titles and display them on the
  57. screen along with the number of duplicate recipe titles fond.  It will
  58. write them to the file MMDUP.TXT (if desired).
  59.  
  60. If it does not find any duplicate recipe titles, the following message will
  61. appear.
  62.  
  63.      "No duplicate recipe titles found"
  64.  
  65. In the event you have forgotten to run a Title Index in Meal Master, the
  66. following message will appear.
  67.  
  68.      "No TLINDEX.TXT found. You must run Meal Master, select the Utilities
  69.      Menu, select "T" for Title Index and then "O" to  change Output to
  70.      file TLINDEX.TXT"
  71.  
  72. 4) The print function assumes that your printer is on LPT1; if you use it
  73. somewhere else you will need to use DOS' mode command. If your printer is
  74. not turned on or online, the following message will appear:
  75.  
  76. Printer not available
  77.  
  78. but it will display the duplicate titles to the screen only.
  79.  
  80.  
  81. 5) The program will end and return you to the DOS prompt. You may then
  82. restart Meal Master, view the records with the duplicate titles (to insure
  83. whether the actual recipes are duplicates or only the titles) and rename
  84. or delete them as you wish. If your databases are like mine, you may find
  85. that you have a lot of duplicate recipe titles but the recipes aren't
  86. duplicates. In this case, you may wish to rename the affected recipe
  87. titles.
  88.  
  89. PLEASE NOTE:
  90.  
  91. ***
  92. If you have titles in your database that don't begin with the letters a-z
  93. ie. "Brazilian" Iced Coffee
  94.      5-Way Chili
  95.  
  96. You need to change the following item in the Title Index portion of Meal
  97. Master:
  98.  
  99. F First Letter in Index: A
  100.  
  101. change to:
  102.  
  103. F First Letter in Index: !
  104.  
  105. Now Meal Master's title indexing will include these recipes and MMDUP will
  106. be able to check them for duplication.
  107.  
  108. Thank you to Karen Mintzias for bringing this to my attention.
  109.         ***
  110.  
  111.  
  112. SEARCHING ACROSS MULTIPLE DIRECTORIES : new to version 2
  113. For those "keeners" like myself who have thousands of recipes spread
  114. across several subdirectories...
  115.  
  116. Thanks to a suggestion from Rodney Grantham, MMDUP2 now searches across
  117. multiple subdirectories (for those with a large amount of recipes who
  118. have divided them into different subdirectories).
  119. It isn't elegant but it doesn't alter your Meal Master indexes which is
  120. really the safest approach.
  121.  
  122. The steps involved in this are similar to above but take more time;
  123.  
  124.  
  125. 1) From within Meal Master, select the Utilities menu. Choose "T" Title
  126. Index and 'O' to change Output to write it to a file (TLINDEX.TXT).
  127.  
  128. 2) Exit Meal Master to the Dos prompt.
  129.  
  130. 3) Rename TLINDEX.TXT to another name, use something easy to remember. I
  131. found it easiest to use the name of the subdirectory (ie. dessert.txt,
  132. ethnic.txt or what ever)
  133.  
  134. The DOS command would be:
  135.  
  136. REN tlxindex.txt dessert.txt
  137. OR:
  138. RENAME tlxindex.txt dessert.txt
  139.  
  140. 4) Restart Meal Master (MM); from within Meal Master, select the Utilities
  141. menu. Choose "T" Title Index and 'O' to change Output to write it to a file
  142. (TLINDEX.TXT).
  143.  
  144. 5) Exit Meal Master to the DOS prompt
  145.  
  146. 6) Type MMDUP2 recipes.txt tlxindex.txt
  147. Please note one of the title index index files must be called tlindex.txt
  148. for the program to run.
  149.  
  150. The following options will appear:
  151.  
  152.   F - write list of duplicate title to file MMDUP.TXT
  153.       and display on screen
  154.  
  155.   P - print list of duplicate titles
  156.       and display on screen
  157.  
  158.  Press any other key to display duplicate titles on screen only
  159.  
  160. (I would strongly suggest one of the first two options if you are checking
  161. duplicates across several subdirectories), so you can print out the list to
  162. examine it. I have far more duplicates across subdirectories than I do
  163. within a single subdirectory.)
  164.  
  165.  
  166. The program will search for duplicate recipe titles and display them on the
  167. screen along with the number of duplicate recipe titles fond.  It will
  168. write them to the file MMDUP.TXT (if desired).
  169.  
  170. If it does not find any duplicate recipe titles, the following message will
  171. appear.
  172.  
  173.      "No duplicate recipe titles found"
  174.  
  175. In the event you have forgotten to run a Title Index in Meal Master, the
  176. following message will appear.
  177.  
  178.      "No TLINDEX.TXT found. You must run Meal Master, select the Utilities
  179.      Menu, select "T" for Title Index and then "O" to  change Output to
  180.      file TLINDEX.TXT"
  181.  
  182.  
  183. 7) The print function assumes that your printer is on LPT1; if you use it
  184. somewhere else you will need to use DOS' mode command. If your printer is
  185. not turned on or online, the following message will appear:
  186.  
  187. Printer not available
  188.  
  189. but it will display the duplicate titles to the screen only.
  190.  
  191.  
  192. 8) The program will end and return you to the DOS prompt. You may then
  193. restart Meal Master, view the records with the duplicate titles and rename
  194. or delete them as you wish. If your databases are like mine, you may find
  195. that you have a lot of duplicate recipe titles but the recipes aren't
  196. duplicates. In this case, you may wish to rename the affected recipe
  197. titles.
  198.  
  199. At this time, it only is able to compare two subdirectories at a time.
  200.  
  201.  
  202.  
  203. A SPECIAL THANK YOU
  204.  
  205. Neil and I want to send a special thank you to Rodney Grantham, who helped
  206. suggest a way of checking across multiple subdirectories and gave us
  207. suggestions regarding the source code.
  208.  
  209. Rodney is the author of a Meal Master utility called MMCONV which will
  210. convert Quikbook recipes and "free form" recipes (two forms which are not
  211. handled by the CONVERT program supplied with Meal Master. It will also add
  212. the name of the poster if the recipe was posted in an online cooking
  213. conference.
  214.  
  215. It is well worth the very reasonable registration price.
  216.  
  217. Rodney may be reached at:
  218.  
  219.               Rodney Grantham
  220.               770 Cranberry Tr.
  221.               Roswell, GA 30076
  222.               USA
  223.  
  224. We have never met Rodney, but consider him an online friend. If you haven't
  225. explored the online cooking conferences, they are a great way of acquiring
  226. and sharing recipes as well as sending messages to other people with same
  227. interests.
  228.  
  229. VERSION CHANGES
  230.  
  231. MMDUP v.1
  232. original program
  233.  
  234. MMDUP2
  235. -corrected small bug in code "comments"
  236. -now searches across multiple directories
  237. -now prints directly to a printer on LPT1
  238.  
  239. In the future, we hope to find a way to not run the program only from the
  240. command line when comparing two subdirectories and perhaps to compare more
  241. than two subdirectories at the same time.
  242.  
  243. Hope that you find this program as useful as I have.
  244.  
  245.                       Anne MacLellan
  246.                       Toronto, Ontario, Canada.
  247.