[portmaster] navigation in the man page
swell.k at gmail.com
Mon Aug 16 22:36:29 UTC 2010
Am I the only one who finds it hard to navigate in portmaster(8)?
- options are neither sorted alphabetically nor grouped in blocks
- too little space between an option and its description
- inconsistent in using terms (flags vs. options)
- being too verbose about port-related terms
- SYNOPSYS makes a spaghetti with one-letter options, long options and comments
- DESCRIPTION is too verbose, it should go either to EXAMPLES or to a
specific option description in OPTIONS
- `-i' option is misleading, portmaster is already quite interactive
On the side, I still can't find how to shut up portmaster from asking me
about +IGNOREME ports.
 look at how grouping is done in grep(1) from textproc/gnugrep
 Like the one below
[-R] -r name/glob of port directory in /var/db/pkg
Why not use `origin' or `pkg-name' term from pkg_info(1)? WTF is
`port directory in /var/db/pkg' ? Only *package* directories lie
 Smth like `portmaster [options] [args...]' is probably enough.
There is already EXAMPLES section, no need to duplicate it.
 I for one read DESCRIPTION only once, when first run the tool and
never again. Most of the time I'm more concerned how certain
option changes behavior and not interested in general prose.
More information about the freebsd-ports