Dogcows Code - chaz/tar/blob - README

   1 Hey!  Emacs!  Yo!  This is -*- Text -*- !!!
   2
   3 This GNU tar 1.11.  Please send bug reports, etc., to
   4 bug-gnu-utils@prep.ai.mit.edu.  This is a beta-test release.  Please
   5 try it out.  After bug reports are processed for this release, version
   6 1.12 will be released.
   7
   8 GNU tar is based heavily on John Gilmore's public domain tar, but with
   9 added features.  The manual is currently being written.  An old
  10 manual, surely riddled with errors, is in tar.texinfo.  Please don't
  11 send in bug reports about that manual.  In particular, the mechanism
  12 for doing incremental dumps has been significantly changed.
  13
  14 This distribution also includes rmt, the remote tape server (which
  15 must reside in /etc).  The mt program is in the GNU cpio distribution.
  16
  17 See the file INSTALL for compilation and installation instructions for Unix.
  18
  19 makefile.pc is a makefile for Turbo C 2.0 on MS-DOS.
  20
  21 Various people have been having problems using floppies on a NeXT.
  22 I've gotten conflicting reports about what should be done to solve the
  23 problems, and we have no way to test it ourselves.
  24
  25 If you want to do incremental dumps, use the distributed backup
  26 scripts.  They are what we use at the FSF to do all our backups.  Most
  27 importantly, do not use +incremental (-G) or +after-date (-N) or
  28 +newer-mtime to do incremental dumps.  The only option that works
  29 correctly for this purpose is +listed-incremental.  (When extracting
  30 incremental dumps, use +incremental (-G).)
  31
  32 There is no tar manual in this release.  The old manual has too many
  33 problems to make it usable.  A new manual will appear in version 1.12.
  34
  35 User-visible changes since 1.10:
  36
  37 o Many bug fixes
  38
  39 o Now uses GNU standard configure, generated by Autoconf.
  40
  41 o Long options now use `--'; use of `+' is deprecated and support for it
  42   will eventually be removed.
  43
  44 o New option --null causes filenames read by -T to be null-terminated,
  45   and causes -C to be ignored.
  46
  47 o New option --remove-files deletes files (but not directories) after
  48   they are added to the archive.
  49
  50 o New option --ignore-failed-read prevents read-errors from affecting
  51   the exit status.
  52
  53 o New option --checkpoint prints occasional messages as the tape is
  54   being read or written.
  55
  56 o New option --show-omitted-dirs prints the names of directories
  57   omitted from the archive.
  58
  59 o Some tape drives which use a non-standard method of indicating
  60   end-of-tape now work correctly with multi-tape archives.
  61
  62 o --volno-file: Read the volume number used in prompting the user (but
  63   not in recording volume ID's on the archive) from a file.
  64
  65 o When using --multi-volume, you can now give multiple -f arguments;
  66   the various tape drives will get used in sequence and then wrap
  67   around to the beginning.
  68
  69 o Remote archive names no longer have to be in /dev: any file with a
  70   `:' is interpreted as remote.  If new option --force-local is given,
  71   then even archive files with a `:' are considered local.
  72
  73 o New option --atime-preserve restores (if possible) atimes to their
  74   original values after dumping the file.
  75
  76 o No longer does tar confusingly dump "." when you don't tell it what
  77   to dump.
  78
  79 o When extracting directories, tar now correctly restores their
  80   modification and access times.
  81
  82 o Longnames support is redone differently--long name info directly
  83   precedes the long-named file or link in the archive, so you no
  84   longer have to wait for the extract to hit the end of the tape for
  85   long names to work.
  86