doc "drink" and "pour" can do more than lines (#1772)

fix #1766

---------

Co-authored-by: Jacob Egner <[email protected]>

Author: jmegner

cursorless-talon/src/cheatsheet/sections/actions.py

@@ -35,6 +35,8 @@ def get_actions():
             simple_actions,
             {
                 "callAsFunction": "Call <target> on selection",
+                "editNewLineAfter": "Edit new line/scope after",
+                "editNewLineBefore": "Edit new line/scope before",
             },
         ),
         {

docs/user/README.md

@@ -579,9 +579,13 @@ For example:
 - `"drink <TARGET>"`: Inserts a new line above the target line, and moves the cursor to the newly created line
 - `"pour <TARGET>"`: Inserts a new line below the target line, and moves the cursor to the newly created line
 
-eg:
-`pour blue air`
-Insert empty line below the token containing letter 'a' with a blue hat.
+eg: `pour blue air` will insert empty line below the token containing letter 'a' with a blue hat and moves the cursor to the new line.
+
+Note: `"drink"` and `"pour"` are actually a bit more versatile than just lines.
+If you use a [syntactic scope](#syntactic-scopes) modifier on the target, then`"drink"` and `"pour"` will do the
+appropriate insertions to prepare the text for a new instance of that scope.
+
+eg: `pour item air` will insert a comma and space after the air item, and place the cursor after the inserted characters.
 
 ### Homophones
 

packages/cheatsheet/src/lib/sampleSpokenFormInfos/defaults.json

@@ -70,7 +70,7 @@
           "variations": [
             {
               "spokenForm": "pour <target>",
-              "description": "Edit new line after"
+              "description": "Edit new line/scope after"
             }
           ]
         },
@@ -80,7 +80,7 @@
           "variations": [
             {
               "spokenForm": "drink <target>",
-              "description": "Edit new line before"
+              "description": "Edit new line/scope before"
             }
           ]
         },