GNU bug report logs - #31600
[PATCH] man: Some formatting fixes in "du.x" and "rm.x"

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Bjarni Ingi Gislason <bjarniig <at> rhi.hi.is>
Subject: bug#31600: closed (Re: bug#31600: [PATCH] man: Some formatting
 fixes in "du.x" and "rm.x")
Date: Sat, 26 May 2018 04:23:02 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#31600: [PATCH] man: Some formatting fixes in "du.x" and "rm.x"

which was filed against the coreutils package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 31600 <at> debbugs.gnu.org.

-- 
31600: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=31600
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Pádraig Brady <P <at> draigBrady.com>
To: Bjarni Ingi Gislason <bjarniig <at> rhi.hi.is>, 31600-done <at> debbugs.gnu.org
Subject: Re: bug#31600: [PATCH] man: Some formatting fixes in "du.x" and "rm.x"
Date: Fri, 25 May 2018 21:22:20 -0700

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 <bjarniig <at> rhi.hi.is>
> ---
> 
>   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.

[Message part 3 (message/rfc822, inline)]

From: Bjarni Ingi Gislason <bjarniig <at> rhi.hi.is>
To: bug-coreutils <at> gnu.org
Subject: [PATCH] man: Some formatting fixes in "du.x" and "rm.x"
Date: Sat, 26 May 2018 00:10:11 +0000

  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 <bjarniig <at> rhi.hi.is>
---

  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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.