]> Dogcows Code - chaz/tar/blobdiff - README
*** empty log message ***
[chaz/tar] / README
diff --git a/README b/README
index 3387258401b19561a03dd2461a876e663f477f69..ac4f0df40dec7ff40a4b86ff3679f773b7bdcdd0 100644 (file)
--- a/README
+++ b/README
@@ -1,5 +1,9 @@
-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
@@ -10,55 +14,7 @@ for doing incremental dumps has been significantly changed.
 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.
 
@@ -66,33 +22,65 @@ Various people have been having problems using floppies on a NeXT.
 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.
This page took 0.022355 seconds and 4 git commands to generate.