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 c...@case.edu http://tiswww.cwru.edu/~chet/