GNU bug report logs - #74205
man: dots and closing bracket in wrong order

Previous Next

Package: grep;

Reported by: Martin Schulte <gnu <at> schrader-schulte.de>

Date: Mon, 4 Nov 2024 20:29:02 UTC

Severity: normal

Done: Paul Eggert <eggert <at> cs.ucla.edu>

Bug is archived. No further changes may be made.

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

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

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-grep <at> gnu.org:
bug#74205; Package grep. (Mon, 04 Nov 2024 20:29:02 GMT) Full text and rfc822 format available.
Acknowledgement sent to Martin Schulte <gnu <at> schrader-schulte.de>:
New bug report received and forwarded. Copy sent to bug-grep <at> gnu.org. (Mon, 04 Nov 2024 20:29:02 GMT) Full text and rfc822 format available.

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

From: Martin Schulte <gnu <at> schrader-schulte.de>
To: bug-grep <at> gnu.org
Subject: man: dots and closing bracket in wrong order
Date: Mon, 4 Nov 2024 21:28:39 +0100

Hello,

it doesn't harm but I always stumple when I read the SYNOPSIS in grep's man page where - in contrast to the usage message - the dots and the closing are in the wrong order compared to "all" other man pages:

$ man grep | head
GREP(1)                         User Commands                        GREP(1)

NAME
       grep, egrep, fgrep, rgrep - print lines that match patterns

SYNOPSIS
       grep [OPTION...] PATTERNS [FILE...]
       grep [OPTION...] -e PATTERNS ... [FILE...]
       grep [OPTION...] -f PATTERN_FILE ... [FILE...]

$ grep
Usage: grep [OPTION]... PATTERNS [FILE]...
Try 'grep --help' for more information.

Best regards

Martin
Reply sent to Paul Eggert <eggert <at> cs.ucla.edu>:
You have taken responsibility. (Mon, 04 Nov 2024 21:57:02 GMT) Full text and rfc822 format available.
Notification sent to Martin Schulte <gnu <at> schrader-schulte.de>:
bug acknowledged by developer. (Mon, 04 Nov 2024 21:57:02 GMT) Full text and rfc822 format available.

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

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: Martin Schulte <gnu <at> schrader-schulte.de>
Cc: 74205-done <at> debbugs.gnu.org
Subject: Re: bug#74205: man: dots and closing bracket in wrong order
Date: Mon, 4 Nov 2024 13:56:18 -0800

[Message part 1 (text/plain, inline)]
On 2024-11-04 12:28, Martin Schulte wrote:
> the dots and the closing are in the wrong order compared to "all" other man pages:

POSIX uses yet another style for ... and []; see:

https://pubs.opengroup.org/onlinepubs/9799919799/utilities/grep.html

That being said, it's a bit nicer if grep matches similar GNU apps 
(regardless of what POSIX does) so I installed the attached patch to try 
to do that. Thanks for mentioning the issue.
[0001-doc-more-consistent-style-for.patch (text/x-patch, attachment)]
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Tue, 03 Dec 2024 12:24:05 GMT) Full text and rfc822 format available.
This bug report was last modified 196 days ago.

Previous Next

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