Bug 219578 - [PATCH] bsdgrep: update synopsis/man page
Summary: [PATCH] bsdgrep: update synopsis/man page
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
Keywords: patch
Depends on:
Reported: 2017-05-26 18:48 UTC by Yuri Pankov
Modified: 2018-08-05 05:51 UTC (History)
4 users (show)

See Also:

patch (4.98 KB, patch)
2017-05-26 18:48 UTC, Yuri Pankov
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
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.