home *** CD-ROM | disk | FTP | other *** search
/ ANews 1 / AnewsCD01.iso / Indispensables / Compression / xad / Docs / xadUnFile.doc < prev   
Encoding:
Text File  |  1999-08-09  |  4.0 KB  |  122 lines
  1. NAME
  2.     xadUnFile 1.7
  3.     xadUnFileM 1.7
  4.  
  5. SYNOPSIS
  6.     xadUnFile FROM/A,DEST=DESTDIR,PASSWORD/K,FILE/M,NE=NOEXTERN/S,
  7.     INFO=LIST/S,OW=OVERWRITE/S,NOTREE/S,ASKMAKEDIR/S,
  8.     NOCOMMENT/S,NOPROT/S,NODATE/S,NOABS/S,SHOWPROT/S,QUIET/S
  9.  
  10.     xadUnFileM FROM/A/M,DEST=DESTDIR/K,PASSWORD/K,FILE/K,NE=NOEXTERN/S,
  11.     INFO=LIST/S,OW=OVERWRITE/S,NOTREE/S,ASKMAKEDIR/S,
  12.     NOCOMMENT/S,NOPROT/S,NODATE/S,NOABS/S,SHOWPROT/S,QUIET/S
  13.  
  14. DESCRIPTION
  15.     xadUnFile is the master shell tool to extract data from
  16.     file archives.
  17.  
  18.     FROM specifies the file archive that should be handled.
  19.     The xadUnFileM tool can handle splitted archives, when they are
  20.     given in their correct order. Do not give multiple names of
  21.     single archives!
  22.  
  23.     DESTDIR is the destination directory. The directory is created
  24.     when it does not exist (except if ASKMAKEDIR is turned on and
  25.     you select no). There are some dangerous archives using absolute
  26.     path names (e.g. starting with LIBS: or RAM:). xadUnFile archives
  27.     these files to their absolute position (except NOTREE or NOABS is
  28.     used). For xadUnFileM this argument requires the keyword DEST or
  29.     DESTDIR.
  30.  
  31.     PASSWORD can be used to supply a password for unarchiving of
  32.     encrypted archives. This argument requires the keyword PASSWORD.
  33.  
  34.     FILE allows you to select filename(s) (including patterns), which
  35.     should be extracted. When FILE is not given, all files are
  36.     extracted. With FILE only matching files are extracted.
  37.     NOTE: When you do not use NOTREE keyword, the patterns check
  38.     includes checks for directory structure as well.
  39.     For xadUnFileM there are some special rules:
  40.       To pass multiple names, use patterns like (xxx|yyy|zzz), where
  41.       xxx, yyy and zzz are three file names. You cannot pass multiple
  42.       strings like for xadUnFile. And additionally this argument
  43.       requires the keyword FILE.
  44.  
  45.     NOEXTERN prohibits the use of external clients for
  46.     recognition purposes.
  47.     
  48.     INFO or LIST prints information about the archive and does not
  49.     do any unarchiving. SHOWPROT turns on display of protection
  50.     information.
  51.     
  52.     OVERWRITE forces the program to overwrite an already existing
  53.     destination file. Normally you are asked about that.
  54.     
  55.     NOTREE skips all directory names and writes the files directly to
  56.     destination directory.
  57.     
  58.     ASKMAKEDIR forces the program to ask you, if a missing directory
  59.     should be created.
  60.     
  61.     NOCOMMENT prevents setting archived file comments, NOPROT prevents
  62.     setting file protection bits and NODATE prevents setting date
  63.     information. NOCOMMENT also prevents displaying comment lines with
  64.     INFO or LIST keyword.
  65.     
  66.     NOABS prevents creation of absolute path names.
  67.  
  68.     The QUIET option turns off the progress report, but also disables
  69.     questions to skip, rename or overwrite files.
  70.  
  71. EXAMPLES
  72.     Shell> xadUnFile archive.tar RAM:
  73.         Unarchive the tar archive to RAM:
  74.  
  75.     Shell> xadUnFile archive.lha RAM: #?.txt #?.doc Contents
  76.         Unarchive all .txt and .doc file and the file "Contents" of
  77.         lha archive to RAM:
  78.  
  79.     Shell> xadUnFile archive.lha DEST RAM: FILE (#?.txt|#?.doc|Contents)
  80.         The same call for xadUnFileM
  81.  
  82.     Shell> xadUnFile archive.lha LIST
  83.         Tells information about archive.lha file.
  84.  
  85. HISTORY
  86.     xadUnFile 1.7, xadUnFileM 1.7
  87.     - new options SHOWPROT and QUIET
  88.     - normal xadUnFile got back style of 1.4 and the multifile archive
  89.       style has been implemented in the special xadUnFileM tool.
  90.       Splitted archives are very seldom and it is of no use to make the
  91.       shell arguments that complicated for single file archives.
  92.  
  93.     xadUnFile 1.6
  94.     - added multiple input file support and renaming
  95.  
  96.     xadUnFile 1.4
  97.     - no longer aborts when unarchiving failed for one entry
  98.     - added NOABS option and comment display with INFO
  99.  
  100.     xadUnFile 1.3
  101.     - added size output for "group archivers" like LzX
  102.  
  103.     xadUnFile 1.2
  104.     - added output for corrupted files
  105.  
  106.     xadUnFile 1.1
  107.     - added FILE parameter and directory creation
  108.  
  109.     xadUnFile 1.0
  110.     - First public release.
  111.  
  112. COPYRIGHT
  113.     xadUnFile is freely distributable for noncommercial use.
  114.  
  115. AUTHOR
  116.     Dirk Stöcker
  117.     Geschwister-Scholl-Straße 10
  118.     01877 Bischofswerda
  119.     GERMANY
  120.     
  121.     Dirk Stoecker <stoecker@amigaworld.com>
  122.