Skip to content
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.

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

Stop using “brackets” to mean “braces” #1344

Merged
merged 5 commits into from
Jan 27, 2024

Conversation

adiabatic
Copy link
Contributor

I’ve been tripped up repeatedly by how the vocabulary gives me {} when I say “brackets”. In my part of the world, at least, “brackets” are [] and “braces” are {}. “Square brackets” is a belt-and-suspenders redundancy, like “ATM machine” or “PIN number”.

For what it's worth, aegis agreed with me in Slack that there ought to be only one way to refer to these sorts of things.

I looked through old Issues and old PRs and nothing explicitly said “we choose to mean that ‘brackets’ are either curly or square depending on whether you say ‘square’ first.”

@auscompgeek
Copy link
Collaborator

FWIW, in my part of the world, brackets usually refer to parentheses (or round brackets), curly brackets refer to braces, and square brackets are, well, square.

Copy link
Member

@knausj85 knausj85 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm personally fine with this change, but I'm going to leave it open for others to poke at.

Copy link
Collaborator

@nriley nriley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for doing this — I made many of these changes years ago in my own repo.

I think adding "curly bracket" everywhere we use "brace" would make sense too (see @auscompgeek's comment). That should cover all the common names!

plugin/symbols/symbols.talon Outdated Show resolved Hide resolved
plugin/symbols/symbols.talon Outdated Show resolved Hide resolved
@adiabatic
Copy link
Contributor Author

Updated with @nriley's suggestions.

There are "squares" and "braces" in text_navigation.py, in navigation_target_names. I'm not sure what, if anything, to do with those.

@nriley
Copy link
Collaborator

nriley commented Jan 27, 2024

I think it's OK to leave text_navigation alone as at least it doesn't misuse "brackets" — I don't think it gets a lot of use (personally I keep forgetting it exists / to use it!). In an ideal world we could harmonize everything with Cursorless…

@nriley nriley merged commit 2f0a066 into talonhub:main Jan 27, 2024
2 checks passed
@adiabatic adiabatic deleted the inherently-square-brackets branch January 28, 2024 21:42
sisi-sh added a commit to sisi-sh/sisi_talon that referenced this pull request Apr 1, 2024
* 'main' of github.com:talonhub/community: (73 commits)
  add lowercased firefox-esr to firefox.py (talonhub#1410)
  configurable number prefix without mouse grid (talonhub#1342)
  Update app.exe matching to work with both public and beta Talon (talonhub#1385)
  Add comment line to javascript (talonhub#1387)
  Add detail to documentation (talonhub#1380)
  Switch to black pre-commit mirror (talonhub#1378)
  Update app_name_overrides.windows.csv to use Windows Terminal instead of iTerm2 (talonhub#1379)
  [pre-commit.ci] pre-commit autoupdate (talonhub#1376)
  coalesce some list updates (talonhub#1348)
  Remove unused setting from c code language (talonhub#1368)
  mouse: adding synonyms for starting left drag. (talonhub#1356)
  Adds commands to focus on the last application (talonhub#1336)
  Stop using “brackets” to mean “braces” (talonhub#1344)
  Update settings descriptions (talonhub#1371)
  Revert changes to `user.mouse_enable_pop_click` (talonhub#1370)
  Fix typo in `mouse.py` variable name (talonhub#1372)
  Convert boolean settings to boolean (talonhub#1360)
  Add ruby op-or-equals command (talonhub#1347)
  added app name Mate-terminal (fork of Gnome-terminal) (talonhub#1367)
  added app name Caja (fork of Nautilus) (talonhub#1366)
  ...
emragins pushed a commit to emragins/talon-community that referenced this pull request May 28, 2024
I’ve been tripped up repeatedly by how the vocabulary gives me `{}` when
I say “brackets”. In my part of the world, at least, “brackets” are `[]`
and “braces” are `{}`. “Square brackets” is a belt-and-suspenders
redundancy, like “ATM machine” or “PIN number”.

For what it's worth, aegis [agreed with me in
Slack](https://talonvoice.slack.com/archives/C7ERD5Q5T/p1703888321381209)
that there ought to be only one way to refer to these sorts of things.

I looked through [old
Issues](https://github.com/talonhub/community/issues?q=is%3Aissue+bracket)
and [old
PRs](https://github.com/talonhub/community/pulls?q=is%3Apr+bracket) and
nothing explicitly said “we choose to mean that ‘brackets’ are either
curly or square depending on whether you say ‘square’ first.”
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants