bug-bash
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: man bash does not list 'in' as a builtin command


From: Chet Ramey
Subject: Re: man bash does not list 'in' as a builtin command
Date: Tue, 26 Nov 2019 11:28:28 -0500
User-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:68.0) Gecko/20100101 Thunderbird/68.2.2

On 11/25/19 8:15 PM, Clint Hepner wrote:

Alternatively, maybe a short list of sections at the top of the man page would 
provide
a hint.

The man page format is pretty entrenched. This is an opportunity for other
tools to fill the gap.

For example, imagine the man page started out like this:

     NAME
             bash - GNU Bourne-Again Shell

     SYNOPSIS
             bash [options] [command_string | file]

     DESCRIPTION

             Bash is [...]

     TABLE OF CONTENTS

         OPTIONS
         ARGUMENTS
         INVOCATION
         DEFINITIONS
         RESERVED WORDS
         SHELL GRAMMAR
         COMMENTS
         QUOTING
         PARAMETERS
         EXPANSION
         REDIRECTION
         ALIASES
         FUNCTIONS
         ARITHMETIC EVALUATION
         CONDITIONAL EXPRESSIONS
         SIMPLE COMMAND EXPANSION
         COMMAND EXECUTION
         COMMAND EXECUTION ENVIRONMENT
         ENVIRONMENT
         EXIT STATUS
         SIGNALS
         JOB CONTROL
         PROMPTING
         READLINE
         HISTORY
         HISTORY EXPANSION
         SHELL BUILTIN COMMANDS
         RESTRICTED SHELL
         SEE ALSO
         FILES
         AUTHORS
         BUG REPORTS
         BUGS

If you want something like this, the info format is a good start. It has
tables of contents, menus with links, and internal cross-references.

--
``The lyf so short, the craft so long to lerne.'' - Chaucer
                 ``Ars longa, vita brevis'' - Hippocrates
Chet Ramey, UTech, CWRU    chet@case.edu    http://tiswww.cwru.edu/~chet/



reply via email to

[Prev in Thread] Current Thread [Next in Thread]