[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