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

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Paul Eggert <eggert <at> cs.ucla.edu>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#74205: closed (man: dots and closing bracket in wrong order)
Date: Mon, 04 Nov 2024 21:57:02 +0000

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

Your message dated Mon, 4 Nov 2024 13:56:18 -0800
with message-id <8d5ad749-cfaa-4087-9d4c-4dcac0fa16a2 <at> cs.ucla.edu>
and subject line Re: bug#74205: man: dots and closing bracket in wrong order
has caused the debbugs.gnu.org bug report #74205,
regarding man: dots and closing bracket in wrong order
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


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

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

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

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

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 4 (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)]

Previous Next

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