bug-tar
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH] drop a mistaken comma and an obsolete item from the texi manual


From: Benno Schulenberg
Subject: [PATCH] drop a mistaken comma and an obsolete item from the texi manual
Date: Sat, 3 Feb 2024 12:41:11 +0100

The change in meaning of the --exclude option happenned more
than thirty years ago.  Mentioning it is no longer helpful.

Also, improve some wordings.
---
 doc/tar.texi | 26 ++++++++------------------
 1 file changed, 8 insertions(+), 18 deletions(-)

diff --git a/doc/tar.texi b/doc/tar.texi
index ddbf8cba..de414098 100644
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -8350,7 +8350,7 @@ pitfalls:
 @itemize @bullet
 @item
 The main operating mode of @command{tar} does not act on a file name
-explicitly listed on the command line, if one of its file name
+explicitly listed on the command line if one of its file name
 components is excluded.  In the example above, if
 you create an archive and exclude files that end with @samp{*.o}, but
 explicitly name the file @samp{dir.o/foo} after all the options have been
@@ -8392,16 +8392,6 @@ syntax, when using exclude options in @command{tar}.  If 
you try to use
 @code{regexp} syntax to describe files to be excluded, your command
 might fail.
 
-@item
-@FIXME{The change in semantics must have occurred before 1.11,
-so I doubt if it is worth mentioning at all. Anyway, should at
-least specify in which version the semantics changed.}
-In earlier versions of @command{tar}, what is now the
-@option{--exclude-from} option was called @option{--exclude} instead.
-Now, @option{--exclude} applies to patterns listed on the command
-line and @option{--exclude-from} applies to patterns listed in a
-file.
-
 @end itemize
 
 @node wildcards
@@ -8442,11 +8432,11 @@ the characters @samp{-} and @samp{]} must either come 
@emph{first} or
 @cindex Character class, excluding characters from
 If the first character of the class after the opening @samp{[}
 is @samp{!} or @samp{^}, then the meaning of the class is reversed.
-Rather than listing character to match, it lists those characters which
+Rather than listing characters to match, it lists those characters which
 are @emph{forbidden} as the next single character of the matched string.
 
 Other characters of the class stand for themselves.  The special
-construction @samp{[@var{a}-@var{e}]}, using an hyphen between two
+construction @samp{[@var{a}-@var{e}]}, using a hyphen between two
 letters, is meant to represent all characters between @var{a} and
 @var{e}, inclusive.
 
@@ -8527,9 +8517,9 @@ b.c
 Notice quoting of the pattern to prevent the shell from interpreting
 it.
 
-The effect of @option{--wildcards} option is canceled by
+The effect of the @option{--wildcards} option is canceled by
 @option{--no-wildcards}.  This can be used to pass part of
-the command line arguments verbatim and other part as globbing
+the command-line arguments verbatim and another part as globbing
 patterns.  For example, the following invocation:
 
 @smallexample
@@ -8570,21 +8560,21 @@ ignores case when excluding @samp{makefile}, but not 
when excluding
 If anchored, a pattern must match an initial subsequence
 of the name's components.  Otherwise, the pattern can match any
 subsequence.  Default is @option{--no-anchored} for exclusion members
-and @option{--anchored} inclusion members.
+and @option{--anchored} for inclusion members.
 
 @anchor{case-insensitive matches}
 @opindex ignore-case
 @opindex no-ignore-case
 @item --ignore-case
 @itemx --no-ignore-case
-When ignoring case, upper-case patterns match lower-case names and vice versa.
+When ignoring case, upper-case patterns match also lower-case names and vice 
versa.
 When not ignoring case (the default), matching is case-sensitive.
 
 @opindex wildcards-match-slash
 @opindex no-wildcards-match-slash
 @item --wildcards-match-slash
 @itemx --no-wildcards-match-slash
-When wildcards match slash (the default for exclusion members), a
+When wildcards match a slash (the default for exclusion members), a
 wildcard like @samp{*} in the pattern can match a @samp{/} in the
 name.  Otherwise, @samp{/} is matched only by @samp{/}.
 
-- 
2.42.1




reply via email to

[Prev in Thread] Current Thread [Next in Thread]