Skip to content

Commit 128933a

Browse files
authored
knausj => community (#1914)
Also tweaked unicode docs slightly while I was there ## 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 be61609 commit 128933a

File tree

8 files changed

+16
-16
lines changed

8 files changed

+16
-16
lines changed

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@ There's too much new stuff in this release to fit in a highlights reel, so we'll
139139
- Improve and unify selection updating behaviour to handle overlapping ranges [\#138](https://github.com/cursorless-dev/cursorless/issues/138)
140140
- Duplicate symbols after VS Code update [\#111](https://github.com/cursorless-dev/cursorless/issues/111)
141141
- Fold action not working properly with multiple list elements [\#39](https://github.com/cursorless-dev/cursorless/issues/39)
142-
- The `clear` command clashes with Knausj commands [\#68](https://github.com/pokey/cursorless-talon/issues/68)
142+
- The `clear` command clashes with community commands [\#68](https://github.com/pokey/cursorless-talon/issues/68)
143143

144144
**Closed issues:**
145145

docs/contributing/architecture/hat-snapshots.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
In order to allow long chained command phrases, we take a snapshot of the hat token map at the start of a phrase and continue to use this map during the course of the entire phrase. This way you can be sure that any commands issued during the course of a single phrase that refer to a decorated token will continue to refer to the same logical token no matter what happens in the document during phrase execution. Note that the ranges of tokens will be kept current as the document changes so that they refer to the same logical range, but the same logical token will keep the same key in the hat token map over the course of a phrase.
44

5-
To make this work, first the voice engine [touches](https://github.com/knausj85/knausj_talon/blob/e373780af16256ab8fd5638af32d97fa23c4c0fc/apps/vscode/command_client/command_client.py#L398) a file within the signals subdirectory of the command server communication directory after the phrase has been parsed but right before execution begins. Then cursorless will check the version of the signal file before it [reads](https://github.com/cursorless-dev/cursorless/blob/2a624888369d41b0531e472d001d63d09912c8aa/src/core/HatTokenMap.ts#L88) or [updates](https://github.com/cursorless-dev/cursorless/blob/0d1004bafc6764734bee62afbfbb02500630a264/src/core/HatTokenMap.ts#L70) the hat token map via the command server [signal API](https://github.com/pokey/command-server/blob/2b9f9ea2a38b6e95aa60ff9553a804165e527308/src/extension.ts#L29). If the signal has been emitted since the last time cursorless took a snapshot of the hat token map, it will take a new snapshot and continue to use that snapshot of the hats until the next time the signal is emitted. Note that the signal transmission is asynchronous so cursorless just needs to make sure to check the version of the signal before it either updates or reads the map.
5+
To make this work, first the voice engine [touches](https://github.com/talonhub/community/blob/e373780af16256ab8fd5638af32d97fa23c4c0fc/apps/vscode/command_client/command_client.py#L398) a file within the signals subdirectory of the command server communication directory after the phrase has been parsed but right before execution begins. Then cursorless will check the version of the signal file before it [reads](https://github.com/cursorless-dev/cursorless/blob/2a624888369d41b0531e472d001d63d09912c8aa/src/core/HatTokenMap.ts#L88) or [updates](https://github.com/cursorless-dev/cursorless/blob/0d1004bafc6764734bee62afbfbb02500630a264/src/core/HatTokenMap.ts#L70) the hat token map via the command server [signal API](https://github.com/pokey/command-server/blob/2b9f9ea2a38b6e95aa60ff9553a804165e527308/src/extension.ts#L29). If the signal has been emitted since the last time cursorless took a snapshot of the hat token map, it will take a new snapshot and continue to use that snapshot of the hats until the next time the signal is emitted. Note that the signal transmission is asynchronous so cursorless just needs to make sure to check the version of the signal before it either updates or reads the map.
66

77
In the diagram below, we document the flow of a couple different cases. Dotted lines represent asynchronous / fire-and-forget communication:
88

docs/user/experimental/snippets.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ Note that each snippet can use `insertionScopeTypes` to indicate that it will au
9292

9393
As usual, the spoken forms for these snippets can be [customized by csv](../customization.md). The csvs are in the files in `cursorless-settings/experimental` with `snippet` in their name.
9494

95-
In addition, you can change the term `"snippet"` (for snippet insertion) using actions.csv. Keep in mind that if you change it to `"snip"`, you may want to turn off the built-in knausj `"snip"` commands to avoid conflicts.
95+
In addition, you can change the term `"snippet"` (for snippet insertion) using actions.csv. Keep in mind that if you change it to `"snip"`, you may want to turn off the built-in community `"snip"` commands to avoid conflicts.
9696

9797
## Adding your own snippets
9898

docs/user/installation.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Installation
22

33
1. Install [Talon](https://talonvoice.com/)
4-
2. Install [knausj_talon](https://github.com/knausj85/knausj_talon).
5-
_(Or see [here](https://github.com/cursorless-dev/cursorless/wiki/Talon-home-requirements) if you prefer not to use knausj.)_
4+
2. Install the [community Talon commands](https://github.com/talonhub/community).
5+
_(Or see [here](https://github.com/cursorless-dev/cursorless/wiki/Talon-home-requirements) if you prefer not to use community.)_
66
3. Install [VSCode](https://code.visualstudio.com/)
77
4. Install the [VSCode talon extension pack](https://marketplace.visualstudio.com/items?itemName=pokey.talon)
88
5. Install the [Cursorless VSCode extension](https://marketplace.visualstudio.com/items?itemName=pokey.cursorless)
@@ -25,9 +25,9 @@ Alternatively, access the directory by right clicking the Talon icon in taskbar,
2525
The folder structure should look something like the below:
2626

2727
```insert code:
28-
~/.talon/user/knausj_talon
29-
~/.talon/user/knausj_talon/apps
30-
~/.talon/user/knausj_talon/code
28+
~/.talon/user/community
29+
~/.talon/user/community/apps
30+
~/.talon/user/community/code
3131
...
3232
~/.talon/user/cursorless-talon
3333
~/.talon/user/cursorless-talon/src
@@ -50,9 +50,9 @@ Alternatively, access the directory by right clicking the Talon icon in taskbar,
5050
The folder structure should look something like the below:
5151

5252
```insert code:
53-
%AppData%\Talon\user\knausj_talon
54-
%AppData%\Talon\user\knausj_talon\apps
55-
%AppData%\Talon\user\knausj_talon\code
53+
%AppData%\Talon\user\community
54+
%AppData%\Talon\user\community\apps
55+
%AppData%\Talon\user\community\code
5656
...
5757
%AppData%\Talon\user\cursorless-talon
5858
%AppData%\Talon\user\cursorless-talon\src

docs/user/unicode.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,11 @@ Cursorless has first-class support for Unicode. By default, when constructing ha
77
- Africa
88
- África
99

10-
For Unicode symbols that are not letters, and that are not speakable in knausj, for example emoji, Chinese characters, etc, we have a special "character" called `"special"` that can be used. So for example, if there were a blue hat over a '😄' character, you could say `"take blue special"` to select it. As always, the spoken form `"special"` can be [customized](customization.md).
10+
For Unicode symbols that are not letters, and that are not speakable by default, for example emoji, Chinese characters, etc, we have a special "character" called `"special"` that can be used. So for example, if there were a blue hat over a '😄' character, you could say `"take blue special"` to select it. As always, the spoken form `"special"` can be [customized](customization.md).
1111

1212
## Advanced customization
1313

14-
The above setup will allow you to refer to any Unicode token. However, if you have overridden your `<user.any_alphanumeric_key>` capture to contain characters other than lowercase letters and the default knausj symbols, you can tell Cursorless to be less aggressive with its normalization, so that it can allocate hats more efficiently.
14+
The above setup will allow you to refer to any Unicode token, and is sufficient for most users. However, if you have overridden your `<user.any_alphanumeric_key>` capture to contain characters other than lowercase letters and the default symbols, you can tell Cursorless to be less aggressive with its normalization, so that it can allocate hats more efficiently. Note that this is not necessary in order to refer to these tokens; it just makes hat allocation slightly more efficient.
1515

1616
### Preserving case
1717

packages/common/src/cursorlessCommandIds.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ export const cursorlessCommandDescriptions: Record<
7878
"Display the cursorless cheatsheet",
7979
),
8080
["cursorless.internal.updateCheatsheetDefaults"]: new HiddenCommand(
81-
"Update the default values of the cheatsheet payload used on the website and for local development. Be sure to run this on stock knausj and cursorless.",
81+
"Update the default values of the cheatsheet payload used on the website and for local development. Be sure to run this on stock community and cursorless.",
8282
),
8383
["cursorless.takeSnapshot"]: new HiddenCommand(
8484
"Take a snapshot of the current editor state",

packages/cursorless-engine/src/tokenGraphemeSplitter/tokenGraphemeSplitter.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ import {
88
import { matchAll } from "../util/regex";
99

1010
/**
11-
* A list of all symbols that are speakable by default in knausj.
11+
* A list of all symbols that are speakable by default in community.
1212
*/
1313
const KNOWN_SYMBOLS = [
1414
"!",

packages/cursorless-vscode/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@
123123
},
124124
{
125125
"command": "cursorless.internal.updateCheatsheetDefaults",
126-
"title": "Cursorless: Update the default values of the cheatsheet payload used on the website and for local development. Be sure to run this on stock knausj and cursorless.",
126+
"title": "Cursorless: Update the default values of the cheatsheet payload used on the website and for local development. Be sure to run this on stock community and cursorless.",
127127
"enablement": "false"
128128
},
129129
{

0 commit comments

Comments
 (0)