[prev in list] [next in list] [prev in thread] [next in thread]
List: linux-man
Subject: Re: [PATCH] vcs.4: Re-write and expound
From: Michael Witten <mfwitten () gmail ! com>
Date: 2019-03-10 0:49:07
Message-ID: d0539052855a4a6a972018b8a9107bc6-mfwitten () gmail ! com
[Download RAW message or body]
On Sat, 9 Mar 2019 12:32:14 +0100, Jakub Wilk wrote:
> * Michael Witten <mfwitten@gmail.com>, 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.
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic