Document tty mode restoration.

1 files changed, 8 insertions, 2 deletions

diff --git a/Doc/Zsh/jobs.yo b/Doc/Zsh/jobs.yo
index 752181f02..98fca58c5 100644
--- a/Doc/Zsh/jobs.yo
+++ b/Doc/Zsh/jobs.yo
@@ -9,7 +9,7 @@ command, and assigns them small integer numbers.
 When a job is started asynchronously with `tt(&)',
 the shell prints a line which looks like:
 
-nofill(tt([1] 1234))
+example([1] 1234)
 
 indicating that the job which was started asynchronously was job number
 1 and had one (top-level) process, whose process ID was 1234.
@@ -20,7 +20,8 @@ does not have a place in the job table, and is not subject
 to the job control features described here.
 
 If you are running a job and wish to do something else you may hit the key
-^Z (control-Z) which sends a tt(TSTP) signal to the current job.
+^Z (control-Z) which sends a tt(TSTP) signal to the current job:  this key
+may be redefined by the tt(susp) option of the external tt(stty) command.
 cindex(jobs, suspending)
 cindex(suspending jobs)
 The shell will then normally indicate that the job has been `suspended',
@@ -43,6 +44,11 @@ If you set this
 tty option, then background jobs will suspend when they try to produce
 output like they do when they try to read input.
 
+When a command is suspended and continued later with the tt(fg) or
+tt(wait) builtins, zsh restores tty modes that were in effect when it was
+suspended.  This (intentionally) does not apply if the command is
+continued via `tt(kill -CONT)', nor when it is continued with tt(bg).
+
 cindex(jobs, referring to)
 cindex(referring to jobs)
 There are several ways to refer to jobs in the shell.