home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff287.lzh / UnShar / unshar.doc < prev    next >
Text File  |  1989-12-06  |  3KB  |  67 lines
  1.  
  2.      UNSHAR(1)             AMIGA Programmer's Manual              UNSHAR(1)
  3.  
  4.  
  5.  
  6.      ›1mNAME 
  7.           ›0munshar - extracts files from shar archives 
  8.  
  9.      ›1mSYNOPSIS 
  10.           ›0munshar {-overwrite} file1 file2 ...  
  11.  
  12.      ›1mDESCRIPTION 
  13.           ›0mUnshar is a utility which extracts files from the ubiquitous
  14.           Unix shar  archives.    It has the following advantages over
  15.           existing unshar utilities: 
  16.  
  17.                - Small and fast 
  18.                - Handles many cat and sed formats 
  19.                - Allows extraction of subdirectories 
  20.                - Understands ./file type filenames 
  21.                - Exits cleanly with CTRL-C 
  22.  
  23.           The total code size is slightly under 3.5K, for  those  with
  24.           packed C  directories.  It treats quotes and imbedded escape
  25.           sequences intelligently and handles  all  the  cat  and  sed
  26.           formats  I've  ever seen, including sed commands which strip
  27.           off more than one letter.  There  may  be  some  formats  it
  28.           won't handle, but I've yet to find them.  
  29.  
  30.           Invoke  unshar  with  as many archive filenames as you like.
  31.           All the files in each archive will  be  extracted  into  the
  32.           current directory.    If  a file already exists, unshar asks
  33.           you how you want to handle it.  Entering `Y' will  overwrite
  34.           the  existing file with the version in the archive, `N' will
  35.           skip past the file  without  extracting  it,  and  `A'  will
  36.           overwrite  this  file  and  any other existing files without
  37.           prompting you again.  Including the -o flag on  the  command
  38.           line causes files to always be overwritten.  
  39.  
  40.      ›1mOPERATION 
  41.           ›0mUnshar  scans  through each archive specified on the command
  42.           line, looking for lines beginning with `cat' or  `sed'.  All
  43.           other lines  are  ignored.   In particular, `echo' lines are
  44.           not echoed.  This way, you don't  get  a  load  of  messages
  45.           which  are  in  any  case  fairly  meaningless,  because the
  46.           operations they are describing are unsupported.  
  47.  
  48.           When a shar  archive  contains  a  file  for  which  a  full
  49.           pathname  is  given (as in source/file.c for example) unshar
  50.           will create whatever directories are  necessary.    It  also
  51.           strips   off   leading  /'s  and  ./'s,  to  make  filenames
  52.           understandable by AmigaDOS.  
  53.  
  54.      ›1mHISTORY 
  55.           ›0mV1.0  First release.  
  56.           V1.1  Added support for some more unusual uses of sed.  
  57.                 Increased speed, and reduced size slightly.  
  58.                 Fixed bug that truncated lines longer than 80 chars.  
  59.  
  60.      ›1mAUTHOR 
  61.           ›0mEddy Carroll 
  62.           EMAIL: ecarroll@vax1.tcd.ie 
  63.  
  64.  
  65.      Copyright Eddy Carroll 1989      -1-
  66.  
  67.