tar: fix bug with -C and extracting directories

[chaz/tar] / README

diff --git a/README b/README
index 5ee115d76691ab1c1d58fec5e20a7f1462a5f227..bf65e82ad7ce0180810701d326928e385013fea2 100644 (file)
--- a/README
+++ b/README
@@ -46,9 +46,39 @@ in the environment before configuring (the behavior of `-[0-7]' or
 `-[0-7]lmh' options in `tar' are then derived automatically).  Similarly,
 `DEFAULT_BLOCKING' can be preset to something else than 20.
 
 `-[0-7]lmh' options in `tar' are then derived automatically).  Similarly,
 `DEFAULT_BLOCKING' can be preset to something else than 20.
 

+** Selecting full pathname of the "rmt" binary.
+
+Previous versions of tar always looked for "rmt" binary in the
+directory "/etc/rmt". However, the "rmt" program included
+in the distribution was installed under "$prefix/libexec/rmt".
+To fix this discrepancy, tar now looks for "$prefix/libexec/rmt".
+If you do not want this behavior, specify full path name of
+"rmt" binary using DEFAULT_RMT_DIR variable, e.g.:
+
+./configure DEFAULT_RMT_DIR=/etc
+
+If you already have a copy of "rmt" installed and wish to use it
+instead of the version supplied with the distribution, use --with-rmt
+option:
+
+./configure --with-rmt=/etc/rmt
+
+This will also disable building the included version of rmt.
+
+** Installing backup scripts.
+
+This version of tar is shipped with the shell scripts for producing
+incremental backups (dumps) and restoring filesystems from them.
+The name of the backup script is "backup". The name of the
+restore script is "restore". They are installed in "$prefix/sbin"
+directory.
+
+Use option --enable-backup-scripts to compile and install these
+scripts.
+

 ** `--disable-largefile' omits support for large files, even if the
 operating system supports large files.  Typically, large files are
 ** `--disable-largefile' omits support for large files, even if the
 operating system supports large files.  Typically, large files are

-those larger on 2 GB on a 32-bit host.
+those larger than 2 GB on a 32-bit host.

 
 * Installation hints
 
 
 * Installation hints
 


@@ -150,28 +180,29 @@ the `lchown' call will be used if available, but that's all.
 GNU `tar' is able to create archive in the following formats:
 
   *** The format of UNIX version 7
 GNU `tar' is able to create archive in the following formats:
 
   *** The format of UNIX version 7

-  *** POSIX.1-1988 format, also known as "ustar format" 
+  *** POSIX.1-1988 format, also known as "ustar format"

   *** POSIX.1-2001 format, also known as "pax format"
   *** Old GNU format (described below)
 
 In addition to those, GNU `tar' is also able to read archives
   *** POSIX.1-2001 format, also known as "pax format"
   *** Old GNU format (described below)
 
 In addition to those, GNU `tar' is also able to read archives

-produced by `star' archiver.  
+produced by `star' archiver.

 
 A so called `Old GNU' format is based on an early draft of the
 POSIX 1003.1 `ustar' standard which is different from the final
 standard. It defines its extensions (such as incremental backups
 and handling of the long file names) in a way incompatible with
 any existing tar archive format, therefore the use of old GNU
 
 A so called `Old GNU' format is based on an early draft of the
 POSIX 1003.1 `ustar' standard which is different from the final
 standard. It defines its extensions (such as incremental backups
 and handling of the long file names) in a way incompatible with
 any existing tar archive format, therefore the use of old GNU

-format is strongly discouraged. 
+format is strongly discouraged.

 
 Please read the file NEWS for more information about POSIX compliance
 and new `tar' features.
 
 * What's next?
 
 
 Please read the file NEWS for more information about POSIX compliance
 and new `tar' features.
 
 * What's next?
 

-In the future we will try to release tar-1.14 as soon as possible and
-start merging with paxutils afterwards.  We'll also try to rewrite
-some parts of the documentation after paxutils has been merged.
+GNU tar will be merged into GNU paxutils: a project containing
+several utilities related to creating and handling archives in
+various formats. The project will include tar, cpio and pax
+utilities.

 
 * Bug reporting.
 
 
 * Bug reporting.
 


@@ -192,13 +223,13 @@ and share your findings by writing to <bug-tar@gnu.org>.
 * Copying
 
        Copyright (C) 1990, 1991, 1992, 1994, 1997, 1998, 1999, 2000,
 * Copying
 
        Copyright (C) 1990, 1991, 1992, 1994, 1997, 1998, 1999, 2000,

-       2001, 2003, 2004 Free Software Foundation, Inc.
+       2001, 2003, 2004, 2007 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
 
        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)
+       the Free Software Foundation; either version 3, or (at your option)

        any later version.
 
        GNU tar is distributed in the hope that it will be useful,
        any later version.
 
        GNU tar is distributed in the hope that it will be useful,


@@ -208,8 +239,8 @@ and share your findings by writing to <bug-tar@gnu.org>.
 
        You should have received a copy of the GNU General Public License
        along with tar; see the file COPYING.  If not, write to
 
        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.
+       the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+       Boston, MA 02110-1301, USA.

 
 \f
 Local Variables:
 
 \f
 Local Variables:


@@ -217,4 +248,3 @@ mode: outline
 paragraph-separate: "[ \f]*$"
 version-control: never
 End:
 paragraph-separate: "[ \f]*$"
 version-control: never
 End:

-