home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util4 / cudup12.lzh / CUDUP.DOC next >
Text File  |  1989-09-30  |  18KB  |  386 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.              Colorado Utilities Duplicate File Manager (CUDUP)
  13.  
  14.                                 version 1.2
  15.  
  16.                                     by
  17.  
  18.                                Fred C. Hill
  19.  
  20.                           Micro System Solutions
  21.  
  22.  
  23.                         _______
  24.                         ____|__     |               (tm)
  25.                      --|       |    |-------------------
  26.                        |   ____|__  |  Association of
  27.                        |  |       |_|  Shareware
  28.                        |__|   o   |    Professionals
  29.                      -----|   |   |---------------------
  30.                           |___|___|    MEMBER
  31.  
  32.  
  33.  
  34. Your first use of CUDUP constitutes agreement to the following license
  35. provisions.  If you do not agree to them please do not use this program.
  36.  
  37. CUDUP is a copyrighted program offered 'as is' for your personal use, testing
  38. and evaluation.  A limited license is granted to use and to duplicate this
  39. program for your personal use. After a reasonable period of time (approx 2
  40. weeks) you are expected to register with the author or discontinue your use
  41. of this program.
  42.  
  43. Micro System Solutions authorizes you to make archive copies of this software
  44. for the sole purpose of back-up and protecting your investment from loss. 
  45. The executable version along with this documentation, in an unmodified
  46. format, may be freely shared with anyone.  You may not distribute any of the
  47. CUDUP source code or pre-compiled units (TPU files). You may utilize the
  48. source code for anything you desire as long as the distribution of the
  49. resulting program does not bring you into a direct competition with Micro
  50. System Solutions.
  51.  
  52. The source for CUDUP is provided only to registered users. 
  53.  
  54. This software may be used by one person on as many computer systems as that
  55. person uses. 
  56.  
  57. Micro System Solutions warrants any physical diskettes and documentation
  58. provided to be free of defects in material and workmanship for a period of
  59. 30 days from the date of receipt. If you notify us of such a defect within
  60. the warranty period, Micro System Solutions will replace the defective
  61. diskette(s) or documentation at no cost.
  62.  
  63. Ombudsman Policy:
  64.  
  65. Fred C. Hill is a member of the Association of Shareware Professionals (ASP).
  66. ASP wants to make sure that the shareware principle works for you. If you are
  67. unable to resolve a shareware-related problem with an ASP member by
  68. contacting the member directly, ASP may be able to help. The ASP Ombudsman
  69. can help you resolve a dispute or problem with an ASP member, but does not
  70. provide technical support for members' products. Please write to the ASP
  71. Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve message
  72. via easyplex to ASP Ombudsman 70007,3536
  73.  
  74. Trademarks
  75.  
  76. Turbo Power Software is a trademark of Turbo Power Software
  77.  
  78. Turbo Professional is a registered trademark of Sunny Hill Software, used
  79. under license to Turbo Power Software
  80.  
  81. Turbo Pascal is a trademark of Borland International.
  82.  
  83. MS-DOS is a trademark of Microsoft Corporation.
  84.  
  85. IBM PC, XT, AT are registered trademarks of International Business Machines
  86. Corporation.
  87.  
  88. ARC is a trademark of System Enhancement Associates (SEA)
  89.  
  90.  
  91. Software required
  92.  
  93. CUDUP requires no additional software to execute. It will, however, only
  94. execute properly under MS/DOS version 3.0 and higher. (It has not been tested
  95. under MS/DOS 4.x) You may elect to add one or more compression/decompression
  96. programs from the following list:
  97.  
  98.                file
  99.      pgm       ext       company   version   comments
  100.      ---       ---       -------   -------   ----------------    
  101.      ARC       ARC       SEA       6.0       * not implemented
  102.      DWC       DWC       ????      ????      * not implemented
  103.      PAK       PAK       ????      1.6       * implemented using ARC
  104.      ARC       LARC      K. Miki             * implemented using LHARC
  105.      LBR       LBR       ????      ????      * not implemented
  106.      LZH       LHARC     H.Yoshizaki 1.13
  107.      MD        MD        ????      ????      * not implemented
  108.      ARC       PKPAK     PKWare    all
  109.      ZIP       PKZIP     PKWare    1.01
  110.      ZOO       ZOO       ????      ????      * implemented/not tested
  111.  
  112. Acknowledgements
  113.  
  114. A special thanks to Phillip K. Burns for the outstanding work he has done in
  115. providing the programming world with the source to read the compression 
  116. decompression library directories used in this product.  Thanks also to the
  117. many people and companies involved in the programming of those utilities. 
  118.  
  119. The programming tool used in this project is Turbo Professional 5.0 by Turbo
  120. Power Software. This is a library of over 600 state-of-the-art routines
  121. covering almost all areas of IBM PC programming. They have provided us with
  122. the capability to provide better products to our users. Micro System
  123. Solutions uses the TPro tools exclusively in its products and recommends them
  124. highly to novice and experienced programmers alike.
  125. CUDUP manipulates the files on your disk through standard DOS calls. Neither
  126. the author nor Micro System Solutions accept any responsibility for damaged
  127. or lost files, data or media from use of this program.
  128.  
  129. Hardware required
  130.  
  131. CUDUP runs on any 100% IBM compatible microcomputer.  It will use as much
  132. memory as you have available for the program and the required data storage. 
  133. CUDUP will create a configuration file if the Save & Exit option is selected
  134. in the environment menu. No other disk files other than the program (.EXE)
  135. file are required.  This documentation assumes you will be running CUDUP from
  136. a hard drive installed as drive C:, however CUDUP will run from any hard or
  137. floppy drive on your system.
  138.  
  139. Although it has not been tested, CUDUP should run on a network drive as well. 
  140. No file locks are done however and contention problems may arise during file
  141. deletions.  Each user should have a registered copy of CUDUP or the
  142. organization should have a LAN site license.
  143. Registration
  144.  
  145.                                               Date:_____________  
  146. FROM:  
  147.  
  148. Name:____________________________   Company:_________________________  
  149.   
  150. Address:_________________________  Title:___________________________  
  151.   
  152. City:______________________ State:________ Zip:___________  
  153.   
  154.  
  155. Telephone:_____________________ Home( )  Office ( )  
  156.  
  157. Where did you first get/hear of our product? ________________________ 
  158.   
  159. Colorado Utilities Duplicate File manager (CUDUP)      $27.00
  160.      includes diskette with:
  161.                1. Latest executable version
  162.                2. Documentation on disk
  163.                3. Complete source  
  164.                     (does not include Turbo Professional libraries)
  165.                4. Shipping and Handling
  166.   
  167.  
  168.        For overseas shipment add:                      $ 3.00  
  169.  
  170.        Colorado customers add 3% state sales  
  171.            tax and appropriate local tax:             $ _______
  172.   
  173.                                    Order Total:       $ _______  
  174.   
  175. Diskette format   5.25"______ or 3.5"_______ (check one)  
  176.   
  177. Send to:                                 
  178. **************************      VISA or MASTERCARD ACCEPTED:  
  179. * Micro System Solutions *  
  180. *                        *           (circle one)  
  181. * 5417 S. Cimarron Rd.   *  
  182. *                        *     Card No.___________________________ 
  183. * Littleton, CO  80123   *   
  184. *                        *    Expiration Date:____/____  
  185. **************************  
  186.                             Authorized 
  187.                             Signature:________________________________ Executing CUDUP
  188.  
  189. Start CUDUP from the command line as follows:
  190.  
  191.      CUDUP [/M] [/I] [d:]
  192.  
  193.           all parameters are optional and mutually exclusive.
  194.  
  195.           /M   -    initializes the program using the monochrome (B&W)
  196.                     colorset.
  197.  
  198.           /I   -    begins execution at the environment menu. This option
  199.                     allows you to set the colors and/or compression protocols
  200.                     for the immediate execution instead of a furture one.
  201.  
  202.           /E   -    disables compression library expansion. Only DOS files
  203.                     will be processes during this session. This flag will
  204.                     revert to enable expansion at the termination of this
  205.                     session.
  206.  
  207.           d:   -    d: is the optional disk drive to read from.  The default
  208.                     drive will be used if d: is not provided. Only one drive
  209.                     is allowed in this version of CUDUP.  Future versions
  210.                     will support multiple disk drives.
  211.  
  212. If the /I (initialize) option is used the program begins execution in the
  213. environment menu, which allows you to establish what the current and possibly
  214. subsequent program executions will be like. While in the environment menu you
  215. may elect to change colors, or select the compression protocol used during
  216. the duplicate file check. See the section on Environmental changes for
  217. complete details.
  218.  
  219. CUDUP reads the entire disk.... storing DOS files.... reading any of the
  220. implemented compression library files.... and storing the internal filenames
  221. into a large memory array. When (and if) the available memory becomes full
  222. CUDUP will continue reading directories but will not add additional files
  223. into the array.
  224.  
  225. When CUDUP finishes reading all filenames on the disk, the array is sorted
  226. and non-duplicates are discarded. The remaining files (duplicates) are
  227. displayed.
  228.  
  229. Browsing through the list of files is done using the cursor control keys. 
  230. The program will terminate and return to DOS when the Esc key is hit while
  231. in the file list window.
  232. Deleting Files
  233.  
  234. To delete any of the duplicate files, you first position the cursor
  235. (highlighted line) on the line containing the file to you want deleted. Hold
  236. down the Ctrl key and hit 'D'.  Upper or lower case is accepted.  You will
  237. be asked to confirm the deletion by answering 'Y' to the question 'delete
  238. file?'. Any answer other than 'Y' will abort the delete and continue with the
  239. file list. 
  240.  
  241. If the file to be deleted is a standard DOS file it will be deleted
  242. immediately. (Remember that a compression library is a standard DOS file and
  243. there may be duplicates on your disk. If you delete it you will also delete
  244. the files contained within it.)
  245.  
  246. If the file is contained within one of the compression protocol library files
  247. the appropriate program ('PKPAK', 'PKZIP', LHARC, etc.) will be called to
  248. perform the actual deletion. No checks are made to insure the deletion took
  249. place as requested.
  250.  
  251. If you delete the compressed library file the contents of that library will
  252. remain on the duplicate list. Any attempt to delete those files will probably
  253. result in an error. (No checks are currently made to insure the file is still
  254. present.)
  255.  
  256. The current version performs all requested deletions as the request is made.
  257. Future versions will provide an option to store all external calls to the
  258. compression/decompression programs until you request an exit to DOS.  The
  259. future plans also call for you to be able to 'install' the compression
  260. library program of your choice.
  261. Environmental changes
  262.  
  263. CUDUP allows you to change the environment under which you operate. You enter
  264. the environment menu by using the /I command line option or by hitting the
  265. F10 key when in the file list. At the present time you may do any of the
  266. following:
  267.  
  268. Default colors
  269.  
  270.      o    Sets the default colors for the video card you are presently using.
  271.           If a monochrome or B&W video card is detected the system will set
  272.           for monochrome, otherwise the default colorset will be implemented.
  273.  
  274. Colors & Monochrome (B&W)
  275.  
  276.      o    Reset the colors or monochrome (B&W) for each of the display
  277.           windows.
  278.  
  279.           -    Each of the parts of the display windows is contained in the
  280.                two column list on the right of the screen. Use the up/down
  281.                arrows to select the window part you wish to change and hit
  282.                <Enter>. Then use the up/down/left/right arrow keys to
  283.                navigate within the color selection window until the selection
  284.                box is positioned over the new color for the selected part. 
  285.                Hit <Enter> and the color will be stored. 
  286.           NOTE: if you entered the color menu via the F10 key then most new
  287.           colors will only be made available for the following sessions.
  288.  
  289.           -    If you selected Monochrome from the menu or by the use of the
  290.                '/M' option on the command line, then the default colors will
  291.                be set automatically. NOTE: if you entered the menus via the
  292.                F10 key then the monochrome settings will take effect during
  293.                the next and following sessions.
  294. Environmental changes (continued)
  295.  
  296. Files
  297.  
  298.      o    Select which of the compression protocols you wish to make active
  299.           for the current and/or subsequent sessions. The following list of
  300.           programs are, at the present time, the only ones the program
  301.           expects to support. This could change if additional protocols
  302.           surface. CUDUP will support as many protocol upgrades as is
  303.           possible.      
  304.  
  305.                ARC version 6.0
  306.                DWC version unknown (not implemented)
  307.                PAK currently version 1.6 ( plan to cover version 2.x)
  308.                LARC currently implemented using LHARC
  309.                LBR version unknown (not implemented)
  310.                LZH version 1.13 (expect new version any time)
  311.                MD  version unknown (not implemented)
  312.                PKPAK no longer supported by PkWare. implemented in CUDUP
  313.                PKZIP version 1.01 (as of 8/23/89)
  314.                ZOO version unknown (the implementation is not tested)
  315.  
  316.           When you 'turn on' an entry in the file table by hitting <Enter>
  317.           you must fill in 4 entry fields. These are:
  318.  
  319.                Description:   12 characters describing the protocol    exp.
  320.                               ZIP ver 1.01
  321.  
  322.                File:          12 character file name (not including path) of
  323.                               the compression program used to perform
  324.                               internal file deletions. This file must be in
  325.                               the current DOS path.   exp. PKZIP.EXE
  326.  
  327.                Ext:           File extention to look for when using this
  328.                               protocol. Do not include the period.      exp.
  329.                               ZIP
  330.  
  331.                Delete option: up to 6 characters. This is the command line
  332.                               option used when performing the delete function
  333.                               using the compression protocol.   exp. -d
  334.  
  335.           When you 'turn off' an entry in the file table by hitting <Enter>
  336.           the current fields will remain in effect but will be 'turned off'
  337.           for at least this session.
  338. Environmental changes (continued)
  339.  
  340. Save and Exit
  341.  
  342.      o    Selecting this option will allow you to save any of your changes
  343.           to the configuration file. (CUDUP.CFG) The configuration file is
  344.           written as a text file but has no identification associated with
  345.           the fields. Any attempt to alter the .CFG file with a text editor
  346.           may destroy any changes you have saved.  You may restore all of the
  347.           system defaults by deleting the configuration file. You may also
  348.           may the monochrome (B&W) option permanent by executing the program
  349.           as follows:
  350.                CUDUP /M /I<Enter>
  351.                -    select the Save and Exit option from the menu. The
  352.                     monochrome defaults will be written to the configuration
  353.                     file and will take effect automatically from that point
  354.                     on.
  355.  
  356.           If you hit the Esc key you will exit the environmental menu but
  357.           your changes will only be effective during the current session. 
  358.           You may re-enter the menus by hitting the F10 key if you wish to
  359.           save the environment to the configuration file.
  360.  
  361.           NOTE:     A future version of CUDUP will have an option to update
  362.           the executable instead of maintaining a configuration file.  Future Revisions
  363.  
  364. CUDUP is by no means complete.  I would like to propose that any changes made
  365. to enhance this product be sent to me, Fred Hill, by regular mail, on disk
  366. (5.25 or 3.5), or by message on Compuserve (PPN # 76060,102). If you send
  367. code you may send it to me as a binary EMail msg. You will receive full
  368. credit and will share in any future profits derived from the sale of CUDUP.
  369. The actual profit sharing will be worked out to our mutual satisfaction prior
  370. to inclusion of your code segments.
  371.  
  372. I have no plans to restrict access to the source code by registered users,
  373. so if this will constitute a problem for you I ask that you not provide me
  374. with your source code.
  375.  
  376. I also reserve the rights to make any and all changes at any time as I see
  377. fit. All decisions concerning releases and changes will be made by me. I
  378. expect this product to evolve very quickly into a full blown system utility
  379. and updates will be placed in Shareware distribution channels as quickly as
  380. they become available and tested.
  381.  
  382. This offer is available to registered users only.
  383.  
  384.                Thank you for trying CUDUP - Please register
  385.  
  386.