Hi,
In POSIX 2024, stty has the following change [1]:
Austin Group Defects 1053, 1532, and 1687 are applied, changing the
-g option and adding the rows number, cols number, and size
operands.
Here is a patch updating the output of --help and documentation to
reflect the standardization of rows, cols, and size.
The -g change shouldn't affect us since it just clarifies that 'stty -g'
shouldn't have special characters that could be altered by file name
expansion by the shell.
Collin
[1] https://pubs.opengroup.org/onlinepubs/9799919799/utilities/stty.html
>From 49a15c27690e8d4ce19863fdbff55d6b4b3f414a Mon Sep 17 00:00:00 2001
From: Collin Funk <collin.fu...@gmail.com>
Date: Thu, 31 Oct 2024 22:43:18 -0700
Subject: [PATCH] stty: adjust --help to match POSIX 2024
* src/stty.c (usage): Mark cols, rows, and size as standardized by
POSIX.
* doc/coreutils.texi (Special): Likewise.
---
doc/coreutils.texi | 8 ++++----
src/stty.c | 6 +++---
2 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 77eed8e7c..60a07b2ef 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -15855,13 +15855,14 @@ @node Special
@item rows @var{n}
@opindex rows
Tell the tty kernel driver that the terminal has @var{n} rows.
-Non-POSIX.
@item cols @var{n}
-@itemx columns @var{n}
@opindex cols
+Tell the kernel that the terminal has @var{n} columns.
+
+@item columns @var{n}
@opindex columns
-Tell the kernel that the terminal has @var{n} columns. Non-POSIX.
+Same as @samp{cols}. Non-POSIX.
@item drain
@opindex drain
@@ -15886,7 +15887,6 @@ @node Special
terminal has. (Systems that don't support rows and columns in the kernel
typically use the environment variables @env{LINES} and @env{COLUMNS}
instead; however, GNU @command{stty} does not know anything about them.)
-Non-POSIX.
@item line @var{n}
@opindex line
diff --git a/src/stty.c b/src/stty.c
index 95091744a..db993888f 100644
--- a/src/stty.c
+++ b/src/stty.c
@@ -632,7 +632,7 @@ Special settings:\n\
"), stdout);
#ifdef TIOCGWINSZ
fputs (_("\
- * cols N tell the kernel that the terminal has N columns\n\
+ cols N tell the kernel that the terminal has N columns\n\
* columns N same as cols N\n\
"), stdout);
#endif
@@ -653,8 +653,8 @@ Special settings:\n\
"), stdout);
#ifdef TIOCGWINSZ
fputs (_("\
- * rows N tell the kernel that the terminal has N rows\n\
- * size print the number of rows and columns according to the kernel\n\
+ rows N tell the kernel that the terminal has N rows\n\
+ size print the number of rows and columns according to the kernel\n\
"), stdout);
#endif
fputs (_("\
--
2.47.0
