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: Martin Schulte <gnu <at> schrader-schulte.de>
Subject: bug#74205: closed (Re: bug#74205: man: dots and closing bracket
 in wrong order)
Date: Mon, 04 Nov 2024 21:57:02 +0000

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

Your bug report

#74205: man: dots and closing bracket in wrong order

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

The explanation is attached below, along with your original report.
If you require more details, please reply to 74205 <at> debbugs.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: 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 3 (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)]

[Message part 5 (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

Previous Next

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