From: "Günther Noack" <gnoack3000@gmail.com>
To: Alexjandro Colomar <alx@kernel.org>
Cc: linux-man@vger.kernel.org, "Günther Noack" <gnoack3000@gmail.com>,
"Jared Finder" <jared@finder.org>, "Hanno Böck" <hanno@hboeck.de>
Subject: [PATCH man v3 1/2] TIOCLINUX.2const: Restructure documentation for TIOCL_SETSEL selection modes
Date: Sun, 2 Mar 2025 20:43:33 +0100 [thread overview]
Message-ID: <20250302194331.5135-5-gnoack3000@gmail.com> (raw)
In-Reply-To: <20250302194331.5135-3-gnoack3000@gmail.com>
* Indent the documented selection modes into tagged paragraphs.
* Document constants from the header file (tiocl.h) instead of numbers.
* Clarify expansion semantics as suggested by Jared Finder.
Signed-off-by: Günther Noack <gnoack3000@gmail.com>
---
man/man2const/TIOCLINUX.2const | 25 ++++++++++++++++++++-----
1 file changed, 20 insertions(+), 5 deletions(-)
diff --git a/man/man2const/TIOCLINUX.2const b/man/man2const/TIOCLINUX.2const
index c0acdd0ea..f2c8d0720 100644
--- a/man/man2const/TIOCLINUX.2const
+++ b/man/man2const/TIOCLINUX.2const
@@ -65,11 +65,26 @@ are the ending
column and row.
(Upper left corner is row=column=1.)
.I sel_mode
-is 0 for character-by-character selection,
-1 for word-by-word selection,
-or 2 for line-by-line selection.
-The indicated screen characters are highlighted and saved
-in a kernel buffer.
+may be one of the following operations:
+.RS
+.TP
+.B TIOCL_SELCHAR
+Select character-by-character.
+The indicated screen characters are highlighted
+and saved in a kernel buffer.
+.TP
+.B TIOCL_SELWORD
+Select word-by-word,
+expanding the selection outwards to align with word boundaries.
+The indicated screen characters are highlighted
+and saved in a kernel buffer.
+.TP
+.B TIOCL_SELLINE
+Select line-by-line,
+expanding the selection outwards to select full lines.
+The indicated screen characters are highlighted
+and saved in a kernel buffer.
+.RE
.IP
Since Linux 6.7, using this subcode requires the
.B CAP_SYS_ADMIN
--
2.48.1
next prev parent reply other threads:[~2025-03-02 19:43 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-03-02 19:43 [PATCH man v3 0/2] TIOCLINUX.2const: Document TIOCL_SETSEL selection modes Günther Noack
2025-03-02 19:43 ` Günther Noack [this message]
2025-03-02 22:50 ` [PATCH man v3 1/2] TIOCLINUX.2const: Restructure documentation for " Jared Finder
2025-03-03 8:26 ` Alejandro Colomar
2025-03-02 19:43 ` [PATCH man v3 2/2] TIOCLINUX.2const: Document missing " Günther Noack
2025-03-02 22:49 ` Jared Finder
2025-03-17 13:23 ` [PATCH man v3 0/2] TIOCLINUX.2const: Document " Alejandro Colomar
2025-03-17 17:43 ` G. Branden Robinson
2025-03-22 19:37 ` Alejandro Colomar
2025-03-26 4:48 ` Jared Finder
2025-03-26 8:58 ` Alejandro Colomar
2025-03-30 10:58 ` Günther Noack
2025-03-30 11:07 ` Alejandro Colomar
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250302194331.5135-5-gnoack3000@gmail.com \
--to=gnoack3000@gmail.com \
--cc=alx@kernel.org \
--cc=hanno@hboeck.de \
--cc=jared@finder.org \
--cc=linux-man@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.