GNU bug report logs - #59262
Dash instead of two hyphens in manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 59262 in the body.
You can then email your comments to 59262 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Antonio Diaz Diaz <antonio <at> gnu.org>
To: bug-coreutils <at> gnu.org
Cc: Antonio Diaz Diaz <antonio <at> gnu.org>
Subject: Dash instead of two hyphens in manual
Date: Mon, 14 Nov 2022 19:23:23 +0100

Hello.

I have found a minor bug in the manual.

In the entry descriptions of the menu at the bottom of 'Common options'[1] 
there are 6 long option names preceded by a dash instead of two hyphens 
('â@Sblock-size' instead of '--block-size', etc).

Maybe those option names should be inserted in an @option or @code command?

[1] http://www.gnu.org/software/coreutils/manual/html_node/Common-options.html

Thanks,
Antonio.

Message #10 received at 59262-done <at> debbugs.gnu.org (full text, mbox):

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: Antonio Diaz Diaz <antonio <at> gnu.org>
Cc: 59262-done <at> debbugs.gnu.org
Subject: Re: bug#59262: Dash instead of two hyphens in manual
Date: Mon, 14 Nov 2022 19:11:58 -0800

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

Thanks for reporting that. Fixed by installing the attached. This should 
propagate to the web pages after the next release.

[0001-build-update-gnulib-submodule-to-latest.patch (text/x-patch, attachment)]

[0002-doc-fix-markup.patch (text/x-patch, attachment)]

Message #13 received at 59262 <at> debbugs.gnu.org (full text, mbox):

From: Pádraig Brady <P <at> draigBrady.com>
To: Antonio Diaz Diaz <antonio <at> gnu.org>, 59262 <at> debbugs.gnu.org
Subject: Re: bug#59262: Dash instead of two hyphens in manual
Date: Tue, 15 Nov 2022 13:36:41 +0000

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

On 14/11/2022 18:23, Antonio Diaz Diaz wrote:
> Hello.
> 
> I have found a minor bug in the manual.
> 
> In the entry descriptions of the menu at the bottom of 'Common options'[1]
> there are 6 long option names preceded by a dash instead of two hyphens
> ('â@Sblock-size' instead of '--block-size', etc).
> 
> Maybe those option names should be inserted in an @option or @code command?
> 
> [1] http://www.gnu.org/software/coreutils/manual/html_node/Common-options.html


A few  more instances are fixed in the attached,
and a new syntax check to avoid future occurrences.

thanks,
Pádraig.

[texi-long-option-quote.patch (text/x-patch, attachment)]

Message #16 received at 59262 <at> debbugs.gnu.org (full text, mbox):

From: Antonio Diaz Diaz <antonio <at> gnu.org>
To: 59262 <at> debbugs.gnu.org
Cc: Antonio Diaz Diaz <antonio <at> gnu.org>
Subject: Re: bug#59262: Dash instead of two hyphens in manual
Date: Tue, 15 Nov 2022 15:56:57 +0100

Thank you Paul and Pádraig for the quick and comprehensive fix! Way beyond 
what I noticed and reported, in fact.

Antonio.

Message #19 received at 59262 <at> debbugs.gnu.org (full text, mbox):

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: Pádraig Brady <P <at> draigBrady.com>,
 Antonio Diaz Diaz <antonio <at> gnu.org>, 59262 <at> debbugs.gnu.org
Subject: Re: bug#59262: Dash instead of two hyphens in manual
Date: Tue, 15 Nov 2022 10:59:06 -0800

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

On 2022-11-15 05:36, Pádraig Brady wrote:
> A few  more instances are fixed in the attached,
> and a new syntax check to avoid future occurrences.

Thanks, I installed the attached to fix a comment, and fix some more 
hyphen-vs-dash issues that I noticed while looking at your patch. These 
are harder to automate, unfortunately.

[0001-maint-fix-cfg.mk-comment.patch (text/x-patch, attachment)]

[0002-doc-more-dash-fixes.patch (text/x-patch, attachment)]

Previous Next

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