From e53928d59dc3c636a2e306eff1ddad304802f7cd Mon Sep 17 00:00:00 2001 From: Andreas Arvidsson Date: Sat, 9 Nov 2024 12:25:22 +0100 Subject: [PATCH 1/3] Update head/tail docs with regards to surrounding pairs --- packages/cursorless-org-docs/src/docs/user/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/packages/cursorless-org-docs/src/docs/user/README.md b/packages/cursorless-org-docs/src/docs/user/README.md index f956d0722e..4ccf841121 100644 --- a/packages/cursorless-org-docs/src/docs/user/README.md +++ b/packages/cursorless-org-docs/src/docs/user/README.md @@ -310,6 +310,8 @@ The modifiers `"head"` and `"tail"` can be used to expand a target through the b - `"take head air"`: selects the mark through to start of the line - `"take tail air"`: selects the mark through to the end of the line +When inside a single line surrounding pair(parentheses, brackets, etc) the head/tail modifier will only expand to the interior of that pair instead of the whole line. You can explicitly say `"head line"` or `"tail line"` to get the line behavior. + When followed by a modifier, they will expand their input to the start or end of the given modifier range. For example: - `"take head funk"`: select from the cursor the start of the containing function From 47b16b8e854537720781d2b27dc5d002ab2a4ceb Mon Sep 17 00:00:00 2001 From: Andreas Arvidsson Date: Sat, 9 Nov 2024 12:28:13 +0100 Subject: [PATCH 2/3] Update cheat sheet --- cursorless-talon/src/cheatsheet/sections/modifiers.py | 4 ++-- .../cheatsheet/src/lib/sampleSpokenFormInfos/defaults.json | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/cursorless-talon/src/cheatsheet/sections/modifiers.py b/cursorless-talon/src/cheatsheet/sections/modifiers.py index af8164d312..406e3acbbc 100644 --- a/cursorless-talon/src/cheatsheet/sections/modifiers.py +++ b/cursorless-talon/src/cheatsheet/sections/modifiers.py @@ -64,7 +64,7 @@ def get_modifiers(): "variations": [ { "spokenForm": complex_modifiers["extendThroughStartOf"], - "description": "Extend through start of line", + "description": "Extend through start of line/pair", }, { "spokenForm": f"{complex_modifiers['extendThroughStartOf']} ", @@ -78,7 +78,7 @@ def get_modifiers(): "variations": [ { "spokenForm": complex_modifiers["extendThroughEndOf"], - "description": "Extend through end of line", + "description": "Extend through end of line/pair", }, { "spokenForm": f"{complex_modifiers['extendThroughEndOf']} ", diff --git a/packages/cheatsheet/src/lib/sampleSpokenFormInfos/defaults.json b/packages/cheatsheet/src/lib/sampleSpokenFormInfos/defaults.json index bbce939c6f..28e3ea93b1 100644 --- a/packages/cheatsheet/src/lib/sampleSpokenFormInfos/defaults.json +++ b/packages/cheatsheet/src/lib/sampleSpokenFormInfos/defaults.json @@ -796,7 +796,7 @@ "variations": [ { "spokenForm": "tail", - "description": "Extend through end of line" + "description": "Extend through end of line/pair" }, { "spokenForm": "tail ", @@ -810,7 +810,7 @@ "variations": [ { "spokenForm": "head", - "description": "Extend through start of line" + "description": "Extend through start of line/pair" }, { "spokenForm": "head ", From 94214a098a4811d3d3080a1cbe28f2f4c9934b2d Mon Sep 17 00:00:00 2001 From: Pokey Rule <755842+pokey@users.noreply.github.com> Date: Sat, 9 Nov 2024 20:57:16 +0000 Subject: [PATCH 3/3] Update README.md --- packages/cursorless-org-docs/src/docs/user/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/cursorless-org-docs/src/docs/user/README.md b/packages/cursorless-org-docs/src/docs/user/README.md index 4ccf841121..fbf667ee25 100644 --- a/packages/cursorless-org-docs/src/docs/user/README.md +++ b/packages/cursorless-org-docs/src/docs/user/README.md @@ -310,7 +310,7 @@ The modifiers `"head"` and `"tail"` can be used to expand a target through the b - `"take head air"`: selects the mark through to start of the line - `"take tail air"`: selects the mark through to the end of the line -When inside a single line surrounding pair(parentheses, brackets, etc) the head/tail modifier will only expand to the interior of that pair instead of the whole line. You can explicitly say `"head line"` or `"tail line"` to get the line behavior. +When inside a single-line surrounding pair (eg parentheses, brackets, etc) the head/tail modifier will only expand to the interior of that pair instead of the whole line. You can explicitly say `"head line"` or `"tail line"` to get the line behavior. When followed by a modifier, they will expand their input to the start or end of the given modifier range. For example: