home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / Dloads / UTILITIE / DUPES300.ZIP / DUPES.DOC next >
Text File  |  1991-06-09  |  20KB  |  484 lines

  1.                        ████████████████████
  2.                        ██                ██
  3.                        ██     Dupes      ██
  4.                        ██                ██
  5.                        ██  Version 3.00  ██ 
  6.                        ██                ██
  7.                        ████████████████████
  8.                              
  9. ┌───────────────────────────────────────────────────────────────┐
  10. │ GENERAL                                                       │
  11. └───────────────────────────────────────────────────────────────┘
  12.  
  13.     Dupes finds duplicate files and empty directories on a hard 
  14. disk or in a series of diskettes.  To run the program, enter: 
  15.  
  16.  
  17.        DUPES [drive:[/M][/Odir][/Xdir]...] [/P] [/S] [?]
  18.  
  19.  
  20.     Brackets indicate optional arguments, and ellipses (...) show 
  21. arguments you can repeat.  Don't put spaces between the drive 
  22. letter, colon, and the /M, /O, and /X arguments.  If you give no
  23. drive letter, Dupes checks only the default drive. 
  24.  
  25.     Argument meanings: 
  26.  
  27.  
  28. drive  Disk drive letter.  Don't specify the same drive more than 
  29.        once. 
  30.  
  31. /M     Makes Dupes prompt for multiple diskettes in the specified 
  32.        drive.  You could use /M to check a series of diskettes 
  33.        for duplicate files.   
  34.  
  35. /Odir  Makes Dupes check only in the specified directory (put its 
  36.        name after "/O") and subordinate directories.  This option 
  37.        is useful if you're on a large, multiuser system where 
  38.        each user has a separate directory.  If you don't use /O, 
  39.        Dupes checks the entire disk (unless you use /X--see 
  40.        below).  Put the full directory name after the /O, 
  41.        starting with a backslash.  
  42.  
  43. /Xdir  Exempts the specified directory from checking.  You could 
  44.        use /X if you have a directory where are no duplicate 
  45.        files, but where Dupes' attempts to check might cause 
  46.        sharing violations.  Put the full directory name after the 
  47.        /X, starting with a backslash.  
  48.  
  49. /P     Makes Dupes pause after each group of potential duplicate 
  50.        files and ask if you want to delete them.  It also makes 
  51.        Dupes ask if you want to delete empty directories.  NOTE:  
  52.        Don't use /P if you redirect Dupes' output.  See the 
  53.        section on Output. 
  54.  
  55. /S     Makes Dupes consider files duplicates only if their names, 
  56.        sizes, and date/time stamps are the same.  If you don't 
  57.        use /S, Dupes considers files potential duplicates if just 
  58.        their names match. 
  59.  
  60. ?      Shows program syntax
  61.  
  62.  
  63. Note:  If you want to apply /M, /O, or /X to the default drive, 
  64. you must explicitly give its drive letter. 
  65.  
  66. ┌───────────────────────────────────────────────────────────────┐
  67. │ EXAMPLES                                                      │
  68. └───────────────────────────────────────────────────────────────┘
  69.  
  70.  
  71. DUPES 
  72.      
  73. Checks the default drive for duplicate files (by name only). 
  74.       
  75. -----------------------------------------------------------------
  76.  
  77. DUPES D:
  78.  
  79. Checks all of drive D: for files whose names match. 
  80.  
  81. -----------------------------------------------------------------
  82.  
  83. DUPES C:  D: 
  84.  
  85. Checks drives C: and D: for files whose names match. 
  86.  
  87. -----------------------------------------------------------------
  88.  
  89. DUPES /P /S 
  90.  
  91. Checks the default drive for files whose name, size and date/time 
  92. stamp match.  After displaying each group of duplicates, Dupes 
  93. asks if you want to delete them. 
  94.  
  95. -----------------------------------------------------------------
  96.  
  97. DUPES A:/M  C: 
  98.  
  99. Checks on drives A: and B: for files whose names match.  It 
  100. prompts the user for multiple diskettes in drive A:. 
  101.  
  102. -----------------------------------------------------------------
  103.  
  104. DUPES A:  C:/O\WOR 
  105.  
  106. Checks drives A: and C: for duplicate files.  It checks every 
  107. directory on drive A:, but on drive C;, checks only directory 
  108. \WOR and subordinate directories. 
  109.  
  110. -----------------------------------------------------------------
  111.  
  112. DUPES A:/O\TMP  C:/M  D:/X\WP /S
  113.  
  114. Checks drive A: for duplicate files, but only in directory \TMP 
  115. and subordinate directories.  It checks all of drive C:, 
  116. prompting for multiple diskettes.  It checks all of drive D:, 
  117. except in directory D:\WP.  On all the checked disks, it 
  118. considers files duplicates only if their name, size, and 
  119. date/time stamp match. 
  120.  
  121. ┌───────────────────────────────────────────────────────────────┐ 
  122. │ OUTPUT                                                        │ 
  123. └───────────────────────────────────────────────────────────────┘ 
  124.  
  125.     If Dupes finds duplicate files, it shows the name of each 
  126. file, & the size, date/time stamp, disk name (if /M used) & 
  127. directory of each copy.  Example: 
  128.  
  129.  
  130.    CUSTOMER.DBF
  131.     12230  10/13/90  18:46:28  CUSTO  A:\
  132.     12230  10/13/90  18:46:28         C:\
  133.  
  134.       ^       ^         ^       ^     ^
  135.      File  Date last Time last Disk   Directory
  136.      size  modified  modified  name
  137.  
  138.  
  139.     In the above example, Dupes reports finding the file 
  140. CUSTOMER.DBF on both drive A: and drive C:.  Since the two copies 
  141. of the file have identical sizes and date time stamps, they are 
  142. almost certainly the same file. 
  143.  
  144.     At the end of the file list, Dupes shows the how many 
  145. potential duplicates it found, & an estimate of how much disk 
  146. space you would gain by deleting them.  The latter is only 
  147. approximate, though, because it depends on which files you 
  148. delete.  Note:  The number displayed will probably be larger than 
  149. the sum of the duplicate file sizes.  This is because it is based 
  150. on disk cluster size, giving a more accurate measure of the disk 
  151. space the files occupy.  If you use the /P argument and have 
  152. Dupes delete files for you, the displayed number reflects the 
  153. approximate amount of space which can be saved by getting rid of 
  154. the remaining undeleted files. 
  155.  
  156. ┌───────────────────────────────────────────────────────────────┐ 
  157. │ PRINTING OR FILING THE OUTPUT                                 │ 
  158. └───────────────────────────────────────────────────────────────┘ 
  159.  
  160.     Normally, output goes to the screen.  However, if you have 
  161. many duplicate files, the output may quickly scroll off the 
  162. screen.  To avoid this problem, you can send the output to a file 
  163. or printer to examine at your leisure.   NOTE:  Don't redirect 
  164. the output if you use the /P option.  If you do, you won't see 
  165. the prompt asking if you want to delete files, and the system 
  166. will appear to have crashed. 
  167.        
  168.     To redirect Dupes' output to a file, enter something like: 
  169.  
  170.  
  171.          DUPES > DUPES.TXT
  172.  
  173.  
  174.     To send the output to a parallel printer, enter:
  175.  
  176.  
  177.          DUPES > PRN
  178.  
  179.  
  180.     To send the output to a serial printer, enter
  181.  
  182.  
  183.          DUPES > COM1    (or COM2, or whatever)
  184.  
  185.  
  186.     If you want to print only part of the output, press ^P or 
  187. ^PrtSc when the output reaches the part you want to print. 
  188.  
  189.     To make the output pause after each full screen, enter: 
  190.  
  191.  
  192.          DUPES | MORE
  193.  
  194.  
  195. NOTE:  For this to work, the MORE program must be in the current 
  196. directory, or in a directory shown in your PATH environment 
  197. variable. 
  198.  
  199. ┌───────────────────────────────────────────────────────────────┐ 
  200. │ SYSTEM REQUIREMENTS                                           │ 
  201. └───────────────────────────────────────────────────────────────┘ 
  202.  
  203.     Dupes requires MS-DOS or PC-DOS, version 2.0 or later.  The 
  204. number of files it can handle depends on how much memory you 
  205. have.   With 640K memory, you can usually handle several thousand 
  206. files.  
  207.  
  208. ┌───────────────────────────────────────────────────────────────┐ 
  209. │ EXIT CODES                                                    │
  210. └───────────────────────────────────────────────────────────────┘
  211.  
  212.     Dupes reports the following exit codes.  You can use these 
  213. with the ERRORLEVEL function in batch files (see your DOS manual 
  214. for details). 
  215.  
  216.     0  Normal termination
  217.     1  User aborted
  218.     2  Error occurred
  219.  
  220. ┌───────────────────────────────────────────────────────────────┐ 
  221. │ WHAT'S IN THIS PACKAGE                                        │
  222. └───────────────────────────────────────────────────────────────┘
  223.  
  224.     This package contains the following files:
  225.  
  226.     DUPES.EXE     Main program
  227.     DUPES.DOC     Documentation
  228.     REGISTER.DOC  Registration form
  229.     CATALOG.DOC   Catalog of other software available
  230.  
  231. ┌───────────────────────────────────────────────────────────────┐ 
  232. │ REVISION HISTORY                                              │
  233. └───────────────────────────────────────────────────────────────┘
  234.  
  235. 1.00  Original version
  236.  
  237. 2.00  Changed name from The Duplicate File Finder
  238.       Added display of file size & date/time stamp
  239.       Added capability to specify drive
  240.       Added /S option
  241.  
  242. 3.00  Added capability to check multiple drives 
  243.       Added capability to find empty directories
  244.       Added /O, /M, /P and /X options
  245.       Greatly improved speed
  246.  
  247.  
  248. ┌───────────────────────────────────────────────────────────────┐ 
  249. │ MESSAGES                                                      │ 
  250. └───────────────────────────────────────────────────────────────┘ 
  251.  
  252. Aborted as requested.  You pressed ^C or ^Break.
  253.  
  254. Couldn't delete xxxxxx.  DOS wouldn't delete the file for some 
  255. reason.  See if the file is "read only" or is in use by another 
  256. program.                 
  257.  
  258. Couldn't remove xxxxxx.  DOS wouldn't remove the directory for 
  259. some reason.  See if the directory is "read only."
  260.  
  261. Delete xxxxxx [on disk "xxxxxx"]? (Y/N/I/S)  You used /P, so 
  262. Dupes is asking if you want to delete the indicated file.  To 
  263. delete it, press Y.  To leave it alone, press N.  If you want to 
  264. ignore this group of files, press I.  To have Dupes stop asking 
  265. if you want to delete files and remove directories, press S. 
  266.  
  267. Directories must start with backslash.  Omit the drive letter and 
  268. colon when using /O or /X.  Just put the full directory path, 
  269. starting with a backslash (indicating root directory). 
  270.  
  271. Directory too long.  The directory specified with /O or /X is too 
  272. long, and may not even exist. 
  273.  
  274. Empty directories.  The following directories have no files in 
  275. them.  However, even empty directories take up space on your 
  276. disk.  Deleting them (use the RD command) will free up more 
  277. space.
  278.  
  279. Invalid directory (xxxxxx).  The directory specified with /O or 
  280. /X doesn't exist or was unavailable for some reason. 
  281.  
  282. Invalid drive (X:).  The drive doesn't exist or is unavailable 
  283. for some reason. 
  284.  
  285. No duplicates found.  Dupes found no files with the same name 
  286. (or, if you used /S, with the same name, size & date/time stamp). 
  287.  
  288. No duplicates remaining.  The program found duplicate files, but 
  289. you deleted them all. 
  290.  
  291. XXX potential duplicate(s)...  Dupes found files that may be 
  292. duplicates, but only you can make the final determination.  Look 
  293. at the list Dupes produced to tell.  Note:  If you use the /P 
  294. option and delete files, the "potential duplicate(s)" message 
  295. reflects the number of files remaining after deletions. 
  296.  
  297. Not enough memory.  Your computer needs more memory to handle all 
  298. the file names on the disk(s).  If you're running other programs 
  299. concurrently, or have resident utilities or device drivers, try 
  300. deinstalling them. 
  301.  
  302. Put disk "xxxxxx" in drive X:, then press a key.  You used /M, so 
  303. you must insert the proper diskette before Dupes can delete the 
  304. file you requested. 
  305.  
  306. Put (next) disk in drive X: & enter its name.  You used /M, and 
  307. Dupes is asking for the diskette (or next diskette) in that 
  308. drive.  Insert the requested diskette, then enter its name (up to 
  309. five characters).  If there are no more diskettes for that drive, 
  310. just press Enter. 
  311.  
  312. Remove? (Y/N/S).  You used /P, so Dupes is asking if you want to 
  313. remove the indicated directory, which is empty.  Press Y to 
  314. remove it, N to not remove it, or S to have Dupes stop asking. 
  315.  
  316. Syntax:....  Please check the correct syntax & try again. 
  317.  
  318. ┌───────────────────────────────────────────────────────────────┐ 
  319. │ CREDITS                                                       │
  320. └───────────────────────────────────────────────────────────────┘
  321.  
  322.     Dupes was written in C by Richard W. Adams.  It was developed 
  323. with PC-Write, version 3.02, & the Microsoft C Optimizing 
  324. Compiler, version 5.1. 
  325.  
  326.     The author is a member of the Association of Shareware 
  327. Professionals (ASP).  You may reach him at the address given in 
  328. REGISTER.DOC.  Should that address no longer be valid, try 
  329. contacting him through the ASP (545 Grover Road, Muskegon, MI 
  330. 49442).  He is also sometimes available on CompuServe 
  331. (76430,1071). 
  332.  
  333. ┌───────────────────────────────────────────────────────────────┐ 
  334. │ REGISTRATION                                                  │
  335. └───────────────────────────────────────────────────────────────┘
  336.  
  337.     Dupes is copyright 1991 by Richard W. Adams, all rights 
  338. reserved.  The program is "shareware."  If you use Dupes for more 
  339. than 30 days, you must register.  To do so, complete the 
  340. registration form in REGISTER.DOC & send it with a check for the 
  341. indicated amount to the author at the address on the form.
  342.  
  343. When you register, you receive:
  344.  
  345.     o The right to use your copy of Dupes on a single computer.
  346.  
  347.     o Free technical support by mail for three months.
  348.  
  349.     o Eligibility for free copies of future versions if you're 
  350.       the first to suggest improvements or report bugs that are 
  351.       fixed/incorporated in future versions. 
  352.  
  353.    Not only is registration a legal & ethical requirement, but 
  354. registration fees give shareware authors the incentive to develop 
  355. new software & improve old ones. 
  356.  
  357.     Tax exempt Christian religious organizations & churches are 
  358. eligible for free registration of Dupes for official business.  
  359. Send a written request to the author, & you'll receive 
  360. registration forms.  The registration takes effect when you 
  361. complete return the forms.  This is a charitable donation. 
  362.  
  363.     Companies, government agencies & other organizations may 
  364. obtain site licenses for Dupes, at greatly reduced unit costs.  
  365. Contact the author for details & a price list. 
  366.  
  367. ┌───────────────────────────────────────────────────────────────┐ 
  368. │ SHAREWARE                                                     │ 
  369. └───────────────────────────────────────────────────────────────┘ 
  370.  
  371.     Shareware distribution gives users a chance to try software 
  372. before buying it. If you try a Shareware program and continue 
  373. using it, you are expected to register.  Individual programs 
  374. differ on details--some request registration, others require it, 
  375. and some specify a maximum trial period.  With registration, you 
  376. get anything from the simple right to continue using the software 
  377. to an updated program with printed manual. 
  378.  
  379.     Copyright laws apply to both Shareware and commercial 
  380. software, and the copyright holder retains all rights, with a few 
  381. specific exceptions as stated below.  Shareware authors are 
  382. accomplished programmers, just like commercial authors, and the 
  383. programs are of comparable quality. (In both cases, there are 
  384. good programs and bad ones!)  The main difference is in the 
  385. method of distribution.  The author specifically grants the right 
  386. to copy and distribute the software, either to all and sundry or 
  387. to a specific group.  For example, some authors require written 
  388. permission before a commercial disk vendor may copy their 
  389. Shareware. 
  390.  
  391.     Shareware is a distribution method, not a type of software. 
  392. You should find software that suits your needs and pocketbook, 
  393. whether it's commercial or Shareware. The Shareware system makes 
  394. fitting your needs easier, because you can try before you buy. 
  395. And because the overhead is low, prices are low also. Shareware 
  396. has the ultimate money-back guarantee--if you don't use the 
  397. product, you don't pay for it. 
  398.  
  399. DISCLAIMER - AGREEMENT 
  400.  
  401.     Users of Dupes must accept this disclaimer of warranty: 
  402. "Dupes is supplied as is.  The author disclaims all warranties, 
  403. expressed or implied, including, without limitation, the 
  404. warranties of merchantability and of fitness for any purpose. The 
  405. author assumes no liability for damages, direct or consequential, 
  406. which may result from the use of Dupes." 
  407.  
  408.     Dupes is a Shareware program and is provided at no charge 
  409. for your evaluation.  Feel free to share it with your friends, 
  410. but please don't give it away altered or as part of another 
  411. system.  The essence of "user-supported" software is to provide 
  412. personal computer users with quality software without high 
  413. prices, and yet to provide incentive for programmers to continue 
  414. to develop new products.  If you find Dupes useful and continue 
  415. to use it after a reasonable trial period, you must make a 
  416. registration payment of $10.00 to the author.  The $10.00 
  417. registration fee will license one copy for use on any one 
  418. computer at any one time.  You must treat this software just like 
  419. a book.  An example is that any number of people may use this 
  420. software and may freely move it from one computer location to 
  421. another, so long as there is no possibility of it being used at 
  422. one location while it's being used at another.  Just as two 
  423. different people can't read a book at the same time. 
  424.  
  425.     Commercial users of Dupes must register and pay for their 
  426. copies of Dupes within 30 days of first use or their license is 
  427. withdrawn.  Site-License arrangements may be made by contacting 
  428. the author. 
  429.  
  430.     Anyone distributing Dupes for any kind of remuneration must 
  431. first contact the author for authorization. This authorization 
  432. will be automatically granted to distributors recognized by the 
  433. (ASP) as adhering to its guidelines for shareware distributors, 
  434. and such distributors may begin offering Dupes immediately. 
  435. (However, you must still advise the author so the distributor can 
  436. be kept up-to-date with the latest version of Dupes.) 
  437.  
  438.     You are encouraged to pass a copy of Dupes to your friends 
  439. for evaluation.  Please encourage them to register their copy if 
  440. they find that they can use it.
  441.  
  442. ┌───────────────────────────────────────────────────────────────┐ 
  443. │ COPYING                                                       │ 
  444. └───────────────────────────────────────────────────────────────┘ 
  445.  
  446. You may copy & distribute Dupes freely, as long as you:
  447.  
  448.     o Don't distribute it for commercial purposes without written 
  449.       permission from the author. 
  450.  
  451.     o Don't rent or lease it.
  452.  
  453.     o Include all constituent files.
  454.  
  455.     o Don't change the software or documentation.
  456.  
  457.     o Charge no fee other than a nominal one to cover distribution 
  458.       costs.
  459.  
  460.  
  461. ┌───────────────────────────────────────────────────────────────┐ 
  462. │ OMBUDSMAN                                                     │ 
  463. └───────────────────────────────────────────────────────────────┘ 
  464.  
  465.     The author is a member of the Association of Shareware 
  466. Professionals (ASP).  ASP wants to make sure that the shareware 
  467. principle works for you. If you can't resolve a shareware related 
  468. problem with an ASP member by contacting the member directly, ASP 
  469. may be able to help.  The ASP Ombudsman can help you resolve a 
  470. dispute or problem with an ASP member, but does not provide 
  471. technical support for members' products.  Please write to the ASP 
  472. Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a 
  473. CompuServe mail message to the ASP Ombudsman (70007,3536). 
  474.  
  475.         _______
  476.    ____|__     |                (R)
  477. --|       |    |-------------------
  478.   |   ____|__  |  Association of
  479.   |  |       |_|  Shareware
  480.   |__|   o   |    Professionals
  481. -----|   |   |---------------------
  482.      |___|___|    MEMBER
  483.  
  484.