home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / kopyca25.arj / KOPYCAT.DOC next >
Encoding:
Text File  |  1991-08-15  |  9.7 KB  |  239 lines
  1.                   KOPYCAT File-Copying Utility
  2.                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  3.                           Version  2.5
  4.                             91-08-15
  5.  
  6. KOPYCAT is a file-copying program designed for single-floppy
  7. systems. It can also be used as an ordinary copy program.
  8.  
  9. Assuming you have a hard drive and one floppy drive, how do
  10. you copy a file from one disk to another? The normal procedure
  11. would be to:
  12.  
  13. 1) insert the source disk
  14. 2) copy the file onto your hard drive
  15. 3) swap disks
  16. 4) copy the file from your hard drive onto the floppy
  17. 5) delete the file from your hard drive
  18.  
  19. Even with drives of different sizes a similar scenario occurs. Both
  20. situations involve a lot of disk shuffling and file fiddling.
  21.  
  22. With KOPYCAT, here's what happens:
  23.  
  24. 1) insert your source disk
  25. 2) tell KOPYCAT which file you want to copy
  26. 3) swap disks when prompted
  27. 4) press <ENTER>
  28.  
  29. That doesn't look like a terrific energy saving, but after trying
  30. both methods I'm sure you will agree KOPYCAT makes life a lot
  31. easier.
  32.  
  33. As an added feature, it even lets you make more than one copy of a
  34. file. Just keep swapping disks and tell KOPYCAT you want to `Make
  35. another copy', and it will. No need to read the source file over
  36. and over ... it's already in RAM.
  37.  
  38. Finally, KOPYCAT retains the file attributes of the original file
  39. (Archive, System, Read-Only, Hidden) and also duplicates the date
  40. and time.
  41.  
  42.  
  43. Usage
  44. ^^^^^
  45. * * * NEW FEATURE * * * beginning with version 2.3
  46.  
  47. KOPYCAT now accepts up to 2 command line arguments. These are a
  48. filename to copy FROM and a switch to turn off the integrity
  49. checking. They can be in
  50. either order, and are not case sensitive. The switch to turn off
  51. integrity checking is '-v' or '-V'. For example, if you were to
  52. type:
  53.  
  54. kopycat -v myfile.doc  or
  55. kopycat myfile.doc -V
  56.  
  57. you would bypass the integrity check AND the opening screen, and be
  58. presented with a prompt for a file to copy TO. The FROM prompt
  59. would be filled in with 'myfile.doc'. By using the '-v' switch
  60. during all runs of KOPYCAT, you can compress KOPYCAT.EXE using
  61. PKLite or Diet or other similar programs. Remember to un-compress
  62. it if you want to check it once in a while. If the integrity switch
  63. is left out, KOPYCAT will go through with it, and if all is OK,
  64. pass on to the opening screen.
  65.  
  66. When you run KOPYCAT * without * the integrity check, it checks
  67. itself for tampering, either from a virus or someone fiddling with
  68. my program. If the program finds a problem, it will abort.
  69. Remember, if you have squeezed KOPYCAT.EXE, you must unsqueeze it
  70. before checking the integrity, or it will definitely fail.
  71.  
  72. Depending on whether you provide a filename on the command-line or
  73. not, you may be presented with an opening screen and a brief
  74. description of the program. After pressing a key you are prompted
  75. for a filename to copy FROM.
  76.  
  77. Let's say you have a file on a floppy disk (MYFILE.DOC) and you
  78. want to copy it to another floppy disk. At the first prompt, you
  79. would type `a:\myfile.doc'. KOPYCAT looks for the file on drive A:
  80. and if it finds it, copies it into RAM. You are then prompted for
  81. the name of the file you want to copy it TO.
  82.  
  83. At this point you have a couple of options. Pressing <ENTER> will
  84. recall EXACTLY what you typed in at the first prompt. This is
  85. useful when you are copying a file to another floppy disk and want
  86. to retain the same name. You can also rename the file while
  87. copying, or type in any other location you wish. For this example,
  88. you could just press <ENTER> and the line will be filled in with
  89. `A:\MYFILE.DOC'.
  90.  
  91. *
  92. * *
  93. * * * 
  94.      Don't be alarmed when the drive light goes on before you are
  95.      prompted for the Target disk. I'm checking to see if the drive
  96.      is actually a removable media or not. I do this simply to
  97.      avoid asking someone to `Insert Target disk in Drive C:'. A
  98.      small thing perhaps, but I like it. If enough people complain
  99.      about it, I'll rearrange things. If there is no disk in the
  100.      target drive, KOPYCAT will eventually ask you to insert one.
  101. * * *
  102. * *
  103. *
  104.  
  105. Next you are prompted to insert the target disk. Press a key when
  106. you have done this, and KOPYCAT first determines if there is enough
  107. room to make the copy. If not, you are notified, and prompted for
  108. another disk.
  109. If there is enough room, KOPYCAT next checks the directories you
  110. named. If they don't exist, KOPYCAT will ask you if you want to
  111. create them. If you answer affirmative, things move along. If you
  112. answer negative, you are brought back to enter a file to copy TO.
  113.  
  114. If the file you want to copy TO already exists, you will be
  115. informed, and given a choice to replace it or not. It doesn't
  116. matter whether the file is Read-Only, Hidden, System or any
  117. combination. If you answer `yes' to replace it, KOPYCAT first
  118. erases the file, then checks to ensure there is enough space on the
  119. disk to continue with the copy.
  120.  
  121. Upon successfully copying your file, you are asked whether you want
  122. to make another copy, copy another file, or quit. Making another
  123. copy is slightly different from copying another file. The first
  124. choice means you want to make more copies of the SAME FILE. The
  125. second choice is when you want to copy a DIFFERENT FILE.
  126.  
  127. What KOPYCAT Does ...
  128. ^^^^^^^^^^^^^^^^^^^^^
  129. Only legal characters for filenames are allowed. This includes some
  130. of the Alt-numeric keypad codes.
  131.  
  132. If it can't find the file you want to copy FROM, it will tell you,
  133. and after a brief pause, prompt you again.
  134.  
  135. If it can't find the Target Drive you specified, it will tell you
  136. and ask you again for the file to copy TO.
  137.  
  138. If there isn't enough memory in your system to copy the whole file
  139. into RAM, KOPYCAT will tell you, then prompt you for another file.
  140.  
  141. If there is not enough space on the Target Disk, KOPYCAT informs
  142. you, and prompts you to insert another disk.
  143.  
  144. If the file exists on the Target Disk, KOPYCAT tells you, and gives
  145. you the option of erasing it or not.
  146.  
  147. If you give it non-existent sub-directory/ies to copy a file TO,
  148. you will be informed, and asked whether you wish to create it/them.
  149. If you answer in the affirmative, KOPYCAT will create the sub-
  150. directory/ies, then copy your file.
  151.  
  152. Remember that directories are technically files, and as such they
  153. are limited to 11 characters long and blank spaces are not allowed.
  154. In addition, if the name is longer than 8 characters, it must have
  155. a `.' after the 8th character, or else it gets truncated. A
  156. directory name like `MYTOOLBOX' will get chopped to `MYTOOLBO',
  157. however `MYTOOL.BOX' would be OK. Check your DOS manual for more
  158. information on subdirectories. Also, DOS limits the number of
  159. subdirectories you can have off the root. Different versions of DOS
  160. do different things. For now, check it out. In future versions of
  161. KOPYCAT I may include routines to check this for you.
  162.  
  163. If the disk you want to copy a file TO is write-protected, you will
  164. be informed, and given an opportunity to remove the protection.
  165.  
  166. When you exit the program all memory used by KOPYCAT is freed up.
  167.  
  168.  
  169. What KOPYCAT Doesn't ...
  170. ^^^^^^^^^^^^^^^^^^^^^^^^
  171. KOPYCAT does not copy multiple files. In other words you can't
  172. answer something like `a:\*.exe' to the first prompt. Perhaps in a
  173. future release.
  174.  
  175. KOPYCAT does not use spill files, or temporary files. 
  176.  
  177. KOPYCAT does not massage directory names to conform to DOS
  178. standards. It is your responsibility to pass a legal name to
  179. KOPYCAT. In future releases, I may include routines to check this
  180. for you.
  181.  
  182.  
  183. Legalese ...
  184. ^^^^^^^^^^^^
  185. KOPYCAT is copyright by me (Amer Neely) 1990 - 1991 but is
  186. distributed as shareware. That means you can use it and give copies
  187. to your friends or upload it to electronic BBSs'. If you do please
  188. include this file along with the executable. If you like the
  189. program please consider sending me a monetary contribution. The
  190. amount is up to you. Make a money order or cheque payable to:
  191.  
  192. Amer Neely / Softouch Ltd.
  193. P.O. Box 1538 Station B
  194. London Ontario CANADA
  195. N6A 5M3
  196.  
  197. I have done my best to see the program operates in the manner
  198. described and is well-behaved. In the event of real or perceived
  199. data loss or damage, or hardware damage, you the user assume all
  200. responsibility.
  201.  
  202. Professor Timo Salmi of The University of Vassa, Finland, has
  203. kindly given me permission to use some of his Turbo Pascal
  204. routines. He is a prolific writer of Turbo Pascal units and is also
  205. the moderator of the anonymous ftp site `garbo.uwasa.fi' on the
  206. Internet. Thank you Professor Salmi.
  207.  
  208. William C. Thompson deserves mention for his XCRT unit. This is an
  209. extension to the normal Turbo Pascal CRT unit. Some handy routines
  210. in there. I use the box-drawing procedure, slightly altered to work
  211. on either mono or color systems. He can be reached at
  212. `wct@po.cwru.edu' on the Internet. Thank you Mr. Thompson.
  213.  
  214. KOPYCAT History ...
  215. ^^^^^^^^^^^^^^^^^^^
  216. 2.5  Fixed bug allowing a non-existent drive to be entered as a  
  217.      Target Drive.
  218. 2.4  Fixed box-drawing routine so it works on color systems.
  219. 2.3  Added command-line arguments (filename and/or integrity
  220.      switch). Better check for write-protection on Target Disk.
  221.      Started including this file with distribution.
  222. 2.2  Tightened up file reading/writing code. Eliminated a lot of
  223.      extraneous code.
  224. 2.1  Not sure what I did here. Guess that shows how well I document
  225.      my work!
  226. 2.0  First release to general public.
  227.  
  228. Amer Neely
  229. 91-08-15
  230.  
  231. bcnu...
  232.  
  233. +--------------------------------*------------------------------+
  234. | Life is a fractal ...          |  Amer Neely                  |
  235. |                                |  P.O. Box 1538 Stn. B        |
  236. |       in Hilbert Space!   ;-)  |  London ON  CANADA N6A 5M3   |
  237. |                                |  CIS: 71650,763              |
  238. +--------------------------------*------------------------------+
  239.