home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / sosutl11.zip / extract.man < prev    next >
Text File  |  1993-08-14  |  3KB  |  98 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). It also
  40.     makes it possible to put the archivers to a directory not con-
  41.     tained in PATH--just edit the line "arcdir=..." in extract.cmd
  42.     to point to your archiver directory.
  43.  
  44. Examples
  45.  
  46.     Suppose you have a file `foo.zoo', which includes the follow-
  47.     ing files (and subdirectories):
  48.  
  49.         src\foo.c       (*
  50.         src\foo.h
  51.         src\foo.mak
  52.         exe\foo.exe
  53.         man\foo.man
  54.         README
  55.         Copyright
  56.             -------
  57.             *) Note: Zoo, Zip, gzip, tar and Compress use slashes
  58.             instead of backslashes internally to separate directories,
  59.             but in the command line of Extract you should use back-
  60.             slashes--otherwise you'll get silly messages of unknown
  61.             switches...
  62.  
  63.     Extract all the files:
  64.  
  65.         [D:\] extract foo.zoo
  66.  
  67.     Extract all the files in `src' subdirectory (ie. `foo.c', `foo.h',
  68.     and `foo.mak'):
  69.  
  70.         [D:\] extract foo.zoo src\*
  71.  
  72.     The same as above, but do not create `src' subdirectory, ie.
  73.     extract files to the current directory:
  74.  
  75.         [D:\] extract foo.zoo src\* /j
  76.  
  77.     The same as above, but extract to `C:\tmp\thrash' directory:
  78.  
  79.         [D:\] extract foo.zoo src\* /j /t C:\tmp\thrash
  80.  
  81.     To list the contents of this archive, use:
  82.  
  83.         [D:\] extract foo.zoo /l
  84.  
  85.     To view the `README' file with `more', use:
  86.  
  87.         [D:\] extract foo.zoo README /p |more
  88.  
  89.     To redirect `README' to printer:
  90.  
  91.         [D:\] extract foo.zoo README /p >prn
  92.  
  93. Version and copyright
  94.  
  95.     Extract v1.0
  96.     Copyrigth (C) 1993, SuperOscar Softwares, Tommi Nieminen.
  97.  
  98.