[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]