Bug 219578

Summary: [PATCH] bsdgrep: update synopsis/man page
Product: Documentation Reporter: Yuri Pankov <yuripv>
Component: Manual PagesAssignee: freebsd-doc (Nobody) <doc>
Status: New ---    
Severity: Affects Some People CC: cem, doc, emaste, kevans
Priority: --- Keywords: patch
Version: Latest   
Hardware: Any   
OS: Any   
Description Flags
patch none

Description Yuri Pankov 2017-05-26 18:48:18 UTC
Created attachment 182941 [details]

- remove --colour and --context from SYNOPSIS and usage, they are equivalents of --color and -C, respectively
- fix formatting for -C and --color option in DESCRIPTION
- correct label in SYNOPSIS and add it to DESCRIPTION
- add --exclude, --exclude-dir, --include, and --include-dir to both SYNOPSIS and usage
- move long options inside the DESCRIPTION sorting them alphabetically - some of them were already there, just for consistency
- add --mmap to SYNOPSIS and usage
- remove (or change) the nonexistent -P option

updated usage:

usage: grep [-abcDEFGHhIiJLlmnOopqRSsUVvwxZz] [-A num] [-B num] [-C[num]]
        [-e pattern] [-f file] [--binary-files=value] [--color[=when]]
        [--exclude=pattern] [--exclude-dir=pattern] [--include=pattern]
        [--include-dir=pattern] [--label=value] [--line-buffered] [--mmap]
        [--null] [pattern] [file ...]
Comment 1 Kyle Evans freebsd_committer 2017-05-26 21:33:15 UTC
While I have slight reservations about removing the alternative spelling of 'color', it's not reflected in the usage either so this seems OK.

Seems sensible, we'll also need to update the nls/ catalogs to reflect the new usage strings.