aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2023-09-19 14:23:34 +0000
committerDaniel Eklöf <daniel@ekloef.se>2023-09-19 14:23:34 +0000
commit1719ff93a75ad886ed53be468f7faa12f530e9f3 (patch)
tree6a6fe43ae0515a7a9f2ce51dcc62ca3788dc33f1 /doc
parentinput: make wheel events mappable (diff)
selection: add support for selecting the contents of a quote
This patch changes the default of triple clicking, from selecting the current logical row, to first trying to select the contents of the quote under the cursor, and if failing to find a quote, selecting the current row (like before). This is implemented by adding a new key binding, 'select-quote'. It will search for surrounding quote characters, and if one is found on each side of the cursor, the quote is selected. If not, the entire row is selected instead. Subsequent selection operations will behave as if the selection is either a word selection (a quote was found), or a row selection (no quote found). Escaped quote characters are not supported: "foo \" bar" will match 'foo \', and not 'foo " bar'. Mismatched quotes are not custom handled. They will simply not match. Nested quotes ("123 'abc def' 456") are supported. Closes #1364
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd29
1 files changed, 28 insertions, 1 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 085dd82f..6a11d38d 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -1101,10 +1101,37 @@ actions listed under *key-bindings* can be used here as well.
selection_, when the button is released. Default:
_Control+BTN\_LEFT-2_.
+*select-quote*
+ Begin an interactive "quote" selection. This is similar to
+ *select-word*, except an entire quote is selected (that is,
+ everything inside the quote, excluding the quote
+ characters). Recognized quote characters are: *"* and *'*.
+
+ If a complete quote cannot be found on the current logical row
+ (only one quote character, or none are found), the entire row is
+ selected.
+
+ The selection is finalized, and copied to the _primary selection_,
+ when the button is released.
+
+ After the initial selection has been made, it behaves like a
+ normal word, or row selection, depending on whether a quote was
+ found or not. This affects what happens when, for example,
+ extending the selection.
+
+ Notes:
+ - Escaped quote characters are not supported (*"foo \\"bar"* will
+ match *'foo \\'*, not *'foo "bar'*).
+ - Foot does not try to handle mismatched quote characters; they
+ will simply not match.
+ - Nested quotes (using different quote characters) are supported.
+
+ Default: _BTN\_LEFT-3_.
+
*select-row*
Begin an interactive row-wise selection. The selection is
finalized, and copied to the _primary selection_, when the button
- is released. Default: _BTN\_LEFT-3_.
+ is released. Default: _BTN\_LEFT-4_.
*select-extend*
Interactively extend an existing selection, using the original