Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > gnu.bash.bug > #15658

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

Show key headers only | View raw

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/

Back to gnu.bash.bug | Previous | Next | Find similar | Unroll thread

Thread

Re: man bash does not list 'in' as a builtin command Chet Ramey <chet.ramey@case.edu> - 2019-11-26 11:28 -0500

csiph-web