A double-click selects as acme's does: a word, a line, a bracketed or quoted text

A second B1 click at the same cell selected nothing more. Now, as acme's textdoubleclick (plan9port text.c:1407), it selects up to the match of a bracket just before or after the point, the whole line at a line's start or end, the quoted text inside ' " `, or else the word, in bodies, tags and terminals in normal mode. A plain click still puts the caret on its cell.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 14 insertions, 0 deletions

diff --git a/docs/selections.md b/docs/selections.md
index 5cc1df1a..4e26f5ab 100644
--- a/docs/selections.md
+++ b/docs/selections.md
@@ -121,3 +121,17 @@ the replay.
   line is its own haystack, so `^`/`$` hold at every line and a class like
   `\s` does not reach the newline unless the pattern names `\n`.
 - Undo restores only the primary (above).
+
+## The mouse
+
+A B1, B2 or B3 sweep selects a stream, as acme's does (libframe
+frselect.c:115): from the press to the end of its line, the lines between
+whole, the last from its start to the release, the character under the
+pointer included. A plain B1 click puts the caret on its cell. A second
+plain click at the same cell within half a second is acme's double-click
+(plan9port acme text.c:1407, textdoubleclick): just after `{ [ ( < «` or
+just before their closers it selects up to the match, nested pairs
+counted; at a line's start or end the whole line; just inside `' " \``
+the quoted text; anywhere else the word (letters, digits, `_` and any
+non-ASCII character). It works in bodies, tags and a terminal in normal
+mode; a terminal whose program has the tty gets its own clicks.