home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 142.lha / MakeARC.doc < prev    next >
Text File  |  1986-11-20  |  4KB  |  60 lines
  1.  
  2.                                  MakeARC
  3.                       Copyright ) 1988 by Bryan Ford
  4.                               Documentation
  5.  
  6.     MakeARC is a program I wrote to fix the two main drawbacks of ARC:  No
  7. subdirectories, and short filenames only.  What it does is searches through
  8. an entire disk and directory, renames all the files to names like XFile.1,
  9. XFile.2, etc., takes them out of any subdirectories they might be in,
  10. deletes the subdirectories, and at the same time, creates a file called
  11. EXECUTE.ME containing all the information necessary to restore the
  12. directory to its original form.
  13.     To use it, simply type "MakeARC <directory>" where <directory> is the
  14. name of a directory or volume to use.  When it completes, you will have one
  15. "EXECUTE.ME" file and a bunch of "XFile.####" files.  The person receiving
  16. the archive can then just unARC the file into a subdirectory and type
  17. "EXECUTE EXECUTE.ME" to rebuild the original file structure.  Also, a
  18. READ.ME file is written which tells how to rebuild the structure.
  19.     There are two things to be aware of.  First, if you have a file called
  20. EXECUTE.ME in the directory you passed to MakeARC, it will get overwritten.
  21. Files with this name in subdirectories will stay intact.  Second, files
  22. beginning with "XFile." will not be seen, because MakeARC has to skip over
  23. files it has already generated, and it thinks that all files with this
  24. beginning are files it generated.
  25.     MakeARC does no file copying - it simply renames the files.  This means
  26. that file comments, time, and other attributes will be saved.  If, for some
  27. reason, it can't rename a file, it will display "Warning: Can't rename
  28. <file>."  if the file is in a subdirectory, you will also get a warning
  29. stating that it can't delete the subdirectory, because it's not empty.  The
  30. file will simply be ignored by MakeARC.
  31.     MakeARC requires very little room on the disk to operate.  The only
  32. extra space needed is space for the EXECUTE.ME and READ.ME files.  This
  33. will usually be only a few blocks, so unless your disk is 99% full, MakeARC
  34. will probably succeed.
  35.     For EXECUTE.ME files to execute correctly, there are several files that
  36. must be in the c: directory: MakeDir, Rename, Run, Delete, and Echo.  If
  37. Echo is not present you will simply get a "unknown command echo" instead of
  38. the usual messages "Extracting..." and "Done."  The other commands are
  39. required for it to operate correctly.  Of course, Execute must be in the c:
  40. directory to execute EXECUTE.ME.
  41.     One switch is allowed, -n, which must be in lowercase, and must come
  42. after the pathname. If you include it, no READ.ME file will be generated,
  43. and no instruction for deleting it will be put into the EXECUTE.ME file.
  44. This will also happen if there is not enough room on the disk for the
  45. READ.ME file (which will be rare, as it only takes 2 blocks). This file
  46. simply tells how to rebuild the file structure.
  47.     This program can handle a maximum of 9999 files.  I haven't tested it
  48. with more than this - if you find this a serious limit please contact me.
  49.     This program is being distributed as Shareware.  If you use it and like
  50. it, a small contribution would be deeply appreciated.  In any case, you are
  51. encouraged to copy and share this program, as long as you supply the
  52. program and its documentation in its original form.  I can be reached for
  53. comments, inquiries, or donations at the following address:
  54.  
  55.                                 Bryan Ford
  56.                         Snail:  1790 East 1400 North
  57.                                 Logan, UT 84321
  58.                         Email:  FATQW@USU.BITNET
  59.  
  60.