Re: 5.0: documentation for 'wait -f'

[Chet Ramey]

On 1/20/19 7:27 AM, Boruch Baum wrote:
> Subject: 5.0: missing documentation for 'wait -f'
> 
> Configuration Information [Automatically generated, do not change]:
> Machine: x86_64
> OS: linux-gnu
> Compiler: gcc
> 
> Compilation CFLAGS: -g -O2
> -fdebug-prefix-map=/build/bash-RVqIBY/bash-5.0=.
> -fstack-protector-strong -Wformat -Werror=format-security -Wall
> -Wno-parentheses -Wno-format-security
> 
> uname output: Linux E15-2016 4.14.0-3-amd64 #1 SMP Debian 4.14.17-1
> (2018-02-14) x86_64 GNU/Linux
> 
> Machine Type: x86_64-pc-linux-gnu
> 
> Bash Version: 5.0
> Patch Level: 0
> Release Status: release
> 
> Description:
>   The CHANGES.gz file documents the addition of an '-f' option to the
>   'wait' builtin, and the feature is documented in the bash man page;
>   however, it is absent from the documentation returned when using the
>   'help' command, ie. 'help wait'.
It's there:

$ ./bash --version
GNU bash, version 5.0.0(1)-release (x86_64-apple-darwin18.2.0)
Copyright (C) 2019 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software; you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
$ ./bash -c 'help wait'
wait: wait [-fn] [id ...]
    Wait for job completion and return exit status.

    Waits for each process identified by an ID, which may be a process ID or a
    job specification, and reports its termination status.  If ID is not
    given, waits for all currently active child processes, and the return
    status is zero.  If ID is a job specification, waits for all processes
    in that job's pipeline.

    If the -n option is supplied, waits for the next job to terminate and
    returns its exit status.

    If the -f option is supplied, and job control is enabled, waits for the
    specified ID to terminate, instead of waiting for it to change status.

    Exit Status:
    Returns the status of the last ID; fails if ID is invalid or an invalid
    option is given.


-- 
``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/