From owner-freebsd-questions@freebsd.org  Wed Oct 25 21:09:47 2017
Return-Path: <owner-freebsd-questions@freebsd.org>
Delivered-To: freebsd-questions@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 857A0E544EE
 for <freebsd-questions@mailman.ysv.freebsd.org>;
 Wed, 25 Oct 2017 21:09:47 +0000 (UTC)
 (envelope-from prvs=146420bbf1=vogelke@pobox.com)
Received: from WPAFB-MAIL5.AFNOC.Af.MIL (wpafb-mail5.afnoc.af.mil
 [131.27.1.17])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "WPAFB-MAIL5.afnoc.af.mil", Issuer "DOD ID SW CA-38" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 18D6D82332
 for <freebsd-questions@freebsd.org>; Wed, 25 Oct 2017 21:09:46 +0000 (UTC)
 (envelope-from prvs=146420bbf1=vogelke@pobox.com)
Received: from us.af.mil (unknown [131.9.254.133]) by WPAFB-MAIL5.AFNOC.Af.MIL
 with smtp (TLS: TLSv1/SSLv3,256bits,DHE-RSA-AES256-SHA)
 id 6939_6c68_dfa8636f_1daf_4dcc_a6f1_ca2d51ac6c51;
 Wed, 25 Oct 2017 21:09:30 +0000
Received: from ([131.9.40.227])
 by 52vejx-mr-002.us.af.mil with SMTP  id 5X21FN1.322309225;
 Wed, 25 Oct 2017 16:09:24 -0500
Received: (qmail 22952 invoked by uid 100); 25 Oct 2017 21:09:21 -0000
From: "Karl Vogel" <vogelke@pobox.com>
Date: Wed, 25 Oct 2017 17:09:21 -0400
To: freebsd-questions@freebsd.org
Subject: Re: A request to segregate man pages for shell built-ins
Message-ID: <20171025210920.GA22834@bsd118.wpafb.af.mil>
Reply-To: vogelke@pobox.com
References: <VI1PR02MB1200817E0E2CDD2A2A42E1A5F6440@VI1PR02MB1200.eurprd02.prod.outlook.com>
 <f88cd63e-3cbc-4463-5219-99d204742b85@FreeBSD.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <f88cd63e-3cbc-4463-5219-99d204742b85@FreeBSD.org>
User-Agent: Mutt/1.6.0 (2016-04-01)
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions/>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Oct 2017 21:09:47 -0000

On Wed, Oct 25, 2017 at 07:14:28AM +0100, Matthew Seaman wrote:

> I'm sure creating separate man pages is possible: it's just a question
> of someone stepping up and doing the work.

  Here's a "solution" from the baling-twine-and-ductape school of coding.
  I ran "compgen -b" under bash and got a list of builtins:

    .
    :
    [
    alias
    [...]
    unalias
    unset
    wait

  A little vi:

    help . >  dot.1
    help : > :.1
    help [ > [.1
    help alias > alias.1
    help unalias > unalias.1
    help unset > unset.1
    help wait > wait.1

  Run "strings" on /path/to/man and find the default MANSECT.  Stick all
  these files under /usr/local/man/cat1b and give it a test-drive:

    #!/bin/ksh
    #<myman: quick manpage test
    export PATH=/usr/local/bin:/bin:/usr/bin
    export MANSECT=1b:1:1p:8:2:3:3p:4:5:6:7:9:0p:tcl:n:l:p:o

    case "$1" in
        .) page=dot ;;
        *) page=$1 ;;
    esac

    man $page
    exit 0

  You could do something just as hideous for ksh/tcsh/whatever and put
  the results under separate sections.  In one of your login dotfiles:

    export MANSECT=1:1p:8:2:3:3p:4:5:6:7:9:0p:tcl:n:l:p:o

    case "$SHELL" in
        *bash)  add="1b" ;;
        *csh)   add="1c" ;;
        *zsh)   add="1z" ;;
    esac

    MANSECT="${add}:$MANSECT"

... I'll show myself out.

-- 
Karl Vogel                      I don't speak for the USAF or my company

You're the type of guy who'd give a Rubik's Cube to Forrest Gump.
                                                     --Local DJ, station Z93