home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / sosutl12.zip / doc / extract.man < prev    next >
Text File  |  1993-10-17  |  3KB  |  106 lines
  1. Extract
  2.  
  3. Description
  4.  
  5.     Extract--extract files from archives or list archive contents.
  6.     A REXX script.
  7.  
  8. Usage
  9.  
  10.     [D:\] extract ARCHIVE [ FILE ... ] [ /jlp? /t DIR ]
  11.  
  12.     Options:
  13.  
  14.     /j      Junk directories (ie. don't extract them). With this
  15.             switch, files are extracted to the current directory, or
  16.             the directory given with /t switch. Can't be used together
  17.             with /l or /p.
  18.  
  19.     /l      Show archive contents. Output goes to stdout. Can't be
  20.             used together with /l, /p, or /t.
  21.  
  22.     /p      Extract to stdout. Useful in viewing document files stored
  23.             in the archive.
  24.  
  25.     /t DIR
  26.             Set directory in which files are extracted. Without the /j
  27.             switches, any subdirectories contained in the archive file
  28.             will be created under DIR. The space between the switch
  29.             and the directory name isn't necessary.
  30.  
  31.     /?      Display help page and quit.
  32.  
  33.  
  34.     NOTE: Extract only chooses the appropriate archiver and forms the
  35.     command line which is passed to it; you will still need all the
  36.     archivers whose archive files you encounter. However, Extract
  37.     makes working with the archivers much more comfortable since you
  38.     don't need to remember every switch of every program (or indeed,
  39.     remember the actual executable names of the archives).
  40.  
  41. Note
  42.  
  43.     If you do not want to keep your archiver executables in PATH, you
  44.     can modify the line
  45.  
  46.         arcdir = ""
  47.  
  48.     in `extract.cmd' to point to the directory where you keep them.
  49.     The value MUST have a trailing backslash (eg. "C:\Bin\Arc\"). If
  50.     the string is empty, a normal PATH search is done.
  51.  
  52. Examples
  53.  
  54.     Suppose you have a file `foo.zoo', which includes the following
  55.     files (and subdirectories):
  56.  
  57.         src\foo.c
  58.         src\foo.h
  59.         src\foo.mak
  60.         exe\foo.exe
  61.         man\foo.man
  62.         README
  63.         Copyright
  64.  
  65.     Note: Zoo, Zip, gzip, tar and Compress use slashes instead of
  66.     backslashes internally to separate directories, but in the command
  67.     line of Extract you should use backslashes--otherwise you'll get
  68.     silly messages of unknown switches...
  69.  
  70.     To extract all the files:
  71.  
  72.         [D:\] extract foo.zoo
  73.  
  74.     Extract all the files in `src' subdirectory (ie. `foo.c', `foo.h',
  75.     and `foo.mak'); this also makes the subdirectory `src', it it
  76.     didn't exist already:
  77.  
  78.         [D:\] extract foo.zoo src\*
  79.  
  80.     The same as above, but doesn't create `src' subdirectory, ie.
  81.     files are extracted to the current directory:
  82.  
  83.         [D:\] extract foo.zoo src\* /j
  84.  
  85.     The same as above, but files are extracted to `C:\tmp\thrash'
  86.     directory:
  87.  
  88.         [D:\] extract foo.zoo src\* /j /t C:\tmp\thrash
  89.  
  90.     To list the contents of this archive, use:
  91.  
  92.         [D:\] extract foo.zoo /l
  93.  
  94.     To view the `README' file with `more', use:
  95.  
  96.         [D:\] extract foo.zoo README /p |more
  97.  
  98.     To redirect `README' to printer:
  99.  
  100.         [D:\] extract foo.zoo README /p >prn
  101.  
  102. Version and copyright
  103.  
  104.     Extract v1.1
  105.     Copyrigth (C) 1993, SuperOscar Softwares, Tommi Nieminen.
  106.