Fix exclude/include typo, mention the default includes, fix some residual references to regexps, and minor copyediting. --- doc/tar.1 | 7 ++++--- doc/tar.texi | 11 ++++++----- 2 files changed, 10 insertions(+), 8 deletions(-)
diff --git a/doc/tar.1 b/doc/tar.1 index 6629bc49..d0d668cc 100644 --- a/doc/tar.1 +++ b/doc/tar.1 @@ -12,7 +12,7 @@ .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see <http://www.gnu.org/licenses/>. -.TH TAR 1 "November 13, 2025" "TAR" "GNU TAR Manual" +.TH TAR 1 "June 9, 2026" "TAR" "GNU TAR Manual" .SH NAME tar \- an archiving utility .SH SYNOPSIS @@ -602,12 +602,13 @@ Disable extended attributes support. .TP .BI \-\-xattrs\-exclude= PATTERN Specify the exclude pattern for xattr keys. \fIPATTERN\fR is a globbing -pattern, e.g.\& \fB\-\-xattrs\-exclude='user.*'\fR to include only +pattern, e.g.\& \fB\-\-xattrs\-exclude='user.*'\fR to exclude all attributes from the user namespace. .TP .BI \-\-xattrs\-include= PATTERN Specify the include pattern for xattr keys. \fIPATTERN\fR is a globbing -pattern. +pattern. When creating, the default \fIPATTERN\fR is `\fB*\fR'. When +extracting or listing, the default \fIPATTERN\fR is `\fBuser.*\fR'. .SS Device selection and switching .TP \fB\-f\fR, \fB\-\-file\fR=\fIARCHIVE\fR diff --git a/doc/tar.texi b/doc/tar.texi index d4b332ca..91b1e092 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -5791,8 +5791,9 @@ Disable extended attributes support. This is the default. Attribute names are strings prefixed by a @dfn{namespace} name and a dot. Currently, four namespaces exist: @samp{user}, @samp{trusted}, @samp{security} and @samp{system}. By default, when @option{--xattrs} -is used, all names are stored in the archive (with @option{--create}), -but only @samp{user} namespace is extracted (if using @option{--extract}). +is used, all attributes are stored in the archive (with @option{--create}), +but only attributes in the @samp{user} namespace are applied to extracted +files (with @option{--extract}). The reason for this behavior is that any other, system defined attributes don't provide us sufficient compatibility promise. Storing all attributes is safe operation for the archiving purposes. Though extracting those @@ -5828,9 +5829,9 @@ include and exclude patterns. When both options are used, first @option{--xattrs-include} is applied to select the set of attribute names to keep, and then @option{--xattrs-exclude} is applied to the resulting set. In other -words, only those attributes will be stored, whose names match one -of the regexps in @option{--xattrs-include} and don't match any of -the regexps from @option{--xattrs-exclude}. +words, only those attributes whose names match at least one of the patterns +from @option{--xattrs-include} and don't match any of the patterns from +@option{--xattrs-exclude} will be stored. When listing the archive, if both @option{--xattrs} and @option{--verbose} options are given, files that have extended -- 2.47.3
