Date: Mon, 7 Nov 2016 19:29:27 -0500 From: Mark Heily <mark@heily.com> To: Jonathan de Boyne Pollard <J.deBoynePollard-newsgroups@ntlworld.com> Cc: FreeBSD Hackers <freebsd-hackers@freebsd.org>, NetBSD Users <netbsd-users@netbsd.org> Subject: Re: Improved manual page for ul(1) Message-ID: <CAGfo=8mxMMgGWVCh49aytU%2B2vTp22zwcwrsw=HgpANPy=W_TnQ@mail.gmail.com> In-Reply-To: <c576068d-3aac-596c-ae7b-d3c855e2a88b@NTLWorld.com> References: <c576068d-3aac-596c-ae7b-d3c855e2a88b@NTLWorld.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Nov 5, 2016 at 7:05 AM, Jonathan de Boyne Pollard < J.deBoynePollard-newsgroups@ntlworld.com> wrote: > So whither does one submit an improved manual page for ul(1) ? Here's the > source: > > * http://jdebp.eu./Proposals/ul.1 > > The current FreeBSD/NetBSD manual page really doesn't describe what ul > does and is even somewhat misleading. So the aforelinked has some > improvements. > > I don't think putting this level of detail into the ul(1) manpage is the best approach. Would it be better to create a new manpage in section 5 to describe the TTY-37 control sequences in all their gory detail? You could call it tty37_control(5) or something similar. For comparison, there is a groff_out(5) manpage that you could use as an example. The benefit of a separate manpage for TTY-37 information is that any other commands that deal with these control sequences can have their manpages updated to refer to the tty37_control(5) manual. - Mark
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAGfo=8mxMMgGWVCh49aytU%2B2vTp22zwcwrsw=HgpANPy=W_TnQ>