Improved manual page for ul(1)

Mark Heily mark at heily.com
Tue Nov 8 00:29:29 UTC 2016


On Sat, Nov 5, 2016 at 7:05 AM, Jonathan de Boyne Pollard <
J.deBoynePollard-newsgroups at 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


More information about the freebsd-hackers mailing list