X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=README;h=ac4f0df40dec7ff40a4b86ff3679f773b7bdcdd0;hb=c904c6ac55aa05b8b06ef4e2de3927a0907c9f86;hp=437321f19cd30cd1b4b3410ace0e8757c7e82070;hpb=2a29aa0b1d7cc41073bb22c2fa9e8135d76a0aec;p=chaz%2Ftar diff --git a/README b/README index 437321f..ac4f0df 100644 --- 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 RENAME_MISSING 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 mostlyclean'. Type `make -clean' 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.