[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [screen-devel] screen manual page reeds a rework
From: |
Alex Naumov |
Subject: |
Re: [screen-devel] screen manual page reeds a rework |
Date: |
Sun, 6 Mar 2016 20:56:24 +0100 |
Hello Eric,
thanks for feedback. Just post your patch here, I will apply it.
Regards,
Alex
On Sun, Mar 6, 2016 at 5:21 PM, Ralph Loizzo <address@hidden> wrote:
> I just joined this mailing list myself a few days ago. For what little my
> opinion is worth, I'm all for reworking the man pages! Thank you Eric!
>
>> On Mar 6, 2016, at 8:28 AM, Eric S. Raymond <address@hidden> wrote:
>>
>> I've just joined screen-devel because, in connection with another of
>> my projects (doclifter) I've discovered that the screen manual page
>> needs a significant reworking.
>>
>> The problem is not the content but the markup. The screen.1 page is
>> old-school troff visual-level hackery, poorly structured. This is
>> not a problem as long as groff is the only renderer, but it interferes
>> with generating XML-Docbook and high-quality HTML from the page.
>>
>> I already have a patch to turn the main command-keystroke table,
>> presently a rather fragile pile of list syntax, into a real TBL table.
>> This improves its appearance even in nroff rendering and allows a much
>> better HTML translation. There are some other, similar things that
>> should be done further down the page.
>>
>> I don't know the screen project's customs. I could post patches here,
>> or apply for commit privileges on the repo at Savannah. Please let
>> me know how you would like me to proceed.
>> --
>> <a href="http://www.catb.org/~esr/">Eric S. Raymond</a>
>>
>> When only cops have guns, it's called a "police state".
>> -- Claire Wolfe, "101 Things To Do Until The Revolution"
>>
>