From: Günther Noack Date: Sun, 30 Mar 2025 14:30:39 +0000 (+0200) Subject: man/man2const/TIOCLINUX.2const: Restructure documentation for TIOCL_SETSEL selection... X-Git-Tag: man-pages-6.14~33 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b991b421e490f304dfb9c905792f7525cc61de15;p=thirdparty%2Fman-pages.git man/man2const/TIOCLINUX.2const: Restructure documentation for TIOCL_SETSEL selection modes * Indent the documented selection modes into tagged paragraphs. * Document constants from the header file instead of numbers. * Clarify expansion semantics as suggested by Jared Finder. Signed-off-by: Günther Noack Message-ID: <20250330143038.4184-4-gnoack3000@gmail.com> Acked-by: Jared Finder Signed-off-by: Alejandro Colomar --- 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