--- Begin Message ---
|
Subject: |
[PATCH] man: Some formatting fixes in "du.x" and "rm.x" |
|
Date: |
Sat, 26 May 2018 00:10:11 +0000 |
|
User-agent: |
Mutt/1.5.20 (2009-12-10) |
Change ".BR" to ".B" if there is only one argument.
Protect an end-of-sentence indicator (.?!) with '\&' if it does not
mean an end of a sentence.
Change '--' to '\-\' if it indicates an option.
Change '\=' to '='.
Signed-off-by: Bjarni Ingi Gislason <address@hidden>
---
Details:
Warnings from "groff".
Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z
[ "test-groff" is a developmental version of "groff" ]
<du.x>:12 (macro BR): only 1 argument, but more are expected
<du.x>:14 (macro BR): only 1 argument, but more are expected
<du.x>:17 (macro BR): only 1 argument, but more are expected
<du.x>:25 (macro BR): only 1 argument, but more are expected
<du.x>:27 (macro BR): only 1 argument, but more are expected
#
troff: <rm.x>:16: warning: escape character ignored before '='
troff: <rm.x>:25: warning: escape character ignored before '='
###
man/du.x | 12 ++++++------
man/rm.x | 4 ++--
2 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/man/du.x b/man/du.x
index 43f66ffa2..cd68e40ea 100644
--- a/man/du.x
+++ b/man/du.x
@@ -9,20 +9,20 @@ du \- estimate file space usage
.\" Add any additional description here
[PATTERNS]
PATTERN is a shell pattern (not a regular expression). The pattern
-.BR ?
+.B ?\&
matches any one character, whereas
-.BR *
+.B *
matches any string (composed of zero, one or multiple characters). For
example,
-.BR *.o
+.B *.o
will match any files whose names end in
.BR .o .
Therefore, the command
.IP
-.B du --exclude=\(aq*.o\(aq
+.B du \-\-exclude=\(aq*.o\(aq
.PP
will skip all files and subdirectories ending in
-.BR .o
+.B .o
(including the file
-.BR .o
+.B .o
itself).
diff --git a/man/rm.x b/man/rm.x
index 278eba009..3044a0914 100644
--- a/man/rm.x
+++ b/man/rm.x
@@ -13,7 +13,7 @@ documents the GNU version of
removes each specified file. By default, it does not remove
directories.
.P
-If the \fI\-I\fR or \fI\-\-interactive\=once\fR option is given,
+If the \fI\-I\fR or \fI\-\-interactive=once\fR option is given,
and there are more than three files or the \fI\-r\fR, \fI\-R\fR,
or \fI\-\-recursive\fR are given, then
.B rm
@@ -22,7 +22,7 @@ the response is not affirmative, the entire command is
aborted.
.P
Otherwise, if a file is unwritable, standard input is a terminal, and
the \fI\-f\fR or \fI\-\-force\fR option is not given, or the
-\fI\-i\fR or \fI\-\-interactive\=always\fR option is given,
+\fI\-i\fR or \fI\-\-interactive=always\fR option is given,
.B rm
prompts the user for whether to remove the file. If the response is
not affirmative, the file is skipped.
--
2.17.0
--
Bjarni I. Gislason
--- End Message ---
--- Begin Message ---
|
Subject: |
Re: bug#31600: [PATCH] man: Some formatting fixes in "du.x" and "rm.x" |
|
Date: |
Fri, 25 May 2018 21:22:20 -0700 |
|
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 |
On 25/05/18 17:10, Bjarni Ingi Gislason wrote:
> Change ".BR" to ".B" if there is only one argument.
>
> Protect an end-of-sentence indicator (.?!) with '\&' if it does not
> mean an end of a sentence.
>
> Change '--' to '\-\' if it indicates an option.
>
> Change '\=' to '='.
>
> Signed-off-by: Bjarni Ingi Gislason <address@hidden>
> ---
>
> Details:
>
> Warnings from "groff".
>
> Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z
Pushed at:
https://git.sv.gnu.org/gitweb/?p=coreutils.git;a=commitdiff;h=fb1ca34
thanks!
Pádraig.
--- End Message ---