On Sat, 9 Mar 2019 12:32:14 +0100, Jakub Wilk wrote:
> * Michael Witten <mfwitten@xxxxxxxxx>, 2019-03-04, 17:04:
>>This commit provides a much more comprehensive description of virtual
>>console capture devices, and how to use them properly.
>
> I only had a brief look at the new text, but I'm afraid this is way too
> verbose to be practically useful. For example:
>
> - We don't need 30 lines of explanation of the coordinate system. The
> current man page says "x = y = 0 at the top left corner of the screen",
> which is more than enough.
>
> - We don't need 4 different examples; one would be enough.
Thank you for your input.
I disagree with your analysis.
This document has been designed with to 2 groups in mind:
* Those who appreciate nuance.
* Those who do not appreciate nuance (or cannot),
particularly those who appreciate a lack of nuance.
There is a concise SYNOPSIS. There is also exactly one C-source
program in the EXAMPLES section.
That one C-source example is readily accessable by, for example,
pressing `shift-g' to send the widespread `less' pager down to
the bottom of the man page, where convention usually places such
things.
As a particular reader, you desire certain content, and this
revision delivers it; it also delivers the content that I as a
reader desire.
Sincerely,
Michael Witten
>> man -Tpdf vcs >/tmp/vcs.pdf
>
> (This is not a secure use of /tmp.)
I suppose you know something that I do not; if only there were
more nuance in your remark, I might be able to interact more
meaningfully with your thoughts here.
