about summary refs log tree commit diff
diff options
context:
space:
mode:
authorPeter Stephenson <pws@zsh.org>2014-09-04 09:31:44 +0100
committerPeter Stephenson <pws@zsh.org>2014-09-04 09:31:44 +0100
commit2bff41d1f67a757962c7f1db5223ee676d10e7f5 (patch)
tree970f4db61aa9cadcc468f6f48b5fdcfaa155c3d5
parenta3b1e3ffb1765943aef4a1d74f66ffe5f899ac02 (diff)
downloadzsh-2bff41d1f67a757962c7f1db5223ee676d10e7f5.tar.gz
zsh-2bff41d1f67a757962c7f1db5223ee676d10e7f5.tar.xz
zsh-2bff41d1f67a757962c7f1db5223ee676d10e7f5.zip
33091: improve documentation for ttyctl
-rw-r--r--ChangeLog4
-rw-r--r--Doc/Zsh/builtins.yo18
2 files changed, 19 insertions, 3 deletions
diff --git a/ChangeLog b/ChangeLog
index 5041d171f..c900eaa42 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2014-09-04  Peter Stephenson  <p.stephenson@samsung.com>
+
+	* 33091: Doc/Zsh/builtins.yo: improve documentation for ttyctl.
+
 2014-09-03  Barton E. Schaefer  <schaefer@zsh.org>
 
 	* 33100: Src/exec.c: check $fd more rigorously in "exec {fd}<&-"
diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo
index f709f5020..9862c637e 100644
--- a/Doc/Zsh/builtins.yo
+++ b/Doc/Zsh/builtins.yo
@@ -1639,14 +1639,26 @@ Do nothing and return an exit status of 0.
 findex(ttyctl)
 cindex(tty, freezing)
 item(tt(ttyctl) tt(-fu))(
-The tt(-f) option freezes the tty, and tt(-u) unfreezes it.
+The tt(-f) option freezes the tty (i.e. terminal or terminal emulator), and
+tt(-u) unfreezes it.
 When the tty is frozen, no changes made to the tty settings by
 external programs will be honored by the shell, except for changes in the
 size of the screen; the shell will
 simply reset the settings to their previous values as soon as each
 command exits or is suspended.  Thus, tt(stty) and similar programs have
-no effect when the tty is frozen.  Without options it reports whether the
-terminal is frozen or not.
+no effect when the tty is frozen.  Freezing the tty does not cause
+the current state to be remembered: instead, it causes future changes
+to the state to be blocked.
+
+Without options it reports whether the terminal is frozen or not.
+
+Note that, regardless of whether the tty is frozen or not, the
+shell needs to change the settings when the line editor starts, so
+unfreezing the tty does not guarantee settings made on the
+command line are preserved.  Strings of commands run between
+editing the command line will see a consistent tty state.
+See also the shell variable tt(STTY) for a means of initialising
+the tty before running external commands.
 )
 findex(type)
 item(tt(type) [ tt(-wfpams) ] var(name) ...)(