Initial revision

diff --git a/README b/README
index 35aa30e2f500896734ae2cdae9e310099299fc3b..3387258401b19561a03dd2461a876e663f477f69 100644 (file)
--- a/README
+++ b/README
@@ -1,6 +1,5 @@
-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.  
+This GNU tar 1.10.  Please send bug reports, etc., to
+bug-gnu-utils@prep.ai.mit.edu.  
 
 GNU tar is based heavily on John Gilmore's public domain tar, but with
 added features.  The manual is currently being written.  An old
@@ -11,7 +10,55 @@ 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.
 
-See the file INSTALL for compilation and installation instructions for Unix.
+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.
 
 makefile.pc is a makefile for Turbo C 2.0 on MS-DOS.
 
@@ -19,8 +66,33 @@ 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
 
-User-visible changes since 1.10:
+User-visible changes since 1.09:
+
+Filename to -G is optional.  -C works right.  
+Names +newer and +newer-mtime work right.
+
+-g is now +incremental
+-G is now +listed-incremental
+
+Sparse files now work correctly.
+
++volume is now called +label.
+
++exclude now takes a filename argument, and +exclude-from does what
++exclude used to do.
+
+Exit status is now correct.
+
++totals keeps track of total I/O and prints it when tar exits.
+
+When using +label with +extract, the label is now a regexp.
+
+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.
 
+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.