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']} <modifier>",
@@ -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']} <modifier>",
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 <modifier>",
@@ -810,7 +810,7 @@
           "variations": [
             {
               "spokenForm": "head",
-              "description": "Extend through start of line"
+              "description": "Extend through start of line/pair"
             },
             {
               "spokenForm": "head <modifier>",
diff --git a/packages/cursorless-org-docs/src/docs/user/README.md b/packages/cursorless-org-docs/src/docs/user/README.md
index f956d0722e..fbf667ee25 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 (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:
 
 - `"take head funk"`: select from the cursor the start of the containing function