[PATCH 2/7] man: Build proper sentences for various options.
Cyril Brulebois
kibi at debian.org
Sun Jun 5 17:36:14 PDT 2011
James Cloos <cloos at jhcloos.com> (05/06/2011):
> Most (all?) of those depend on whether the option is part of the
> sentence. You change would be correct if the option is a noun
> which is the object of the verb, but not if the sentence is
> an imperitive description separate from the option.
>
> Most man pages use the latter style.
That's something but…
> Xserver(1) is the only man page I've found (with just a quick check)
> which does not use that style.
>
> Perhaps patching that one would be the better fix.
all I see is that patching a few lines made the manpage itself somewhat
consistent. (ISTR two options after my patch remain with some bits of
context, which doesn't look too bad IMHO.)
> Also, one could argue that the first would should be titlecased;
> ie s/disable/Disable/ et al.
I'm probably not going to propose a patch to change everything to the
other style, with case changes in addition.
Mraw,
KiBi.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110606/1635ed44/attachment.pgp>
More information about the xorg-devel
mailing list