home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util2 / twodisks.lzh / TWODISKS.DOC < prev    next >
Text File  |  1989-02-11  |  39KB  |  991 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   TwoDisks       
  12.  
  13.                     DISK COMPARISON AND UPDATING UTILITY     
  14.  
  15.                     Copyright (C) 1989 Barry L. Campbell
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                      (tm)  ┌─────────┐
  36.                      ┌─────┴───┐     │  MEMBER
  37.                    ──│         │o    │──────────────────
  38.                      │   ┌─────┴╨──┐ │  Association of
  39.                      │   │         │─┘  Shareware
  40.                      └───│    o    │    Professionals
  41.                    ──────│    ║    │────────────────────
  42.                          └────╨────┘
  43.  
  44.                    (Please see the note at the end of this file
  45.                    for information about the Association of
  46.                    Shareware Professionals.)
  47.  
  48.  
  49. TwoDisks Documentation                                    Table Of Contents
  50.  
  51.  
  52.  
  53. TABLE OF CONTENTS:
  54. =================
  55.  
  56.  
  57.       Quick Summary of Operation . . . . . . . . . . . . . . . . . . . .  1
  58.       Quick Summary of Use . . . . . . . . . . . . . . . . . . . . . . .  1
  59.       Copyright Notice . . . . . . . . . . . . . . . . . . . . . . . . .  1
  60.       Shareware Topics . . . . . . . . . . . . . . . . . . . . . . . . .  1
  61.       Registering TwoDisks . . . . . . . . . . . . . . . . . . . . . . .  2
  62.       Product Support. . . . . . . . . . . . . . . . . . . . . . . . . .  2
  63.       Copying TwoDisks . . . . . . . . . . . . . . . . . . . . . . . . .  3
  64.       Author's Promise . . . . . . . . . . . . . . . . . . . . . . . . .  3
  65.       Credits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  66.       Specifics on the Use of TwoDisks . . . . . . . . . . . . . . . . .  4
  67.         Color Configuration. . . . . . . . . . . . . . . . . . . . . . .  4
  68.         Entering Disk/Directory Names. . . . . . . . . . . . . . . . . .  4
  69.         Entry on the Command Line. . . . . . . . . . . . . . . . . . . .  5
  70.         Other Options on the First Screen. . . . . . . . . . . . . . . .  5
  71.       The Main TwoDisks Screen . . . . . . . . . . . . . . . . . . . . .  7
  72.         The Display Area . . . . . . . . . . . . . . . . . . . . . . . .  7
  73.         The Action Area. . . . . . . . . . . . . . . . . . . . . . . . .  8
  74.         Drive Assignments. . . . . . . . . . . . . . . . . . . . . . . .  8
  75.       What You Can Do With TwoDisks. . . . . . . . . . . . . . . . . . .  9
  76.         Deleting Files . . . . . . . . . . . . . . . . . . . . . . . . . 10
  77.           All Files. . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  78.           Tag Files. . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  79.           Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  80.         Copying Files. . . . . . . . . . . . . . . . . . . . . . . . . . 11
  81.           Checking Free Space Before Copy. . . . . . . . . . . . . . . . 12
  82.         Moving Files . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  83.         View Files . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  84.         Change Paths . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  85.       <HOME> Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  86.       To Exit From TwoDisks. . . . . . . . . . . . . . . . . . . . . . . 13
  87.       Notes on Operation of TwoDisks . . . . . . . . . . . . . . . . . . 13
  88.       The Association of Shareware Professionals . . . . . . . . . . . . 14
  89.       UPDATE NOTES (IMPORTANT) . . . . . . . . . . . . . . . . . . . . . 14
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.                                      Page i
  110.  
  111.  
  112. TwoDisks Documentation
  113.  
  114.  
  115. Quick Summary of Operation:
  116. ==========================
  117.  
  118. TwoDisks is a MS-DOS External Utility program which will READ and COMPARE
  119. the directories of TWO disks and show you the results of the comparison.  You
  120. may copy or move files between the disks or delete files from one or both of the
  121. disks.
  122.  
  123.  
  124. Quick Summary of Use:
  125. ====================
  126.  
  127. At the DOS prompt (A> for example) you may simply type
  128.  
  129.      A>TWODISKS
  130.  
  131. and then be prompted for the disks or directories you wish to compare. 
  132.  
  133. You may also enter the disks/directories for comparison on the command line
  134. after the command TwoDisks with the disks/directories separated by a SPACE as
  135.  
  136.      A>TWODISKS A C:\TURBO\FILES1 <RETURN>
  137.  
  138. which will compare the DEFAULT directory of the disk in drive A with the
  139. subdirectory FILES1 in the subdirectory TURBO on the hard disk C.
  140.  
  141. If you enter ONLY ONE drive or directory name you will be prompted for the
  142. other.
  143.  
  144.  
  145. Copyright Notice:
  146. ================
  147.  
  148. Both the TwoDisks program and this documentation are copyright (c) 1989 by Barry
  149. L. Campbell.  All rights conveyed by the copyright laws of the United States are
  150. strictly reserved.
  151.  
  152.  
  153. TwoDisks is Shareware:
  154. =====================
  155.  
  156. TwoDisks is NOT free.  TwoDisks is NOT in the public domain.  TwoDisks is a
  157. commercial program distributed as SHAREWARE.
  158.  
  159. The SHAREWARE concept provides the user with quality, tested, fully-functional
  160. software that can be evaluated on your own computer system and for your own
  161. specific computer needs before you decide to purchase.  No other means of
  162. software distribution (nor the sale of ANY other product by ANY other means)
  163. provides you with a more fair and generous GUARANTEE than SHAREWARE.  Even other
  164. software or products that come with a "money back guarantee" require you to pay
  165. for the privilege of trying the software or product and then re-packaging and
  166. returning the product (usually at your own expense) to the seller if you don't
  167. like it.  MANY software packages contain a "shrink wrap agreement" which in
  168. essence states that once you break the seal, it's yours.
  169.  
  170.  
  171.  
  172.                                      Page 1
  173.  
  174.  
  175. TwoDisks Documentation
  176.  
  177.  
  178. SHAREWARE provides the programmer with a distribution system that is convenient
  179. (for both of us) and low in cost.  This enables me to keep the price of my
  180. software low and still make a reasonable profit.
  181.  
  182. Please don't be confused!  SHAREWARE authors are competent programmers with good
  183. ideas for products that fill needs.  They are not "hackers" or amateurs that
  184. program for the fun of it.  They are BUSINESS men and women providing you with
  185. good software at a reasonable price.  SHAREWARE authors choose this method of
  186. distribution for their software because it is efficient and cost-effective. 
  187. They are professionals and rely on YOU to be fair and honest with them.
  188.  
  189. SHAREWARE works on the HONOR SYSTEM.  You have received TwoDisks for nothing (or
  190. a reasonable distribution fee essentially covering media and handling costs). 
  191. You may use the program free for 30 days.  You may even make copies of TwoDisks
  192. (subject to the limitations outlined below) and give these copies to your
  193. friends and associates for them to try.  If you find TwoDisks a useful program
  194. and choose to keep it and use it after the 30-day trial period, you are
  195. obligated to pay for it.
  196.  
  197.  
  198. Registering TwoDisks:
  199. ====================
  200.  
  201. The cost of TwoDisks is $25.00.  For this fee you will receive:
  202.  
  203.      - WRITTEN NOTIFICATION that you are a "registered owner" of TwoDisks.
  204.      - One FREE UPGRADE to the next version of TwoDisks when it is released.
  205.      - REDUCED PRICE offerings for future upgrades to TwoDisks.
  206.      - FREE PRODUCT SUPPORT via U.S. Mail or CompuServe.
  207.  
  208. To register send a check or money-order for $25.00 to:
  209.  
  210. Barry L. Campbell
  211. P.O. Box 1592
  212. Pearl City, HI 96782-8592
  213.  
  214. I will respond in writing within 2 working days of receipt of your check.
  215.  
  216.  
  217. Product Support:
  218. ===============
  219.  
  220. TwoDisks is fully-supported software.  I will reply to registered users'
  221. comments, questions, suggestions, etc. received via U.S. Mail (at the
  222. registration address) or EASYPLEX on CompuServe (I.D. number 73507,732).  I
  223. welcome your comments and suggestions for improving TwoDisks and I will be happy
  224. to answer questions about its use and function.  Although I have tested TwoDisks
  225. within an inch of its life, I also welcome your comments regarding BUGS (yeach!)
  226. you might come across.
  227.      
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.                                      Page 2
  236.  
  237.  
  238. TwoDisks Documentation
  239.  
  240.  
  241. Copying TwoDisks:
  242. ================
  243.  
  244. Although TwoDisks is copyrighted, you are encouraged to make a backup copy for
  245. yourself and to copy and share TwoDisks with your friends and associates.  
  246.      
  247.      - Individuals copying TwoDisks cannot charge for the copies.
  248.      - Bona-fide users groups may charge reasonable media and distribution fees
  249.        (not to exceed $10.00) for the copies.
  250.      - Software distribution services (those in business to make a profit from
  251.        the distribution of SHAREWARE and public domain software) may charge a
  252.        reasonable fee (not to exceed $10.00) after obtaining written permission
  253.        from the author.
  254.      
  255. No one may make any changes to the program code.  No one may make any changes to
  256. the documentation.  The documentation file (this file) MUST accompany any
  257. distribution of TwoDisks.
  258.  
  259.  
  260. Author's Promise:
  261. ================
  262.  
  263. The author, Barry L. Campbell, promises that the program, TwoDisks, will perform
  264. in substantial conformity with the user documentation.  The author makes no
  265. warranty of any kind, expressed or implied, including but not limited to implied
  266. warranties of merchantability and/or fitness for any particular purpose.  The
  267. author shall not be liable for any damages, whether direct, indirect, special or
  268. consequential arising from a failure of the program to operate in the manner
  269. desired by the user.  The author shall not be liable for any damage to data or
  270. property which may be caused directly or indirectly by the use of the program.
  271.  
  272. IN NO EVENT SHALL THE AUTHOR BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY
  273. LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  274. OUT OR YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER
  275. PARTY.
  276.  
  277.  
  278. Credits:
  279. =======
  280.  
  281. TwoDisks is written in Turbo Pascal, Ver 5.0, from Borland International with
  282. certain additional modules from Turbo Express by Robert Jourdain.  All screen
  283. displays were created using SAYWHAT?! from The Research Group and manipulated
  284. using modules written by The Research Group.
  285.  
  286. My thanks to Rick Kooker, Chris Calligan, Colin Huddleston and Karl Will for
  287. their help in beta testing TwoDisks.
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.                                      Page 3
  298.  
  299.  
  300. TwoDisks Documentation
  301.  
  302.  
  303. Specifics on the use of TwoDisks:
  304. =================================
  305.  
  306. 1. COLOR CONFIGURATION.
  307.  
  308. TwoDisks will check to see which screen driver card is installed in your
  309. computer and then configure itself for that card.  If you have a monochrome card
  310. installed, TwoDisks will configure itself for a monochrome monitor.  If you have
  311. a color card installed, TwoDisks will configure itself to show up in vibrant
  312. colors on your color monitor.
  313.  
  314. If you have a color card installed but do not have a color monitor attached
  315. (like many laptop computers these days) you must use the program TDMONO.EXE
  316. which is included in the archive.
  317.  
  318.  
  319. 2. ENTERING DISK/DIRECTORY NAMES.
  320.  
  321. It is important to understand the use of path names when entering directory
  322. names.  Entering
  323.  
  324.      A>TWODISKS A B
  325.  
  326. will compare the DEFAULT directories of the disks in drives A and B.
  327.  
  328. If you wish to specify a directory different from the DEFAULT directory you must
  329. use the COMPLETE DOS PATH including the colon (:) after the drive letter and the
  330. initial backslant (\) after the colon.  For example
  331.  
  332.      A>TWODISKS A:\ C:\TURBO\FILES1
  333.  
  334. will compare the ROOT directory of the disk in drive A with the subdirectory
  335. FILES1 in the subdirectory TURBO in the root directory of the disk in drive C
  336. (or hard disk if that is drive C).
  337.  
  338. The following are ALL INCORRECT:
  339.                       =========
  340.      A>TWODISKS A:\ C:TURBO
  341.                       ^-------{ Backslant after the colon is missing }
  342.  
  343.      A>TWODISKS A:\ \TURBO
  344.                     ^---------{ Drive letter and colon are missing }
  345.  
  346.      A>TWODISKS A:\ C\TURBO
  347.                      ^--------{ Colon after drive letter C is missing }
  348.  
  349. Consult your MS-DOS manual for a complete discussion of the DOS subdirectory
  350. structure system.
  351.  
  352. NOTE: As implied above, for convenience if you enter JUST A DRIVE LETTER,
  353. TwoDisks will use the DEFAULT DIRECTORY of that drive.
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                                      Page 4
  361.  
  362.  
  363. TwoDisks Documentation
  364.  
  365.  
  366. 3. ENTRY ON THE COMMAND LINE.
  367.  
  368. If you enter
  369.  
  370.      A>TWODISKS
  371.  
  372. alone (without drive or directory specifications) you will be prompted to enter
  373. them.  The rules on correct entry of directory information described in
  374. paragraph 2. (ENTERING DISK/DIRECTORY NAMES) above apply here.
  375.  
  376. If you enter
  377.  
  378.      A>TWODISKS A:\
  379.  
  380. with only ONE disk or directory entry you will be prompted to enter the other
  381. disk or directory.
  382.  
  383. If you enter
  384.  
  385.      A>TWODISKS A:\ C:\TURBO
  386.  
  387. with TWO disks or directories specified you will see
  388.  
  389.          ╔═══════════════════════════════════════════════════════════╗
  390.          ║  Enter DRIVE LETTER or COMPLETE Path:                     ║
  391.          ║                                                           ║
  392.          ║  Drive 1- A:\                                             ║
  393.          ║  Drive 2- C:\TURBO\                                       ║
  394.          ╚══════════════════════════════╡ Reading and Comparing ╞════╝
  395.  
  396. and TwoDisks will be reading and comparing the ROOT directory of the disk in
  397. drive A with the subdirectory called TURBO on the hard disk C.
  398.  
  399.  
  400. 4. OTHER OPTIONS ON THE FIRST SCREEN
  401.  
  402. The bottom of screen one looks like this:
  403.  
  404.       ╔═══════════════════════════════════════════════════════════════╗
  405.       ║ F1=Help, F2=Pick From List, F3=Make New Directory, <ESC>=QUIT ║
  406.       ╚═══════════════════════════════════════════════════════════════╝
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.                                      Page 5
  424.  
  425.  
  426. TwoDisks Documentation
  427.  
  428.  
  429. Pressing F1 while on this first screen will display the box below containing
  430. help on commands to use while editing the directory name and some simple rules
  431. on directory entry
  432.  
  433.        ╔═══════════════════════════════════════════════════════════════╗
  434.        ║                      DIRECTORY ENTRY                          ║
  435.        ║                                                               ║
  436.        ║    If you press <RETURN> on a blank line you may choose a     ║
  437.        ║    subdirectory by picking from a TREE listing of a drive.    ║
  438.        ║                                                               ║
  439.        ║    You may enter a DRIVE LETTER (with or without a colon)     ║
  440.        ║    to pick the DEFAULT DIRECTORY of that drive.               ║
  441.        ║                                                               ║
  442.        ║    You may enter a COMPLETE PATH like C:\LANGUAGE\TURBO       ║
  443.        ║    to choose a particular subdirectory.                       ║
  444.        ║                                                               ║
  445.        ╟───────────────────────────────────────────────────────────────╢
  446.        ║                        LINE EDITING                           ║
  447.        ║                                                               ║
  448.        ║ <-,-> : Cursor Left/Right        ^   : Move to 'Drive 1' line ║        
  449.        ║ HOME  : Beginning of Line        END : End of Line            ║        
  450.        ║ BKSP  : Delete Char Left         DEL : Delete Character       ║        
  451.        ║ INS   : Toggle Insert/Overtype   <─┘ : Enter Line             ║        
  452.        ║             CTRL-BKSP : Delete Entire Line                    ║        
  453.        ║                                                               ║
  454.        ╚═══════════════════════╡ Any Key ╞═════════════════════════════╝        
  455.  
  456. For editing a directory entry, for example, <CTRL-BKSP> (hold down the CONTROL
  457. key and press the BACKSPACE key) erases the entire line so you can enter an
  458. entirely new line.  
  459.  
  460. You may press F2 or simply press <RETURN> on a blank line to pick the
  461. subdirectory you want from a tree-type list of the subdirectories on a drive.
  462.  
  463. If the subdirectory you want does not yet exist on the drive you may press F3
  464. and create a new subdirectory.  You must enter the COMPLETE PATH for the new
  465. directory.
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.                                      Page 6
  487.  
  488.  
  489. TwoDisks Documentation
  490.  
  491.  
  492. 5. THE MAIN TWODISKS SCREEN.
  493.  
  494. After the comparison is made you will be presented with a screen like this:
  495.  
  496. ┌──────────────────────────────────────────────────────────────────────────────┐
  497. │                            ≡≡≡≡≡  TwoDisks  ≡≡≡≡≡                            │
  498. │    Disk Comparison and Updating Utility  Version 3.1     Compiled 01/01/89   │
  499. │         Copyright (c) 1989   Barry L. Campbell.  All rights reserved.        │
  500. └──────────────────────────────────────────────────────────────────────────────┘
  501. ╔═══════════════╤════════════════╦═════════════════════════════════════════════╗
  502. ║  FILES ON     │   FILES ON     ║            FILES ON BOTH DRIVES             ║
  503. ║  Drive 1      │   Drive 2      ╟──────────────┬──────────────┬───────────────╢
  504. ║  NOT ON       │   NOT ON       ║  NEWER ON    │  NEWER ON    │  IDENTICAL    ║
  505. ║  Drive 2:     │   Drive 1:     ║  Drive 1:    │  Drive 2:    │  ON BOTH:     ║
  506. ║  43 FILES     │   0 FILES      ║  3 FILES     │  5 FILES     │  11 FILES     ║
  507. ║  253559 bytes │   0 bytes      ║  103301 bytes│  32415 bytes │  51177 bytes  ║
  508. ╠═══════════════╪════════════════╬══════════════╪══════════════╪═══════════════╣
  509. ║ SHOW  FILES   │  SHOW  FILES   ║  SHOW  FILES │  SHOW  FILES │  SHOW  FILES  ║
  510. ║ DELETE FM 1   │  DELETE FM 2   ║  DELETE FM 2 │  DELETE FM 1 │  DELETE FM 1  ║
  511. ║ COPY   TO 2   │  COPY   TO 1   ║  COPY   TO 2 │  COPY   TO 1 │  DELETE FM 2  ║
  512. ║ MOVE   TO 2   │  MOVE   TO 1   ║  MOVE   TO 2 │  MOVE   TO 1 │  *CHG PATHS*  ║
  513. ╚═══════════════╧════════════════╩══════════════╧══════════════╧═══════════════╝
  514. ┌──────────────────────────────────────────────────────────────────────────────┐
  515. │ Drive 1- A:\  (37k Free)                                                     │
  516. │ Drive 2- C:\TURBO\ (12138k Free)                                             │
  517. └──────────────────────────────────────────────────────────────────────────────┘
  518. ┌──────────────────────────────────────────────────────────────────────────────┐
  519. │  <─┘ to SHOW FILES in this Category,  ARROWS to Select Action,  Q to QUIT    │
  520. └──────────────────────────────────────────────────────────────────────────────┘
  521.  
  522.      At the top of the screen you will see the TwoDisks information and
  523. copyright notice.  The next large double box below contains the "DISPLAY" area
  524. and the "ACTION" area outlined below.  Immediately below this are the drive
  525. assignments which show which two disks/directories are compared.  At the bottom
  526. of the screen you will find the help line.
  527.  
  528.      A. THE DISPLAY AREA.
  529.  
  530.      The area at the top of the large double box is the DISPLAY AREA.  It shows
  531. the status of the comparison of the two directories.  This example shows that
  532. there are 43 files (253559 bytes) that are on the disk in drive A (which is
  533. Drive 1 as shown in the box below) that are NOT on the subdirectory called TURBO
  534. on the hard disk C (which is Drive 2 as shown in the box below).  There are also
  535. 3 files (103301 bytes) that are NEWER on the disk in drive A that in the TURBO
  536. subdirectory on the hard disk C.  There are 5 file (32415 bytes) that are NEWER
  537. in the TURBO subdirectory on the hard disk C than on the disk in drive A and
  538. there are 11 files (51177 bytes) that are IDENTICAL on both disks.
  539.  
  540.                    ┌────────────── IMPORTANT NOTE ─────────────┐
  541.                    │ There is  no attempt to actually compare  │
  542.                    │ the files byte for byte.  "Identical" in  │
  543.                    │ TwoDisks simply means the files have the  │
  544.                    │ SAME NAME  and were created on the  SAME  │
  545.                    │ DAY at the SAME TIME.........That's all!  │
  546.                    └───────────────────────────────────────────┘
  547.  
  548.  
  549.                                      Page 7
  550.  
  551.  
  552. TwoDisks Documentation
  553.  
  554.  
  555.        When you copy a file using DOS COPY, the DATE and TIME information
  556.        for that file are copied along with the file.  But when you CREATE
  557.        a  file  using your  word processor or when  you write a  BASIC or
  558.        PASCAL program,  the DATE and TIME  information are placed  on the
  559.        file using the DATE and TIME from  your DOS system clock.   If you
  560.        have a built-in battery clock which automatically updates your DOS
  561.        system clock, then this information will be correct.
  562.  
  563.        If you don't have a built-in battery clock then  you must  SET the
  564.        DATE  and  TIME  when  you   power  up  your   computer.  TwoDisks
  565.        depends  on your DOS clock having the  right DATE and  TIME in its
  566.        comparison   of  files NEWER ON  DRIVE 1,   NEWER ON DRIVE  2  and
  567.        IDENTICAL as noted above. If you don't routinely ensure  your  DOS
  568.        system   clock is correct,  then TwoDisks can't help you determine
  569.        which is the newer version of files.
  570.        
  571.  
  572.      B. THE ACTION AREA.
  573.  
  574.      The area on the bottom of the large box is the ACTION AREA.  This is where
  575. you will select what you want to do now that you know how many files and bytes
  576. fall into the three categories.
  577.  
  578. At the bottom of the screen you will see these instructions
  579.  
  580. ┌──────────────────────────────────────────────────────────────────────────────┐
  581. │  <─┘ to SHOW FILES in this Category,  ARROWS to Select Action,  Q to QUIT    │
  582. └──────────────────────────────────────────────────────────────────────────────┘
  583.  
  584. You may select the different functions in the ACTION AREA using the arrow keys
  585. then press the <RETURN> key to perform the function.
  586.     
  587.      C. DRIVE ASSIGNMENTS.
  588.  
  589.      Just below the ACTION AREA will be shown the drive assignments.  In the
  590. above example the root directory of the disk in drive A is assigned as DRIVE 1
  591. and the TURBO subdirectory of the hard disk C is assigned as DRIVE 2.  This area
  592. also shows the free space on each disk in K-bytes.
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.                                      Page 8
  612.  
  613.  
  614. TwoDisks Documentation
  615.  
  616.  
  617. 6. WHAT YOU CAN DO WITH TWODISKS.
  618.  
  619. The first thing you can do with TwoDisks is see which files fall into each
  620. of the categories mentioned above.  You do this by selecting "SHOW FILES" under
  621. the category you wish to see.  As an example, if you select "SHOW FILES" under
  622. the first category (FILES ON DRIVE 1 NOT ON DRIVE 2) a block like this will
  623. appear
  624.  
  625.                  ╔═══════════════════════════════════════════╗
  626.                  ║ FileName         Size     Date      Time  ║
  627.                  ╟───────────────────────────────────────────╢
  628.                  ║ BLOCK.PAS         614   10-24-87   6:20pm ║
  629.                  ║ CONSTANT.INC    18136   12-13-87  11:33am ║
  630.                  ║ CRIT.PAS          415   12-28-87   4:20pm ║
  631.                  ║ DO-SHOW.PAS      6599   12-13-87   4:20pm ║
  632.                  ║ DRAWBOX.PAS       607   12-13-87   2:27pm ║
  633.                  ║ EDITLINE.PAS     1716   11-16-87   5:20pm ║
  634.                  ║ ENVIRON.COM     11788   12-21-87   9:20pm ║
  635.                  ║ ENVIRON.PAS      1227    1-02-80  10:19am ║
  636.                  ║ FIRST.PAS         533   11-28-87   2:24pm ║
  637.                  ║ FN.PAS            220   11-28-87   6:20pm ║
  638.                  ║ GETDRIVE         3219   11-25-87   4:20pm ║
  639.                  ║ GRAPH.BIN        5134    3-01-85   3:33am ║
  640.                  ║ GRAPH.P          3328    3-01-85   3:38am ║
  641.                  ║ HELPSCRN.PAS      425   11-28-87   4:20pm ║
  642.                  ║ HELPSCRN.TXT      451   11-28-87   4:20pm ║
  643.                  ║ HORIZSCR.PAS    13967    1-15-87   6:20pm ║
  644.                  ║ INT24.PAS        1608   12-28-87   4:20pm ║
  645.                  ║ INTEREST.PAS      388   10-27-87   8:34am ║
  646.                  ║ LABELS.FIL        106   11-29-87   4:20pm ║
  647.                  ║ LISTDIRS         2870   11-28-87   5:21pm ║
  648.                  ║ NEXTFILE.PAS    10254    2-03-86  10:49am ║
  649.                  ╚═════════════════╡ More ╞══════════════════╝
  650.  
  651. which shows the first 21 files (in alphabetical order) that are on the disk in
  652. drive A and not in the TURBO subdirectory of the hard disk C.  The word "More"
  653. in the bottom border of the SHOW FILES box indicates there are more files to
  654. see...just hit any key to show the next 21 (or fewer if there aren't 21 left to
  655. see) files in this category.  The word "More" is replaced by the words "Any Key"
  656. when the last of the files is displayed.  By pressing any key at this time you
  657. will return to the ACTION AREA and the SHOW FILES box will disappear.
  658.  
  659. NOTE:  When you are SHOWING FILES you may NOT ACT on the files, just see the
  660. names, sizes and date/time info on the files in that category.
  661.  
  662.      You can DO principally THREE things to the files on your disks with
  663. TwoDisks -
  664.  
  665.      1 - DELETE files from a disk or directory
  666.      2 - COPY files to the other disk or directory
  667.      3 - MOVE files from one disk or directory to the other
  668.  
  669.      The choices presented in the ACTION AREA of the main menu represent all the
  670. logical choices that one might want to do with the files in that particular
  671. category.  For example, for FILES ON DRIVE 1 NOT ON DRIVE 2 you may want to
  672. delete the file from drive 1 (since it is not on drive 2 you can't delete from
  673.  
  674.                                      Page 9
  675.  
  676.  
  677. TwoDisks Documentation
  678.  
  679.  
  680. there) or you may want to COPY or MOVE a file from drive 1 to drive 2.  If the
  681. file falls into the NEWER ON DRIVE 2 (than on drive 1) category you may want to
  682. DELETE the older version from drive 1, or COPY or MOVE the newer version from
  683. drive 2 to drive 1 but you would not likely want to delete the newer version
  684. from drive 2 nor replace the newer version with the older version that is on
  685. drive 1 so those choices aren't available.
  686.  
  687.  
  688.      A. DELETING FILES
  689.  
  690.      To DELETE all or some of the files in a category, use the arrow keys to
  691. highlight the "DELETE FROM  " selection under that category then press
  692. <RETURN>.  You will see a box called the "ALL OR TAG BOX" that looks like this
  693.  
  694.                     ╔═════════════════════════════════════╗
  695.                     ║      DELETE Files From Drive 1      ║
  696.                     ╟───────────────────┬─────────────────╢
  697.                     ║ Total in Category │                 ║
  698.                     ║        43 Files   │                 ║
  699.                     ║    253559 Bytes   │                 ║
  700.                     ╟───────────────────┴─────────────────╢
  701.                     ║                                     ║
  702.                     ╟─────────────────────────────────────╢
  703.                     ║     All Files, Tag Files, Quit      ║
  704.                     ╚═════════════════════════════════════╝
  705.  
  706. The "A" in "All Files", the "T" in "Tag Files" and the "Q" in "Quit" will be
  707. highlighted. 
  708.  
  709.           (1) ALL FILES.
  710.  
  711.           If you press "A" you will be asked if you are sure you really want to
  712. DELETE all the files in that category...press "Y" if you are sure or "N" if you
  713. are not (or if you are sure you DON'T want to delete all the files in that
  714. category).  NOTE:  This is the ONLY "IC" (idiot check) in TwoDisks.  For the
  715. remainder of the choices you are asked to make TwoDisks assumes you really want
  716. it to do what you told it to do and will set out to do it.  TwoDisks will now
  717. proceed to delete all the files in the category, one file at a time in
  718. alphabetical order (as they were shown in the SHOW FILES box).
  719.  
  720.        ┌──────────────────────────── ABORTING ───────────────────────────┐
  721.        │ You may  ABORT  the deletion  process  at any  time by pressing │
  722.        │ the  <ESC>  key.  TwoDisks will  continue with the  deletion of │
  723.        │ the file  that is currently in progress  then halt  all further │
  724.        │ deletions.  The disks/directories  will be re-read and compared │
  725.        │ and the new comparison will be shown in the DISPLAY AREA.       │
  726.        └─────────────────────────────────────────────────────────────────┘
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.                                      Page 10
  739.  
  740.  
  741. TwoDisks Documentation
  742.  
  743.  
  744.           (2) TAG FILES.
  745.  
  746.           If you press "T" you will be shown the "TAG FILES" menu which looks
  747. like this
  748.  
  749.                     ╔═════════════════════════════════════╗
  750.                     ║      DELETE Files From Drive 1      ║
  751.                     ╟───────────────────┬─────────────────╢
  752.                     ║ Total in Category │  Total Tagged   ║
  753.                     ║        43 Files   │       0 Files   ║
  754.                     ║    253559 Bytes   │       0 Bytes   ║
  755.                     ╟───────────────────┴─────────────────╢
  756.                     ║    BLOCK.PAS            614 bytes   ║
  757.                     ╟─────────────────────────────────────╢
  758.                     ║ Select^|  Tag/Untag<Space>   <─┘Go  ║
  759.                     ╚═════════════════════════════════════╝
  760.  
  761. and the first file in the category (in alphabetical order) will appear in the
  762. "FILE" line.  You may "step" down (and up) the list of files using the
  763. down-arrow and up-arrow keys.  When you come to a file you wish to delete simply
  764. press the <SPACE BAR> and the "»»" symbol will appear next to the file name
  765. indicating that this file is "TAGGED" for deletion.  The <SPACE BAR> is a TOGGLE
  766. and will UNTAG a previously TAGGED file if you change your mind.  When you
  767. are finished tagging the files you wish to delete just press the <RETURN> key
  768. and the process will begin.  As above, you may abort at any time by pressing the
  769. <ESC> key.
  770.  
  771.           (3) QUIT.
  772.  
  773.           If you selected DELETE FILES by mistake or just change your mind about
  774. deleting files right now just press "Q" and you will be returned to the main
  775. menu ACTION AREA.  (I put this in because I got here a couple times with no way
  776. to gracefully leave.)
  777.  
  778.  
  779.      B. COPYING FILES.
  780.  
  781.      To COPY files from one disk/directory to the other, select the "COPY TO
  782. DRIVE  " choice in the ACTION AREA with the arrow keys and press <RETURN>.  You
  783. will see essentially the same "ALL OR TAG BOX" as you would if you chose to
  784. delete files except the box will say "COPY Files From Drive 1 to Drive 2" (for
  785. example).  The ALL, TAG or QUIT choices work the same way as in the delete box
  786. and you may abort the selected operation in progress by pressing the <ESC> key. 
  787. You will not be asked if you are sure when you choose ALL (as promised).  As
  788. files are tagged the number of files tagged and the total size (in bytes) that
  789. have been tagged are shown.  This will give you an idea of how many bytes you
  790. will be copying to the other disk.  This is only a convenience, however, as the
  791. exact space required by a file on your disk is not just the same as the size of
  792. the file in bytes due to the cluster size of the particular disk in question. 
  793. Also if the file already exists on the target disk (in an older version, of
  794. course) you may actually gain space instead of using it if the newer version is
  795. smaller than the older one.
  796.  
  797.  
  798.  
  799.  
  800.  
  801.                                      Page 11
  802.  
  803.  
  804. TwoDisks Documentation
  805.  
  806.  
  807.           (1) CHECKING FREE SPACE BEFORE COPY.
  808.  
  809.           TwoDisks won't let you do anything bad.  It will actually check the
  810. free space remaining on the target disk to ensure there will be enough room to
  811. complete the copy process before it starts the copy.  In most cases this works
  812. just fine, but there is the (slight) chance that even though there are just
  813. enough bytes free on the target disk, the cluster size precludes copying the
  814. entire file onto the disk.  If you get a "disk full" error on a copy operation
  815. you may have to delete something before you can copy that file to that disk.
  816.  
  817.      C. MOVING FILES.
  818.  
  819.      This is essentially the same as copying files except only one copy of the
  820. file exists after the process is complete.  When MOVING from one disk to
  821. another, the file is successfully copied FIRST to the target disk THEN the file
  822. is deleted from the source disk.
  823.  
  824.      When moving from one subdirectory to another on the same drive (the hard
  825. disk C:, for example) and if the file doesn't already exist in the target
  826. subdirectory, a DOS function call is used to move the directory information for
  827. the file to the target subdirectory rather than moving the actual contents of
  828. the file to another location on the disk.  This is much faster...and much
  829. safer.  If the file does already exist in the target subdirectory (in an older
  830. version, of course) then the older version is first deleted from that
  831. subdirectory and the DOS function call is used to move the newer file's
  832. directory information.  This, too, is much faster than first copying and then
  833. deleting.
  834.  
  835.      D. VIEW FILES
  836.  
  837.      While you are tagging files to DELETE, COPY or MOVE you may view the
  838. contents of the file by pressing the F1 (Function 1) key.  You can view any
  839. ASCII (text) file in this manner to see if this is really the one you want to
  840. DELETE (for example).  If the file is NOT a text file, you may see some
  841. gibberish when viewing the file but you may still be able to tell something
  842. about the file if there is any ASCII text in the code.
  843.  
  844. NOTE:  When you view a file in any of the "FILE ON BOTH DRIVES" categories you
  845. will see the file the action is about to be done on.  For example, if you select
  846. "DELETE FROM DISK 1" and then press F1 to view a file, you will be viewing the
  847. copy of the file that is on DISK 1 (even though there is another copy of the
  848. file on DISK 2).
  849.  
  850.      You can view the entire contents of a text file, one screen at a time, by
  851. pressing any key (except "Q") when prompted, or you can view a screen or two and
  852. the press "Q" to return to the tagging operation.
  853.  
  854.      D. CHANGE PATHS
  855.  
  856.      The selection on the bottom-right of the ACTION AREA called *CHG PATHS* is
  857. used when you wish to change one or both of the disks/directories you are
  858. comparing.  You may select this choice using the arrow keys or you may use the
  859. <END> key to move immediately from any other choice to this one.  Pressing the
  860. <RETURN> key will clear the screen and you will be presented with the opening
  861. screen (to select drives).  The previous choice for DRIVE 1 will be displayed
  862.  
  863.  
  864.                                      Page 12
  865.  
  866.  
  867. TwoDisks Documentation
  868.  
  869.  
  870. with the cursor at the end of that disk/directory specification.  If you do not
  871. wish to change this drive then press <RETURN> and it will be selected as DRIVE
  872. 1.  The same action would be required if you do not wish to change your
  873. selection for DRIVE 2.  This feature is especially useful when you will be
  874. comparing many different disks in (say) drives A: and B:.  Put two disks in the
  875. drives, perform the comparison and any deletes, copies or moves you wish then
  876. change one or both of the disks and select *CHG PATHS*.  Accept the two defaults
  877. (A: and B:) from before and you are off and running in the comparison of the two
  878. new disks.
  879.  
  880.      E. <HOME> KEY
  881.  
  882.      The <HOME> key will take you immediately to the SHOW FILES choice under the
  883. first category from any other choice in the ACTION AREA.
  884.  
  885.  
  886.      F. TO EXIT FROM TWODISKS
  887.  
  888.      Anytime you are moving around in the ACTION AREA you may exit from TwoDisks
  889. by pressing "Q".  This only works when you have NOT selected the DELETE, COPY or
  890. MOVE files options.  The bottom line on the screen which says 
  891.  
  892. ┌──────────────────────────────────────────────────────────────────────────────┐
  893. │  <─┘ to SHOW FILES in this Category,  ARROWS to Select Action,  Q to QUIT    │
  894. └──────────────────────────────────────────────────────────────────────────────┘
  895.  
  896. will be ON when you may exit from TwoDisks.  If a line saying "Q to QUIT" is not
  897. on the screen you may not quit using the "Q" key.  You must leave the action you
  898. have chosen and return to the ACTION AREA of the main menu in order to quit.
  899.  
  900.      G. NOTES ON THE OPERATION OF TWODISKS.
  901.  
  902.           (1) TwoDisks always uses the DOS "verify" option when copying files. 
  903. This is a simple read-after-write check to verify the copy operation proceeded
  904. correctly.  The state of the DOS verify flag is checked on entry into TwoDisks
  905. and that state restored upon exiting.  The DOS verify flag defaults to OFF and
  906. may be set ON by the user at the DOS prompt by typing "VERIFY ON" and may be
  907. turned back off by typing "VERIFY OFF" at the DOS prompt.  The verify option
  908. slows the copy process somewhat (not so you can notice) but ensures your copy
  909. operations are valid.
  910.  
  911.           (2) TwoDisks reports only on files on your disks that are "normal",
  912. that is, NOT on System files (like MSDOS.SYS and IO.SYS) and NOT on hidden
  913. files.
  914.  
  915.           (3) TwoDisks writes directly to the screen memory in order to provide
  916. the fastest and smoothest screen displays.  Care was taken to guard against
  917. "snow" or "flicker" in your color display.  
  918.  
  919.           (4) TwoDisks is limited to no more than 500 files on a single
  920. subdirectory.  If a subdirectory has more than 500 files, results are
  921. unpredictable except to say that TwoDisks won't work right!
  922.  
  923.           (5) TwoDisks requires about 180k of memory to operate.
  924.  
  925.  
  926.  
  927.                                      Page 13
  928.  
  929.  
  930. TwoDisks Documentation
  931.  
  932.  
  933. The Association of Shareware Professionals (ASP) was formed in April 1987 to
  934. strengthen the future of shareware (user supported software) as an alternative
  935. to commercial software.  Its members, all of whom are programmers who subscribe
  936. to a code of ethics, are committed to the concept of shareware as a method of
  937. marketing.
  938.  
  939. Some of the goals of ASP are:
  940.  
  941.      - to inform users about shareware programs and about shareware as a method
  942.        of distributing and marketing software
  943.      
  944.      - to encourage broader distribution of shareware through user groups and
  945.        disk dealers who agree to identify and explain the nature of shareware
  946.      
  947.      - to foster a high degree of professionalism among shareware authors by
  948.        setting programming, marketing and support standards for ASP members to
  949.        follow.
  950.      
  951. For more information about the Association of Shareware Professionals please
  952. contact the author:
  953.  
  954. Barry L. Campbell
  955. P.O. Box 1592
  956. Pearl City, HI 96782-8592
  957.  
  958. ===============================================================================
  959. UPDATE NOTES:
  960.  
  961. 2/11/89   VER 3.11  Fixed BUG!!! reported by Peter Dyke (thanks) in copying
  962.                     very large (over 300k) files.
  963.  
  964.                     Removed "infuriating" (actually OBNOXIOUS!) noise on load
  965.                     and unload.    --bc
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.                                      Page 14
  991.