On Sat, 9 Mar 2019 12:32:14 +0100, Jakub Wilk wrote: > * Michael Witten , 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.