home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / disks / copyprgs / ECopy100 / ECopy.doc next >
Encoding:
Text File  |  1992-05-05  |  6.3 KB  |  173 lines
  1.  
  2.                     =====================================
  3.                      ECopy V1.00  Economical File Copier
  4.                                 Documentation
  5.                                - May 3, 1992 -
  6.                     =====================================
  7.  
  8.  
  9.                Copyright (c) 1992 by Sam Yee.  All rights reserved.
  10.  
  11.  
  12.  
  13.  
  14. COPYRIGHT
  15. ---------
  16.  
  17. The program ECopy and its documentation are written and copyrighted by
  18. Sam Yee.   They may be distributed freely providing the following
  19. restrictions are satisfied:
  20.  
  21. o Distributors may not charge more than the cost of a diskette used in
  22.   the distribution of this program.
  23.  
  24. o Distributors may only distribute the unmodified copy of the original
  25.   program, along with it's documentation, and copyright notices intact.
  26.  
  27. o Commercial distribution is only possible with written permission from
  28.   the author.
  29.  
  30.  
  31. DISCLAIMER
  32. ----------
  33.  
  34. This program and its documentation is provided "as is".  No warranties
  35. are made with respect to the accuracy, reliability, performance or
  36. operation of this software and information.  You are using this program
  37. at your own risk.  The author is not liable for any damages that may
  38. have been caused by using this software.
  39.  
  40.  
  41. INTRODUCTION
  42. ------------
  43.  
  44. Have you ever wanted to copy files from your harddrive onto floppy
  45. disks, so that the number of disks used is kept at a minimum?  For
  46. example, you have 100 pictures (eg. IFF) or sound files (eg. modules)
  47. on your harddrive, and you wanted to copy them to disks.  Now, a
  48. hundred files of moderate size would take many disks.  Of course you
  49. may say, why don't I use a harddrive backup program?  The problem with
  50. this method is that if you want to retrieve a file from the backup disks
  51. it would take a long time.
  52.  
  53.  
  54. REQUIREMENTS
  55. ------------
  56.  
  57. This program runs on any Amiga with OS 2.04 or higher.
  58.  
  59.  
  60. USER MANUAL
  61. -----------
  62.  
  63. ECopy must be run from the CLI/Shell and has the following command line
  64. template:
  65.  
  66. ECopy [options] [FROM] <file> ... [TO] <DestPath>
  67.  
  68. The "FROM" and "TO" keywords are optional and are ignored.  "<file> ..." 
  69. is the listing of files you want to copy to the destination path, 
  70. "<DestPath>" (eg. DF0:).
  71.  
  72. The options are:
  73.  
  74.  -b<size>   Buffer size (in K).  Default is 8K.  Minimum is 1K.
  75.  -c         Clone (ie. same date, protection bits, etc.) the files.
  76.  -l         List all the files that could not be copied.
  77.  -m         Move (automatic cloning) files instead of copying.
  78.  -q         Quiet mode (does not display copying status).
  79.  -r<size>   Reserve space (in K) on destination disk.
  80.  -s<suffix> Add suffix to copied files.
  81.  
  82. -b This option is for setting the buffer size (in kilobytes) used in
  83.    the copying process.  The closer the buffer size is to the file
  84.    size, the faster the program will copy.  A buffer size of 8K is 
  85.    generally good.  For example, "ECopy -b4 * DF0:" will copy all the 
  86.    files in the current directory to the disk drive "DF0:" with a 4096 
  87.    byte buffer.
  88.  
  89. -c This option is for cloning the copied files so that both the source
  90.    and destination files have the same dates, comments, and protection
  91.    bits.
  92.  
  93. -l This option allows you to list all the files that could not be copied
  94.    to the disk(s) you supplied.  If this option is not specified, only
  95.    the number of files not copied is displayed.  Each filename will be
  96.    displayed along with its file size when this option is enabled.
  97.  
  98. -m This option is for moving files from the source directory to the
  99.    destination disk.  That is, a file is deleted after it's copied. All 
  100.    files protected from deletion will not be deleted.  If a file cannot 
  101.    be copied the original copy is not deleted.  Cloning is automatic with 
  102.    this option enabled.
  103.  
  104. -q This causes the filenames not to be displayed while copying.
  105.  
  106. -r This will allow you to reserve a number of kilobytes on the
  107.    destination disk.  Note that the unused space on the disk is usually
  108.    more than the reserved size you specified.  It is particular useful
  109.    if you want to add small programs, such as viewers, players, and
  110.    "readme" files, to each disk.
  111.  
  112. -s This will append a suffix name to each file that is copied.  For
  113.    example, "ECopy -s.bak myfile DF0:" will copy "myfile" from the
  114.    current directory into "DF0:myfile.bak".  This is particular useful
  115.    for backups.
  116.  
  117. Options can be placed anywhere on the command line.  <DestPath> must be 
  118. the last argument specified.  For example, "ECopy DF0: myfiles/*" will
  119. fail, but "ECopy myfiles/* DF0:" is okay.  During the copying, press ^C
  120. (control-C) to abort.  Any incomplete files will be deleted from the 
  121. destination disk.  Files of zero size are not copied.  After each disk
  122. is nearly full and further copying is not possible, a message will be
  123. displayed:
  124.  
  125. This disk has not enough space, please insert next disk.
  126.  
  127. "R" to resume, "C" to change destination path, "Q" to quit...
  128.  
  129. Now put in a new disk, and type "R" followed by a carriage return and
  130. the copying process resumes with the same <DestPath>.  Type "Q" to
  131. quit copying.  If you want to change the destination path, type "C" and
  132. a message will be displayed:
  133.  
  134. Please enter new path:
  135.  
  136. Now, type something like "DF1:" or "DF2:" if you want to copy to other
  137. drives.
  138.  
  139.  
  140. EFFICIENCY
  141. ----------
  142.  
  143. I have tested the program on picture files, and music files of various
  144. sizes and came up with only about an average of 1-2% of disk space
  145. wasted.  Your mileage may vary, depending on the file size distribution
  146. of all the files you are copying.  Of course, it's always possible to
  147. manually copy files with 0% space wasted, but the calculations required
  148. makes it impractical.  Before I wrote this utility, each disk I copied
  149. manually ended up with an average of about 5-10% disk space wasted.  If
  150. you collect pictures or sound files, you can save some disks and time!
  151.  
  152.  
  153. LAST WORDS
  154. ----------
  155.  
  156. I hope you find this utility useful.  Although, this utility is
  157. distributed as public domain, I do accept donations as I'm yet another
  158. poor college student.  Donations above $5 (CAN$/US$) will receive the
  159. source code for this program, if requested.  If you have any questions,
  160. ideas (for this program or new ones), comments, bug reports, etc.
  161. please mail them to the addresses below.  Thanks for using this program!
  162.  
  163. Home Address: Sam Yee
  164.               c/o Utilities
  165.               4595 Nanaimo St.
  166.               Vancouver, B.C.
  167.               Canada  V5N-5J5
  168.  
  169.     Internet: samy@sfu.ca
  170.  
  171.      FidoNet: 1:153/765 (Terra Firma BBS! 604-434-3665)
  172.  
  173.