[PATCH] xrandr: add more information about the transform option in the manpage

Éric Piel E.A.B.Piel at tudelft.nl
Mon Jan 4 06:15:00 PST 2010


Op 04-01-10 12:32, Matthias Hopf schreef:
> On Jan 03, 10 01:20:42 +0100, Eric Piel wrote:
>> Here is a patch for the xrandr manpage to describe with more precision
>> the --transform option, which, as Bernard noted, was rather vague.
> 
> Thanks. I have a number of issues with this patch, though:
> 
> - It uses UTF-8 - that is IMHO still problematic in man pages.
> - The formula is written in a missunderstandable way - no wonder with
>   the limitations ASCII-art  has :-P
> - Some notations are off compared to the standards.
> - Minor nitpitting: some end-of-line whitespace.
> 
> But I took this as an initiative, to finally update this section of the
> man page.
> 
> Please recheck whether my gabbling is understandable as soon as I
> committed it.
Looks fine to me. I wonder why you called the 3rd coordinate 'w' instead
of the usual 'z', but otherwise it's very clear. Especially, the
mathematics formula is readable line by line, but can also be easily
converted to the vector-based writing :-)

BTW, it seems that the normal term is "keystone correction" instead of
"keystone shaping" as I wrote. You might want to fix it.

Thanks,
Eric


More information about the xorg-devel mailing list