home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / SHAR324X.ZIP / SHAR.DOC < prev    next >
Text File  |  1990-05-05  |  2KB  |  56 lines
  1. (Docu from shar2, not shar 3.21)
  2.  
  3.   SHAR2 is a program to create shell archives. I wrote it to solve the
  4. problems inherent in sharing large files, namely:
  5.  
  6.     breaking up large postings to avoid truncation
  7.         This is now done by the program
  8.     concatenating shar parts before unpacking when large files
  9.     won't fit into one mailable file
  10.         Each output file may be unpacked separately, and the
  11.         unpack is sequence checked
  12.     binary files
  13.         The shar program will optionally handle binary files, using
  14.         uuencode to process them. The results are able to be broken
  15.         into multiple files, as with text.
  16.     mixed text and binary files
  17.         The shar program can optionally handle a mixture of file
  18.         types, using the 'file' command to test them. The mixing of
  19.         text and binary files may also be done manually, for files
  20.         which are text files but which contain characters which may
  21.         be damaged when mailed.
  22.     losing file permissions
  23.         file permissions are preserved, allowing shell scripts to
  24.         retain execute permission and read only files to be
  25.         protected.
  26.  
  27.  
  28. These are the features of shar2 over the many shar versions around:
  29.  
  30.      1.  It optionally produces multiple output files for mailing.
  31.      2.  Multiple output files do not have to be concatenated before
  32.          unpacking. Each may be unpacked independently, input files
  33.          spanning several output files are joined correctly.
  34.      3.  Unpacking of multiple-file archives is sequence checked.
  35.      4.  binary files may be processed, using uuencode and uudecode.
  36.          this allows large binary files to be easily moved by mail.
  37.      5.  file permissions are preserved.
  38.      6.  error checking is available as an option.
  39.      7.  Fast - written in C.
  40.      8.  Rejects pipes and directories.
  41.      9.  Can handle mixed text and binary files, using automatic
  42.          or manual file typing.
  43.  
  44.   I wrote this because the version in shell script was too slow, I got a
  45. source for a minimal version which could be enhanced, and to avoid
  46. having to join parts of binary postings before unpacking.  I hope
  47. it will be useful.
  48.  
  49.                 bill davidsen, 4/6/88 (davidsen@sixhub.uucp)
  50.  
  51.   Latest revision, change checking to use wc instead of sum, since not
  52. all versions of sum are compatible.  Thanks to Keith Petersen.  Added
  53. the ability to make the temp filenames DOS compatible to allow use of
  54. 'unshar' on DOS.
  55.  
  56.