diff --git a/packages/cursorless-org-docs/src/docs/user/README.md b/packages/cursorless-org-docs/src/docs/user/README.md index 652d0d1b51..7931a84327 100644 --- a/packages/cursorless-org-docs/src/docs/user/README.md +++ b/packages/cursorless-org-docs/src/docs/user/README.md @@ -620,14 +620,19 @@ For example: - `"drink "`: Inserts a new line above the target line, and moves the cursor to the newly created line - `"pour "`: Inserts a new line below the target line, and moves the cursor to the newly created line +- `"drop "`: Inserts an empty line above the target line (without moving the cursor) +- `"float "`: Inserts an empty line below the target line (without moving the cursor) +- `"puff "`: Inserts empty lines/spaces around the target (without moving the cursor) 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 +Note: `"drink"`, `"pour"`, `"drop"`, `"float"`, and `"puff"` are actually more versatile than just handling lines. +If you use a [syntactic scope](#syntactic-scopes) modifier on the target, they 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. +eg: `puff token air` will insert spaces around the token with a hat over the letter 'a'. +eg: `float item air` will insert a comma after the item containing letter 'a' with a hat. ### Homophones