Skip to content

Commit 7369cea

Browse files
authored
Fix "from" section in docs (#1906)
It got orphaned from its parent in a recent commit ## Checklist - [ ] I have added [tests](https://www.cursorless.org/docs/contributing/test-case-recorder/) - [ ] I have updated the [docs](https://github.com/cursorless-dev/cursorless/tree/main/docs) and [cheatsheet](https://github.com/cursorless-dev/cursorless/tree/main/cursorless-talon/src/cheatsheet) - [ ] I have not broken the cheatsheet
1 parent 3eb7f1b commit 7369cea

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

docs/user/README.md

+9-9
Original file line numberDiff line numberDiff line change
@@ -351,6 +351,15 @@ If your cursor is touching a token, you can say `"take every instance"` to selec
351351

352352
Pro tip: if you say eg `"take five instances air"`, and it turns out you need more, you can say eg `"take that and next two instances that"` to select the next two instances after the last instance you selected.
353353

354+
###### Experimental: `"from"`
355+
356+
We have experimental support for prefixing a command with `"from <target>"` to narrow the range within which `"every instance"` searches, or to set the start point from which `"next instance"` searches. For example:
357+
358+
- `"from funk take every instance air"`: selects all instances of the token with a hat over the letter `a` in the current function
359+
- `"from air take next instance bat"`: selects the next instance of the token with a hat over the letter `b` starting from the token with a hat over the letter `a`
360+
361+
Note that the `"from"` modifier is not enabled by default; you must remove the `-` at the start of the line starting with `-from` in your `experimental/experimental_actions.csv` [settings csv](./customization.md). Note also that this feature is considered experimental and may change in the future.
362+
354363
##### `"just"`
355364

356365
The `"just"` modifier strips the target of any semantic information, treating it as just a raw range, with the following effects:
@@ -378,15 +387,6 @@ Some examples:
378387
- `"chuck just line"`: deletes just the content of the line, leaving a blank line.
379388
- `"bring bat after just air"`: results in something like `aaabbb` where the bat token was copied after the air token with no delimeter between them.
380389
381-
###### Experimental: `"from"`
382-
383-
We have experimental support for prefixing a command with `"from <target>"` to narrow the range within which `"every instance"` searches, or to set the start point from which `"next instance"` searches. For example:
384-
385-
- `"from funk take every instance air"`: selects all instances of the token with a hat over the letter `a` in the current function
386-
- `"from air take next instance bat"`: selects the next instance of the token with a hat over the letter `b` starting from the token with a hat over the letter `a`
387-
388-
Note that the `"from"` modifier is not enabled by default; you must remove the `-` at the start of the line starting with `-from` in your `experimental/experimental_actions.csv` [settings csv](./customization.md). Note also that this feature is considered experimental and may change in the future.
389-
390390
##### Surrounding pair
391391
392392
Cursorless has support for expanding the selection to the nearest containing paired delimiter, eg the surrounding parentheses, curly brackets, etc.

0 commit comments

Comments
 (0)