From: Sergey Poznyakoff <gray@gnu.org.ua>
Date: Wed, 18 Jan 2006 15:36:01 +0000 (+0000)
Subject: Initial documentation for --quoting-style, --quote-chars and --no-quote-chars option.
X-Git-Url: https://git.dogcows.com/gitweb?a=commitdiff_plain;h=6a97a0068875504b69a96cf44bcb254cb88f2eca;p=chaz%2Ftar

Initial documentation for --quoting-style, --quote-chars and --no-quote-chars option.
---

diff --git a/doc/tar.texi b/doc/tar.texi
index 2e3b9a4..e95a3ad 100644
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -28,7 +28,7 @@ This manual is for @acronym{GNU} @command{tar} (version
 from archives.
 
 Copyright @copyright{} 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001,
-2003, 2004 Free Software Foundation, Inc.
+2003, 2004, 2005, 2006 Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -2591,6 +2591,11 @@ Use case-sensitive matching when excluding files.
 Print warnings about subprocesses terminated with a non-zero exit
 code. @xref{Writing to an External Program}. 
 
+@opindex no-quote-chars, summary
+@item --no-quote-chars=@var{string}
+Do not quote characters from @var{string}, even if the selected
+quoting style implies they should be quoted (@FIXME-pxref{Quoting Styles}).
+
 @opindex no-recursion, summary
 @item --no-recursion
 
@@ -2715,6 +2720,20 @@ anonymous anyway, so that might as well be the owner of anonymous archives.
 
 This option does not affect extraction from archives.
 
+@opindex quote-chars, summary
+@item --quote-chars=@var{string}
+Always quote characters from @var{string}, even if the selected
+quoting style would not quote them (@FIXME-pxref{Quoting Styles}).
+
+@opindex quoting-style, summary
+@item --quoting-style=@var{style}
+Set quoting style to use when printing member and file names
+(@FIXME-pxref{Quoting Styles}). Valid @var{style} values are:
+@code{literal}, @code{shell}, @code{shell-always}, @code{c},
+@code{escape}, @code{locale}, and @code{clocale}. Default quoting
+style is @code{escape}, unless overridden while configuring the
+package. 
+
 @opindex pax-option, summary
 @item --pax-option=@var{keyword-list}
 @FIXME{Such a detailed description does not belong there, move it elsewhere.}
@@ -2941,7 +2960,8 @@ Here is an example of what you can see using this option:
 
 @smallexample
 $ tar --show-defaults
---format=gnu -f- -b20
+--format=gnu -f- -b20 --quoting-style=escape \
+--rmt-command=/usr/libexec/rmt --rsh-command=/usr/bin/rsh
 @end smallexample
 
 @opindex show-omitted-dirs, summary