From owner-freebsd-hackers@freebsd.org Tue Nov 8 00:29:29 2016 Return-Path: Delivered-To: freebsd-hackers@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 12529C358CA for ; Tue, 8 Nov 2016 00:29:29 +0000 (UTC) (envelope-from mark@heily.com) Received: from mail-qk0-x22d.google.com (mail-qk0-x22d.google.com [IPv6:2607:f8b0:400d:c09::22d]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id B33ECC65 for ; Tue, 8 Nov 2016 00:29:28 +0000 (UTC) (envelope-from mark@heily.com) Received: by mail-qk0-x22d.google.com with SMTP id x190so196806445qkb.0 for ; Mon, 07 Nov 2016 16:29:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=heily-com.20150623.gappssmtp.com; s=20150623; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=Tr0SIiPlu0JO8EqGM2+Va7hXqn+mN8XqvfQjFh2ELgY=; b=KEYIDE2AzD6JEolDUz2fy8gVRrw1V9aYdYAPyUZusHEvCB2bMpYyceCxCJEmv83HmO rXLBm1rvDhDpoUM2D7yVhzGmHbvVDLapoX8ivB7VuOMeA52Azr1kRI7KaOiY9q2yWhFp nkL0ztOe2haey3bMazaG68PTf8HRp20bH1h2Ad8x5/296WrFut0F8RFlgfKXNmaMqoMl k3VZ9PFITNVyZzC8GlNBlFLSJu3WLS+YL7/uKcFYsm9qRbNH0W+yY0Iyh/T51qufyPJ2 ZZjhF0xZya8Uf5nuJ7Yprk7aFFLcb5lx6dXkXZsdLjJiZrTvIKSooeUzwmoclIO5jJzk 1c4g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=Tr0SIiPlu0JO8EqGM2+Va7hXqn+mN8XqvfQjFh2ELgY=; b=UKOiGvKBOuc7s+QNowE+OBHVc0vQfkOgpA/TQPuL9yfjFeakHKyCrXVKET3Bi4evj5 nz4FQwPS8xZnLBXNhM39jzaFWWfO36/oLiU2RYuNRv5hKbOYNrSeauw9bZ4BY0mwsZfk HaBSnYzG5W5xovPwOdIQZb3yisthZOMpb9/9p1tEEke7wjYot1HisBYjSRYmvaKuei/W CGM43KW2bLSzbGaA9Gay5OW385A6Z0cKZMPd5V6lO/miMjclQeV74aXZxyi9ggWRPv1d hbolUjRm+3+GcY0kn3nkMT9WzPAVuNg1cETK1REzxSRhXUKl6O9mu0XcizWKTQXEQ+3Q 7pNQ== X-Gm-Message-State: ABUngvdepYx4IkWTtY+Nvt0mbMsawFZQd5EoV2yxICmaLh4V2Am4OfaXK907xVxaO1H6UrT6MpfzdPlUGowohw== X-Received: by 10.55.9.77 with SMTP id 74mr8676097qkj.225.1478564967958; Mon, 07 Nov 2016 16:29:27 -0800 (PST) MIME-Version: 1.0 Received: by 10.12.150.39 with HTTP; Mon, 7 Nov 2016 16:29:27 -0800 (PST) X-Originating-IP: [71.70.175.250] In-Reply-To: References: From: Mark Heily Date: Mon, 7 Nov 2016 19:29:27 -0500 Message-ID: Subject: Re: Improved manual page for ul(1) To: Jonathan de Boyne Pollard Cc: FreeBSD Hackers , NetBSD Users Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.23 X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 08 Nov 2016 00:29:29 -0000 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