From: Pádraig Brady <P@draigBrady.com>
Date: Wed, 31 Aug 2022 13:16:14 +0000 (+0100)
Subject: doc: stty: clarify that [-]drain is treated as an option
X-Git-Tag: v9.2~151
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b81205bdc7505668282afa6e9dc3a6bb82a038bf;p=thirdparty%2Fcoreutils.git

doc: stty: clarify that [-]drain is treated as an option

* doc/coreutils.texi (stty invocation): Say that "drain"
is treated as an option, rather than a line setting,
and so option processing rules apply to it.
Reported in https://bugs.debian.org/1018803
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index de819b6dc9..2af7616546 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -15518,6 +15518,8 @@ Tell the kernel that the terminal has @var{n} columns.  Non-POSIX.
 @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}.
+Note this is treated as an option rather than a line setting,
+and will follow the option processing rules described in the summary above.
 It is useful to disable this option
 in cases where the system may be in a state where serial transmission
 is not possible.