diff options
| author | Pádraig Brady <P@draigBrady.com> | 2016-01-06 14:40:03 +0000 |
|---|---|---|
| committer | Pádraig Brady <P@draigBrady.com> | 2016-01-06 15:20:49 +0000 |
| commit | cb7d8b90a213c0186a8c8ba66da959e1f5930e78 (patch) | |
| tree | 7c71619d355e0e4b57d59aec837924d840b85f13 /doc/coreutils.texi | |
| parent | 5171befcb122b12677f60715603be091625a9e08 (diff) | |
| download | coreutils-cb7d8b90a213c0186a8c8ba66da959e1f5930e78.tar.xz | |
stty: support [-]drain setting to control waiting for pending Tx
Instead of commit v8.24-132-g5171bef which only provides
control to disable this behavior (with -I), provide
the symmetrical "[-]drain" special setting.
* src/stty.c (main): Parse the [-]drain setting instead of -I,
and treat like a global option.
(usage): Adjust accordingly.
* tests/misc/stty.sh: Test "drain" with and without options.
* NEWS: Mention the new feature.
Diffstat (limited to 'doc/coreutils.texi')
| -rw-r--r-- | doc/coreutils.texi | 25 |
1 files changed, 13 insertions, 12 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 85477a05a..1fd99d0f8 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -13808,18 +13808,6 @@ Print all current settings in a form that can be used as an argument to another @command{stty} command to restore the current settings. This option may not be used in combination with any line settings. -@item -I -@itemx --immediate -@opindex -I -@opindex --immediate -@cindex nonblocking @command{stty} setting -Apply settings without first waiting for pending output to be transmitted. -In some cases the system may be in a state where serial transmission -is not possible. -For example, if the system has received the @samp{DC3} character -with @code{ixon} (software flow control) enabled, then @command{stty} would -block without this option. - @end table Many settings can be turned off by preceding them with a @samp{-}. @@ -14439,6 +14427,19 @@ Non-POSIX. @opindex columns Tell the kernel that the terminal has @var{n} columns. Non-POSIX. +@item drain +@opindex drain +@cindex nonblocking @command{stty} setting +Apply settings after first waiting for pending output to be transmitted. +This is enabled by default for GNU @command{stty}. +It is useful to disable this option +in cases where the system may be in a state where serial transmission +is not possible. +For example, if the system has received the @samp{DC3} character +with @code{ixon} (software flow control) enabled, then @command{stty} would +block without @code{-drain} being specified. +May be negated. Non-POSIX. + @item size @opindex size @vindex LINES |