home *** CD-ROM | disk | FTP | other *** search
/ Master Technician / MASTER_TECHNICIAN.ISO / mtech / library / offline / misc / cudup2.exe / CUDUP2.DOC < prev   
Encoding:
Text File  |  1990-02-01  |  17.3 KB  |  389 lines

  1.  | Colorado Utilities Duplicate File Manager (CUDUP) (tm)
  2.  |
  3.  | version 2.1
  4.  |
  5.  | by
  6.  |
  7.  | Fred C. Hill
  8.  |
  9.  | Micro System Solutions (tm)
  10.  |
  11.  
  12.  
  13. Your first use of CUDUP constitutes agreement to the following license
  14. provisions.  If you do not agree to them please do not use this program.
  15.  
  16. CUDUP is a copyrighted program offered 'as is' for your personal use, 
  17. testing and evaluation. A limited license is granted to use and to 
  18. duplicate this program for your personal use. After a reasonable period 
  19. of time (approx 2 weeks) you are expected to register with the author or
  20. discontinue your use of this program.
  21.  
  22. Micro System Solutions authorizes you to make archive copies of this 
  23. software for the sole purpose of back-up and protecting your investment 
  24. from loss.  The executable version along with this documentation, in an 
  25. unmodified format, may be freely shared with anyone.  You may not distribute 
  26. any of the CUDUP source code or pre-compiled units (TPU files). You may
  27. utilize the source code for anything you desire as long as the distribution
  28. of the resulting program does not bring you into a direct competition with 
  29. Micro System Solutions.
  30.  
  31. The source for CUDUP is provided only to registered users. 
  32.  
  33. This software may be used by one person on as many computer systems as 
  34. that person uses. 
  35.  
  36. Micro System Solutions warrants any physical diskettes and documentation 
  37. provided to be free of defects in material and workmanship for a period 
  38. of 30 days from the date of receipt. If you notify us of such a defect 
  39. within the warranty period, Micro System Solutions will replace the 
  40. defective diskette(s) or documentation at no cost.
  41.  
  42. Ombudsman Policy
  43.  
  44. Fred C. Hill is a member of the Association of Shareware Professionals 
  45. (ASP). ASP wants to make sure that the shareware principle works for you. 
  46. If you are unable to resolve a shareware-related problem with an ASP member 
  47. by contacting the member directly, ASP may be able to help. The ASP 
  48. Ombudsman can help you resolve a dispute or problem with an ASP member, but 
  49. does not provide technical support for members' products. Please write to 
  50. the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve 
  51. message via easyplex to ASP Ombudsman 70007,3536
  52.  
  53. Trademarks
  54.  
  55. CUDUP, CUDM, CUVL, & CULBL are trademarks of Micro System Solutions.
  56.  
  57. Colorado Utilities is a trademark of Micro System Solutions.
  58.  
  59. Turbo Professional is a trademark Turbo Power Software
  60.  
  61. Turbo Pascal is a trademark of Borland International.
  62.  
  63. MS-DOS is a trademark of Microsoft Corporation.
  64.  
  65. IBM PC, XT, AT are registered trademarks of IBM Corporation.
  66.  
  67. ARC is a trademark of System Enhancement Associates (SEA)
  68.  
  69.  
  70. Additional Software
  71.  
  72. CUDUP requires no additional software to execute. It will, however, only 
  73. execute properly under MS/DOS version 3.0 and higher. (It has not been 
  74. tested under MS/DOS 4.x) You may elect to add one or more compression/
  75. decompression programs from the following list:
  76.  
  77.        file          
  78.        ext           pgm            company     version      comments
  79.  
  80.        ARC           PKPAK          PKWare        all
  81.        ARC           LARC           K. Miki              * using LHARC
  82.        LZH           LHARC          H.Yoshizaki   1.13
  83.        PAK           PAK                          1.6    * using ARC
  84.        ZIP           PKZIP          PKWare        1.01
  85.        ZOO           ZOO
  86.        ARC           ARC            SEA           6.0    * using PKPAK
  87.        DWC           DWC
  88.        LBR           LBR            
  89.        MD            MD     
  90.  
  91. Acknowledgements
  92.  
  93. A special thanks to Phillip K. Burns for the outstanding work he has done 
  94. in providing the programming world with the source to read the compression  
  95. decompression library directories used in this product. Thanks also to the 
  96. many people and companies involved in the programming of those utilities. 
  97.  
  98. The programming tool used in this program was Turbo Professional 5.0 by 
  99. Turbo Power Software. TPro is a library of over 600 state-of-the-art 
  100. routines covering almost all areas of IBM PC programming. This library has 
  101. provided programmers with the capability to provide better products to 
  102. their users. Micro System Solutions uses the TPro tools exclusively in its
  103. products and recommends them highly to novice and experienced programmers 
  104. alike.
  105. CUDUP manipulates the files on your disk through standard DOS calls. 
  106. Neither the author nor Micro System Solutions accept any responsibility 
  107. for damaged or lost files, data or media from use of this program.
  108.  
  109. Hardware required
  110.  
  111. CUDUP runs on any 100% IBM compatible microcomputer.  It will use as much 
  112. memory as you have available for the program and the required data storage.  
  113. No disk files other than the program (.EXE) file are required. This 
  114. documentation assumes you will be running CUDUP from a hard drive installed 
  115. as drive C:, however CUDUP will run from any hard or floppy drive on your 
  116. system.
  117.  
  118. Although it has not been tested, CUDUP should run on a network drive as well.  
  119. No file locks are done however and contention problems may arise during file 
  120. deletions.  Each user should have a registered copy of CUDUP or the 
  121. organization should have a LAN site license. 
  122. ORDER FORM
  123.  
  124.                                               Date:_____________  
  125. FROM:  
  126.  
  127. Name:____________________________   Company:_________________________  
  128.   
  129. Address:_________________________  Title:___________________________  
  130.   
  131. City:______________________ State:________ Zip:___________  
  132.   
  133.  
  134. Telephone:_____________________ Home( )  Office ( )  
  135.  
  136. Where did you first get/hear of our product? ________________________ 
  137.   
  138. Colorado Utilities Duplicate File Manager (CUDUP)               $17.00
  139.        includes diskette with:
  140.                      1. Latest executable version
  141.                      2. Documentation on disk
  142.                      3. Shipping and Handling
  143.   
  144. Complete source                                                 $10.00
  145.   (does not include Turbo Professional libraries)
  146.        
  147.        For overseas shipment add:                               $ 3.00  
  148.  
  149.        Colorado customers add 3% state sales  
  150.            tax and appropriate local tax:                       $ _______
  151.   
  152.                                    Order Total:                 $ _______  
  153.   
  154. Diskette format   5.25"______ or 3.5"_______ (check one)  
  155.   
  156. Send to:                                 
  157.                           VISA or MASTERCARD ACCEPTED:  
  158.  Micro System Solutions   
  159.                                    (circle one)  
  160.  5417 S. Cimarron Rd.     
  161.                              Card No.___________________________ 
  162.  Littleton, CO  80123      
  163.                               Expiration Date:____/____  
  164.  
  165.                             Authorized 
  166.                             Signature:________________________________
  167.  
  168. Orders may also be placed by sending an EasyPlex message on Compuserve 
  169. to PPN 76060,102.  Please include your Visa or Mastercard information and 
  170. your name as it appears on the card, as well as a shipping address. 
  171. Executing CUDUP
  172.  
  173. Start CUDUP from the command line as follows:
  174.  
  175.   CUDUP [/25] [/43] [/50] [/M] [/E] [/X] [/?] [d..d]
  176.  
  177.        all parameters are optional and mutually exclusive.
  178.         
  179.        /25 /43 or /50 will initialize the program in either 25 line
  180.                 mode, or EGA 43 or VGA 50 line mode. If the correct
  181.                 monitor is not available the program will default to
  182.                 the startup mode.  The system will return to the
  183.                 startup mode when you Quit to DOS. You may select
  184.                 either /43 or /50 if you have an EGA or VGA screen.
  185.  
  186.        /M  - initializes the program using the monochrome (B&W) colorset.
  187.  
  188.        /E  - disables compression library expansion. Only DOS files will be 
  189.              processes during this session. This flag will revert to
  190.              the default expansion at the end of this session.
  191.  
  192.        /X  - disables use of expanded memory when swapping memory to delete 
  193.              or  list files contained in compression libraries.
  194.  
  195.        /?  - displays a help line describing the comand line options.
  196.  
  197.        [d..d] - d..d are the optional disk drives to read from.  The default 
  198.                 drive will be used if d is not provided. Up to four drives 
  199.                 may be included during one run. If there is insufficient 
  200.                 memory to read all files on all included drives, CUDUP will 
  201.                 stop reading and display those files it has found. CUDUP does 
  202.                 not check for duplicates until all files have been read.
  203.  
  204. CUDUP begins execution in the Main Menu. From this menu you may change the 
  205. operating environment such as screen colors, the scope of the duplicate file 
  206. test, and the files used in the match.  You then have the option of 
  207. 'Run'ning CUDUP to examine the disk files you have selected.  When you are
  208. finished with the list and hit the Esc key you will return to the Main Menu.
  209. You must select the Quit option to exit to DOS.
  210.  
  211. CUDUP reads all included disks.... storing selected DOS files.... reading 
  212. any of the implemented compression library files.... and storing the 
  213. selected internal filenames into a large memory array. When (and if) the 
  214. available memory becomes full CUDUP will continue reading directories but 
  215. will not add additional files into the array.
  216.  
  217. When CUDUP finishes reading all filenames to be included, the array is 
  218. sorted and non-duplicates are discarded. The remaining files (duplicates) 
  219. are displayed.
  220.  
  221. Browsing through the list of files is done using the cursor control keys.  
  222. The program will terminate and return to the menu when the Esc key is hit 
  223. while in the file list window.
  224. Deleting Files
  225.  
  226. To delete any of the duplicate files, you first position the cursor 
  227. (highlighted line) on the line containing the file to you want deleted. Hold 
  228. down the Ctrl key and hit 'D'.  Upper or lower case is accepted.  
  229. You will be asked to confirm the deletion by answering 'Y' to the question
  230. 'delete file?'. Any answer other than 'Y' will abort the delete and continue 
  231. with the file list. 
  232.  
  233. If the file to be deleted is a standard DOS file it will be deleted 
  234. immediately. (Remember that a compression library is a standard DOS file 
  235. and there may be duplicates on your disk. If you delete it you will also 
  236. delete the files contained within it.)
  237.  
  238. If the file is contained within one of the compression protocol library files 
  239. the appropriate program ('PKPAK', 'PKZIP', LHARC, etc.) will be called to 
  240. perform the actual deletion. No checks are made to insure the deletion took 
  241. place as requested.
  242.  
  243. If you delete the compressed library file the contents of that library will 
  244. remain on the duplicate list. Any attempt to delete those files will probably 
  245. result in an error. (No checks are currently made to insure the file is still 
  246. present.)
  247.  
  248. The current version performs all requested deletions as the request is made. 
  249. Future versions will provide an option to store all external calls to the 
  250. compression/decompression programs until you request an exit to DOS.
  251.  
  252. Listing Files
  253.  
  254. To list any of the duplicate files, you first position the cursor 
  255. (highlighted line) on the line containing the file to you want listed. Hold 
  256. down the Ctrl key and hit 'L'.  Upper or lower case is accepted.  
  257. If the file to be listed is a standard DOS file it will be processed by a
  258. built-in text file processor. If the file is compressed the appropriate 
  259. program ('PKPAK', 'PKZIP', LHARC, etc.) will be called to perform the actual 
  260. listing. No checks are made to insure the file is a listable file. 
  261. Files such as .EXE or .COM or binary data files may be listed but would not 
  262. have any meaning.
  263.  
  264. Environmental changes
  265.  
  266. CUDUP allows you to change the environment under which you operate. You make 
  267. changes from the Main Menu or when you enter the environment menu by hitting 
  268. the F10 key when in the file list. At the present time you may do any of the 
  269. following:
  270.  
  271. Colors & Monochrome (B&W)
  272.  
  273.        o   You will select the part of the environment you want to
  274.            change colors on, the menu, list window, error messages, 
  275.            regular messages, file compression window or the main 
  276.            status screen. 
  277.  
  278.            - Each of the parts of the selected window or menu is then
  279.              available for selection. The frame, body, selected item,
  280.              etc  depending on what is to be changed.  When you
  281.              select the part a color window pop's up and allows you
  282.              to use the arrow keys to select the color combination
  283.              you like.  Hit enter when on the color to effect the
  284.              change.
  285.  
  286.            - If you selected Monochrome from the menu or by the use of the 
  287.              '/M' option on the command line, then the default colors will 
  288.              be set automatically. 
  289.  
  290. Screen Lines
  291.  
  292.        o   Using this option you can select either 25 line mode
  293.            (standard), 43 line EGA mode or 50 line VGA mode. Of
  294.            course you must have the correct monitor for this option
  295.            to work.  It is ignored if the correct monitor is not in
  296.            place.
  297. Environmental changes (continued)
  298.  
  299. Files
  300.  
  301.        o   Select which of the compression protocols you wish to make active 
  302.            for the current and/or subsequent sessions. The following list of 
  303.            programs are, at the present time, the only ones the program 
  304.            expects to support. This could change if additional protocols 
  305.            surface. CUDUP will support as many protocol upgrades as is 
  306.            possible.  Any of the following protocols not currently supported 
  307.            can not be selected from the list.          
  308.  
  309.                      ARC version 6.0 (not implemented)
  310.                      DWC version unknown 
  311.                      PAK currently version 1.6 ( plan to cover version 2.x)
  312.                      LARC currently implemented using LHARC
  313.                      LBR version unknown 
  314.                      LZH version 1.13 (expect new version any time)
  315.                      MD  version unknown 
  316.                      PKPAK not supported by PkWare. (implemented in CUDUP)
  317.                      PKZIP version 1.01 (as of 8/23/89)
  318.                      ZOO version unknown 
  319.  
  320.        When you 'turn on' an entry in the file table by hitting <Enter> you 
  321.        must fill in 6 entry fields. These are:
  322.  
  323.        Description: 12 characters describing the protocol  exp. ZIP ver 1.01
  324.  
  325.        Dlt File:     The name of the compression program used to perform 
  326.                      internal file deletions. This file must be in the 
  327.                      current DOS path. exp. PKZIP.EXE
  328.  
  329.        Ext:          File extention to look for when using this protocol. 
  330.                      Do not include the period.      exp. ZIP
  331.  
  332.        Delete option:up to 6 characters. This is the command line option used 
  333.                      when performing the delete function using the 
  334.                      compression protocol.   exp. -d
  335.  
  336.        Lst File:     The name of the compression program used to perform 
  337.                      internal file listings. This file must be in the 
  338.                      current DOS path.   exp. PKUNZIP.EXE
  339.  
  340.        List option:  up to 6 characters. This is the command line option 
  341.                      used when performing the list function using the 
  342.                      compression protocol.   exp. -cm
  343.  
  344.        When you 'turn off' an entry in the file table by hitting <Enter> the 
  345.         current fields will remain in effect but will be 'turned off' for at 
  346.         least this session.
  347. Environmental changes (continued)
  348.  
  349. Scope
  350.  
  351.        oScope is the degree to which CUDUP will check for duplicates.  
  352.         Normally CUDUP will only check filenames. There are times when 
  353.         this is not sufficient to find all "real" duplicates on the disk 
  354.         being examined.  Selecting Scope will allow you to add two 
  355.         additional tests to the duplicate check.  These are the file
  356.         size and the file creation date/time.  When you include either of 
  357.         these tests you are restricting the scope of files selected for 
  358.         display.
  359.  
  360. Match
  361.  
  362.        oMatch also restricts the duplicate tests made on the files on the 
  363.         disk being tested.  Select this menu option and when prompted you 
  364.         enter a wild card file mask for the group of files you want tested. 
  365.         The wild card mask is identical to the mask used on the DOS command 
  366.         line.  for example  *.DOC will only examine files with an extension 
  367.         of DOC.  
  368.  
  369. Delete confirm
  370.        oThere may be times when you wish to disable the delete confirmation 
  371.         request. Pressing enter while on this menu selection will turn 
  372.         Delete confirmation on and off.
  373.  
  374. Save
  375.  
  376.        oSelecting this option will allow you to save any of your changes to 
  377.         the executable file. (CUDUP.EXE)  For that reason you must not 
  378.         write protect the disk or set the executable to read-only unless you 
  379.         do not intend to use this feature.
  380.  
  381. Future Revisions
  382.  
  383. CUDUP is by no means complete.  Updates will be placed in Shareware 
  384. distribution channels as quickly as they become available and tested.
  385.  
  386. The source is available to registered users only.
  387.  
  388.               Thank you for trying CUDUP - Please register
  389.