Skip to content

Remove references to left and right in surrounding pair documentation #2626

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 4, 2024
Merged

Remove references to left and right in surrounding pair documentation #2626

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion cursorless-talon/src/modifiers/surrounding_pair.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

mod.list(
"cursorless_delimiter_force_direction",
desc="Can be used to force an ambiguous delimiter to extend in one direction",
desc="DEPRECATED: Can be used to force an ambiguous delimiter to extend in one direction",
)
# FIXME: Remove type ignore once Talon supports list types
# See https://github.com/talonvoice/talon/issues/654
Expand Down
10 changes: 0 additions & 10 deletions packages/cursorless-org-docs/src/docs/user/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -437,16 +437,6 @@ This is a "line with" a few "quotation marks" on it
opening closing opening closing
```

This heuristic works well in most cases, but when it does get tripped up, you can override its behavior. Position your cursor directly next to the delimiter (or just use the delimiter as a mark), and then prefix the name of the delimiter pair with "left" or "right" to force cursorless to expand the selection to the left or right, respectively.

For example:

- `"take left quad"` (with your cursor adjacent to a quote)
- `"take left pair green double"` (with your cursor anywhere)
- `"take inside right quad"`

If your cursor / mark is between two delimiters (not adjacent to one), then saying either "left" or "right" will cause cursorless to just expand to the nearest delimiters on either side, without trying to determine whether they are opening or closing delimiters.

##### `"its"`

The the modifier `"its"` is intended to be used as part of a compound target, and will tell Cursorless to use the previously mentioned mark in the compound target.
Expand Down
Loading