Skip to content

TIOCLINUX.2const: Document TIOCL_SETSEL selection modes

Günther Noack linux-man 4 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v4 Latest2 patches 1 replyIn review
  2. v32 patches 10 repliesSuperseded
  3. v22 patches 6 repliesSuperseded
Earlier versions · 1
VersionPostedPatchesRepliesStatus
v11 patch3 repliesSuperseded

Changes in v4 from the cover letter

* Clarified how TIOCL_SELPOINTER selects the coordinate to use

Patches in v4 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/2TIOCLINUX.2const: Restructure documentation for TIOCL_SETSEL selection modesman/man2const/TIOCLINUX.2const+20 -50 replies
2/2TIOCLINUX.2const: Document missing TIOCL_SETSEL selection modesman/man2const/TIOCLINUX.2const+34 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v4 yet.

Read the v4 thread

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

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/[email protected]/>
[2] <https://lore.kernel.org/all/[email protected]/>

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,

Signature · 1 line
2.49.0