-This GNU tar 1.10. Please send bug reports, etc., to
-bug-gnu-utils@prep.ai.mit.edu.
+Hey! Emacs! Yo! This is -*- Text -*- !!!
+
+This GNU tar 1.11. Please send bug reports, etc., to
+bug-gnu-utils@prep.ai.mit.edu. This is a beta-test release. Please
+try it out. After bug reports are processed for this release, version
+1.12 will be released.
GNU tar is based heavily on John Gilmore's public domain tar, but with
added features. The manual is currently being written. An old
This distribution also includes rmt, the remote tape server (which
must reside in /etc). The mt program is in the GNU cpio distribution.
-To compile tar (and rmt, if your system has the needed features) on
-Unix-like systems:
-
-1. Type `./configure'. This shell script attempts to guess correct
-values for various system-dependent variables used during compilation,
-and creates the file `Makefile'. This takes a couple of minutes.
-
-If you want to compile in a different directory from the one
-containing the source code, `cd' to that directory and run `configure'
-with the option `+srcdir=DIR', where DIR is the directory that
-contains the source code. The object files and executables will be
-put in the current directory. This option only works with versions of
-`make' that support the VPATH variable. `configure' ignores any other
-arguments you give it.
-
-If your system requires unusual options for compilation or linking
-that `configure' doesn't know about, you can give `configure' initial
-values for variables by setting them in the environment; in
-Bourne-compatible shells, you can do that on the command line like
-this:
-$ CC='gcc -traditional' LIBS=-lposix ./configure
-
-2. If you want to change the directories where the programs will be
-installed, or the optimization options, edit `Makefile' and change
-those values. If you have an unusual system that needs special
-compilation options that `configure' doesn't know about, and you
-didn't pass them in the environment when running `configure', you
-should add them to `Makefile' now. Alternately, teach `configure' how
-to figure out that it is being run on a system where they are needed,
-and mail the diffs to the address listed at the top of this file so we
-can include them in the next release.
-
-3. Type `make'.
-
-4. If your system needs to link with -lPW to get alloca, but has
-rename in the C library (so WANT_RENAME is not used), -lPW might give
-you an incorrect version of rename. On HP-UX this manifests itself as
-an undefined data symbol called "Error" when linking tar. If this
-happens, use `ar x' to extract alloca.o from libPW.a and `ar rc' to
-put it in a library liballoca.a, and put that in LIBS instead of -lPW.
-This problem does not occur when using gcc, which has alloca built in.
-
-5. If the programs compile successfully, type `make install' to
-install them.
-
-6. After you have installed the programs, you can remove the binaries
-from the source directory by typing `make clean'. Type `make
-distclean' if you also want to remove `Makefile', for instance if you
-are going to recompile tar next on another type of machine.
+See the file INSTALL for compilation and installation instructions for Unix.
makefile.pc is a makefile for Turbo C 2.0 on MS-DOS.
I've gotten conflicting reports about what should be done to solve the
problems, and we have no way to test it ourselves.
+If you want to do incremental dumps, use the distributed backup
+scripts. They are what we use at the FSF to do all our backups. Most
+importantly, do not use +incremental (-G) or +after-date (-N) or
++newer-mtime to do incremental dumps. The only option that works
+correctly for this purpose is +listed-incremental. (When extracting
+incremental dumps, use +incremental (-G).)
+
+There is no tar manual in this release. The old manual has too many
+problems to make it usable. A new manual will appear in version 1.12.
+
+User-visible changes since 1.10:
+
+o Many bug fixes
+
+o Now uses GNU standard configure, generated by Autoconf.
+
+o Long options now use `--'; use of `+' is deprecated and support for it
+ will eventually be removed.
+
+o New option --null causes filenames read by -T to be null-terminated,
+ and causes -C to be ignored.
+
+o New option --remove-files deletes files (but not directories) after
+ they are added to the archive.
+
+o New option --ignore-failed-read prevents read-errors from affecting
+ the exit status.
-User-visible changes since 1.09:
+o New option --checkpoint prints occasional messages as the tape is
+ being read or written.
-Filename to -G is optional. -C works right.
-Names +newer and +newer-mtime work right.
+o New option --show-omitted-dirs prints the names of directories
+ omitted from the archive.
--g is now +incremental
--G is now +listed-incremental
+o Some tape drives which use a non-standard method of indicating
+ end-of-tape now work correctly with multi-tape archives.
-Sparse files now work correctly.
+o --volno-file: Read the volume number used in prompting the user (but
+ not in recording volume ID's on the archive) from a file.
-+volume is now called +label.
+o When using --multi-volume, you can now give multiple -f arguments;
+ the various tape drives will get used in sequence and then wrap
+ around to the beginning.
-+exclude now takes a filename argument, and +exclude-from does what
-+exclude used to do.
+o Remote archive names no longer have to be in /dev: any file with a
+ `:' is interpreted as remote. If new option --force-local is given,
+ then even archive files with a `:' are considered local.
-Exit status is now correct.
+o New option --atime-preserve restores (if possible) atimes to their
+ original values after dumping the file.
-+totals keeps track of total I/O and prints it when tar exits.
+o No longer does tar confusingly dump "." when you don't tell it what
+ to dump.
-When using +label with +extract, the label is now a regexp.
+o When extracting directories, tar now correctly restores their
+ modification and access times.
-New option +tape-length (-L) does multi-volume handling like BSD dump:
-you tell tar how big the tape is and it will prompt at that point
-instead of waiting for a write error.
+o Longnames support is redone differently--long name info directly
+ precedes the long-named file or link in the archive, so you no
+ longer have to wait for the extract to hit the end of the tape for
+ long names to work.
-New backup scripts level-0 and level-1 which might be useful to
-people. They use a file "backup-specs" for information, and shouldn't
-need local modification. These are what we use to do all our backups
-at the FSF.