X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=README;h=6297ff162febb9c63d121e9182e1bbac8384e49e;hb=3bfdc3f8ce227a2affeef5d3180d71f675ad87df;hp=d35f9cee3298ef4cc2a4bc836ff81858eb5df77d;hpb=bf9a7d3d974cb28346b8c893eed077a2a2b194b7;p=chaz%2Ftar diff --git a/README b/README index d35f9ce..6297ff1 100644 --- a/README +++ b/README @@ -1,3 +1,26 @@ +README for GNU tar + + Copyright (C) 1990, 1991, 1992, 1994, 1997, 1998, 1999, 2000, + 2001, 2003 Free Software Foundation, Inc. + + This file is part of GNU tar. + + GNU tar is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2, or (at your option) + any later version. + + GNU tar is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with tar; see the file COPYING. If not, write to + the Free Software Foundation, Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. + + Please glance through *all* sections of this `README' file before starting configuration. Also make sure you read files `ABOUT-NLS' and `INSTALL' if you are not familiar with them already. @@ -16,7 +39,6 @@ program is in the GNU `cpio' distribution. GNU `tar' is derived from John Gilmore's public domain `tar'. See file `ABOUT-NLS' for how to customize this program to your language. -See file `BACKLOG' for a summary of pending mail and articles. See file `COPYING' for copying conditions. See file `INSTALL' for compilation and installation instructions. See file `PORTS' for various ports of GNU tar to non-Unix systems. @@ -30,6 +52,10 @@ Besides those configure options documented in files `INSTALL' and operating system supports large files. Typically, large files are those larger on 2 GB on a 32-bit host. +The default archive format is GNU, this can be overridden by +presetting DEFAULT_ARCHIVE_FORMAT while configuring. The allowed +values are GNU, V7, OLDGNU and POSIX. + The default archive device is now `stdin' on read and `stdout' on write. The installer can still override this by presetting `DEFAULT_ARCHIVE' in the environment before configuring (the behavior of `-[0-7]' or @@ -38,14 +64,13 @@ in the environment before configuring (the behavior of `-[0-7]' or For comprehensive modifications to GNU tar, you might need tools beyond those used in simple installations. Fully install GNU m4 1.4 first, -and only then, Autoconf 2.13 or later. Install Perl, then Automake -1.4 or later. You might need Bison 1.28 or later, and GNU tar itself. -All are available on GNU archive sites, like in -ftp://ftp.gnu.org/pub/gnu/. - -Send bug reports to `bug-tar@gnu.org'. (Beware, old-timers: it is -`@gnu', not `@prep'; and not `bug-gnu-utils' anymore.) A bug report is -an adequate description of the problem: your input, what you expected, +and only then, Autoconf 2.57 or later. Install Perl, then Automake +1.7.5 or later. Also, install gettext 0.12.1 or later. You might +need Bison 1.875 or later, and GNU tar itself. All are available on +GNU archive sites, like in ftp://ftp.gnu.org/pub/gnu/. + +Send bug reports to . A bug report should contain +an adequate description of the problem, your input, what you expected, what you got, and why this is wrong. Diffs are welcome, but they only describe a solution, from which the problem might be uneasy to infer. If needed, submit actual data files with your report. Small data files @@ -55,14 +80,46 @@ to the report address; rather take special arrangement with the maintainer. Your feedback will help us to make a better and more portable package. Consider documentation errors as bugs, and report them as such. If you develop anything pertaining to `tar' or have suggestions, let us know -and share your findings by writing at `tar-forum@iro.umontreal.ca'. +and share your findings by writing to . + -.--------------------. -| Installation hints | -`--------------------' +Installation hints +------------------ Here are a few hints which might help installing `tar' on some systems. +* gzip and bzip2. + +GNU tar uses the gzip and bzip2 programs to read and write compressed +archives. If you don't have these programs already, you need to +install them. Their sources can be found at: + +ftp://ftp.gnu.org/gnu/gzip/ +http://sourceware.cygnus.com/bzip2/ + +If you see the following symptoms: + + $ tar -xzf file.tar.gz + gzip: stdin: decompression OK, trailing garbage ignored + tar: Child returned status 2 + +then you have encountered a gzip incompatibility that should be fixed +in gzip test version 1.3, which as of this writing is available at +. You can work around the +incompatibility by using a shell command like + `gzip -d