symbols

The community/plugin/symbols directory contains Talon files related to inserting and wrapping text with various symbols.

The file symbols_deprecated.talon defines a series of deprecated commands for inserting matched delimiters or wrapping a selection in delimiters. For example, the command empty string inserts two single quotes with the cursor between them and quote that wraps the selected text with single quotes. These commands are deprecated and should not be used. They use the user.deprecate_command command with the date "2024-11-24".

The file symbols.talon defines commands for inserting common symbols, like new line or arrow, and implements the user.delimiter_pair_insert and user.delimiter_pair_wrap_selection actions. These actions are then bound to the user.delimiter_pair grammar. For example, (parens | args) is bound to the "()" string, and when spoken with the that suffix will call the user.delimiter_pair_wrap_selection action and wrap the selection with parentheses. When spoken without the suffix it will call the user.delimiter_pair_insert action and insert two parentheses with the cursor between them. This file implements the preferred way to insert or wrap text with delimiters.