Date: Tue, 17 Aug 2010 02:31:27 +0400 From: Anonymous <swell.k@gmail.com> To: freebsd-ports@FreeBSD.org Subject: [portmaster] navigation in the man page Message-ID: <86bp92i400.fsf@gmail.com>
next in thread | raw e-mail | index | archive | help
Am I the only one who finds it hard to navigate in portmaster(8)?
- options are neither sorted alphabetically nor grouped in blocks[1]
- too little space between an option and its description
- inconsistent in using terms (flags vs. options)
- being too verbose about port-related terms[2]
- SYNOPSYS makes a spaghetti with one-letter options, long options and comments[3]
- DESCRIPTION is too verbose, it should go either to EXAMPLES or to a
specific option description[4] 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.
[1] look at how grouping is done in grep(1) from textproc/gnugrep
[2] 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
there.
[3] Smth like `portmaster [options] [args...]' is probably enough.
There is already EXAMPLES section, no need to duplicate it.
[4] 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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?86bp92i400.fsf>