bug#74205: closed (man: dots and closing bracket in wrong order)

[GNU bug Tracking System]

Your message dated Mon, 4 Nov 2024 13:56:18 -0800
with message-id <8d5ad749-cfaa-4087-9d4c-4dcac0fa16a2@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@gnu.org.)


-- 
74205: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=74205
GNU Bug Tracking System
Contact help-debbugs@gnu.org with problems
> --- Begin Message ---
>
>
>
> 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
>
>
>
> --- End Message ---

--- Begin Message --- Subject: Re: bug#74205: man: dots and closing bracket in wrong order Date: Mon, 4 Nov 2024 13:56:18 -0800 User-agent: Mozilla Thunderbird

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
Description: Text Data

--- End Message ---