[PATCH v4 0/2] TIOCLINUX.2const: Document TIOCL_SETSEL selection modes

["Günther Noack" <gnoack3000@gmail.com>]

Hi!

TIOCLINUX's TIOCL_SETSEL sub-code has another layer of sub-operations,
called "selection modes" (even though not all of them actually deal
with the mouse selection).

Going forward, the CAP_SYS_ADMIN requirement will be different for
some of these selection modes, which prompted me to at least list the
different selection modes with a short description.  I am leaving
CAP_SYS_ADMIN documentation as it is for now and will send another
patch once these semantics are finalized [1] [2].

Thanks,
–Günther

[1] <https://lore.kernel.org/all/20250221.0a947528d8f3@gnoack.org/>
[2] <https://lore.kernel.org/all/20250223205449.7432-2-gnoack3000@gmail.com/>

History:

V2:
 * Split into a "restructuring" and a "new documentation" commit
 * Use non-breaking space \~
 * Put URIs in <>
 * Added a helpful link to console_codes(4) regarding mouse reporting

V3:
 * Corrections and clarifications for various selection modes
   as suggested by Jared Finder. (Thanks!)

V4:
 * Clarified how TIOCL_SELPOINTER selects the coordinate to use

Günther Noack (2):
  TIOCLINUX.2const: Restructure documentation for TIOCL_SETSEL selection
    modes
  TIOCLINUX.2const: Document missing TIOCL_SETSEL selection modes

 man/man2const/TIOCLINUX.2const | 59 +++++++++++++++++++++++++++++++---
 1 file changed, 54 insertions(+), 5 deletions(-)

Range-diff against v3:
1:  d07edb528 = 1:  828c5189a TIOCLINUX.2const: Restructure documentation for TIOCL_SETSEL selection modes
2:  59f217fb0 ! 2:  bffc3e550 TIOCLINUX.2const: Document missing TIOCL_SETSEL selection modes
    @@ man/man2const/TIOCLINUX.2const: Select line-by-line,
     +.RI ( xs ,\~ ys )
     +or
     +.RI ( xe ,\~ ye ),
    -+whichever is greater.
    ++whichever is later in text flow order.
     +.TP
     +.B TIOCL_SELCLEAR
     +Remove the current selection highlight, if any,
-- 
2.49.0