You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/user/README.md
+9-9
Original file line number
Diff line number
Diff line change
@@ -351,6 +351,15 @@ If your cursor is touching a token, you can say `"take every instance"` to selec
351
351
352
352
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.
353
353
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
+
354
363
##### `"just"`
355
364
356
365
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:
378
387
- `"chuck just line"`: deletes just the content of the line, leaving a blank line.
379
388
- `"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.
380
389
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
-
390
390
##### Surrounding pair
391
391
392
392
Cursorless has support for expanding the selection to the nearest containing paired delimiter, eg the surrounding parentheses, curly brackets, etc.
0 commit comments