commit bash-20170203 snapshot

doc/bash.1

@@ -5,12 +5,12 @@
 .\"	Case Western Reserve University
 .\"	chet.ramey@case.edu
 .\"
-.\"	Last Change: Fri Dec 16 11:45:56 EST 2016
+.\"	Last Change: Fri Feb  3 16:01:50 EST 2017
 .\"
 .\" bash_builtins, strip all but Built-Ins section
 .if \n(zZ=1 .ig zZ
 .if \n(zY=1 .ig zY
-.TH BASH 1 "2016 December 16" "GNU Bash 4.4"
+.TH BASH 1 "2017 February 3" "GNU Bash 4.4"
 .\"
 .\" There's some problem with having a `@'
 .\" in a tagged paragraph with the BSD man macros.
@@ -5095,6 +5095,11 @@ command may then be used to inspect their status.
 If a second attempt to exit is made without an intervening command,
 the shell does not print another warning, and any stopped
 jobs are terminated.
+.PP
+When the shell is waiting for a job or process using the \fBwait\fP
+builtin, and job control is enabled, \fBwait\fP will return when the
+job changes state. The \fB\-f\fP option will force \fBwait\fP to wait
+until the job or process terminates before returning.
 .SH PROMPTING
 When executing interactively,
 .B bash
@@ -5966,6 +5971,19 @@ Words are delimited by non-quoted shell metacharacters.
 Move back to the start of the current or previous word.
 Words are delimited by non-quoted shell metacharacters.
 .TP
+.B previous\-screen\-line
+Attempt to move point to the same physical screen column on the previous
+physical screen line. This will not have the desired effect if the current
+Readline line does not take up more than one physical line or if point is not  
+greater than the length of the prompt plus the screen width.
+.TP
+.B next\-screen\-line
+Attempt to move point to the same physical screen column on the next
+physical screen line. This will not have the desired effect if the current
+Readline line does not take up more than one physical line or if the length
+of the current Readline line is not greater than the length of the prompt
+plus the screen width.
+.TP
 .B clear\-screen (C\-l)
 Clear the screen leaving the current line at the top of the screen.
 With an argument, refresh the current line without clearing the
@@ -10500,20 +10518,23 @@ subsequently reset.  The exit status is true unless a
 .I name
 is readonly.
 .TP
-\fBwait\fP [\fB\-n\fP] [\fIn ...\fP]
+\fBwait\fP [\fB\-fn\fP] [\fIid ...\fP]
 Wait for each specified child process and return its termination status.
 Each
-.I n
+.I id
 may be a process
 ID or a job specification; if a job spec is given, all processes
 in that job's pipeline are waited for.  If
-.I n
+.I id
 is not given, all currently active child processes
 are waited for, and the return status is zero.
 If the \fB\-n\fP option is supplied, \fBwait\fP waits for any job to
 terminate and returns its exit status.
+If the \fB\-f\fP option is supplied, and job control is enabled,
+\fBwait\fP forces \fIid\fP to terminate before returning its status,
+intead of returning when it changes status.
 If
-.I n
+.I id
 specifies a non-existent process or job, the return status is
 127.  Otherwise, the return status is the exit status of the last
 process or job waited for.