--no-recursion applies to extraction, too.

diff --git a/doc/tar.texi b/doc/tar.texi
index 8f142655c9e6560298efe6b11c2a84f479916baa..9103505c2e36cfc3eb035dd394c466cd208b3a21 100644 (file)
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -2723,8 +2723,8 @@ also back up files for which any status information has changed).
 
 @item --no-recursion
 
 
 @item --no-recursion
 

-With this option, @command{tar} will not recurse into directories unless a
-directory is explicitly named as an argument to @command{tar}.  @FIXME-xref{}
+With this option, @command{tar} will not recurse into directories.
+@FIXME-xref{}

 
 @item --no-same-owner
 
 
 @item --no-same-owner
 


@@ -5468,7 +5468,7 @@ might fail.
 @item
 In earlier versions of @command{tar}, what is now the
 @samp{--exclude-from=@var{file-of-patterns}} option was called
 @item
 In earlier versions of @command{tar}, what is now the
 @samp{--exclude-from=@var{file-of-patterns}} option was called

-@samp{--exclude-@var{pattern}} instead.  Now,
+@samp{--exclude=@var{pattern}} instead.  Now,

 @samp{--exclude=@var{pattern}} applies to patterns listed on the command
 line and @samp{--exclude-from=@var{file-of-patterns}} applies to
 patterns listed in a file.
 @samp{--exclude=@var{pattern}} applies to patterns listed on the command
 line and @samp{--exclude-from=@var{file-of-patterns}} applies to
 patterns listed in a file.


@@ -5655,7 +5655,7 @@ themselves, but does not descend on them recursively.  Many people use
 @command{tar} @emph{usually} recursively descends on directories, they have
 to use the @samp{@w{! -d}} option to @command{find} @FIXME{needs more
 explanation or a cite to another info file}as they usually do not want
 @command{tar} @emph{usually} recursively descends on directories, they have
 to use the @samp{@w{! -d}} option to @command{find} @FIXME{needs more
 explanation or a cite to another info file}as they usually do not want

-all the files in a directory.  They then use the @value{op-file-from}
+all the files in a directory.  They then use the @value{op-files-from}

 option to archive the files located via @command{find}.
 
 The problem when restoring files archived in this manner is that the
 option to archive the files located via @command{find}.
 
 The problem when restoring files archived in this manner is that the


@@ -5665,6 +5665,10 @@ might really like it to.  Specifying @value{op-no-recursion} is a way to
 tell @command{tar} to grab only the directory entries given to it, adding
 no new files on its own.
 
 tell @command{tar} to grab only the directory entries given to it, adding
 no new files on its own.
 

+The @value{op-no-recursion} option also applies when extracting: it
+causes @command{tar} to extract only the matched directory entries, not
+the files under those directories.
+

 @FIXME{example here}
 
 @node one
 @FIXME{example here}
 
 @node one