1
0
Fork 0
mirror of git://git.code.sf.net/p/zsh/code synced 2025-09-02 22:11:54 +02:00

33091: improve documentation for ttyctl

This commit is contained in:
Peter Stephenson 2014-09-04 09:31:44 +01:00
parent a3b1e3ffb1
commit 2bff41d1f6
2 changed files with 19 additions and 3 deletions

View file

@ -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}<&-"

View file

@ -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) ...)(