Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore(version): bump, and update roadmap + changelog
- Loading branch information
Showing
5 changed files
with
18 additions
and
237 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,228 +0,0 @@ | ||
ZSH-ABBR(1) User Commands ZSH-ABBR(1) | ||
|
||
|
||
|
||
NAME | ||
zsh-abbr - manage zsh abbreviations | ||
|
||
SYNOPSIS | ||
abbr (--add | -a) [scope] [--force] <abbreviation> <expansion> | ||
|
||
abbr (--clear-session | -c) | ||
|
||
abbr (--erase | -e) [scope] <abbreviation> | ||
|
||
abbr (--expand | -x) <abbreviation> | ||
|
||
abbr (--export-aliases | -o) <scope> [<destination>] | ||
|
||
abbr --import-aliases [scope] | ||
|
||
abbr --import-fish <file> | ||
|
||
abbr --import-git-aliases | ||
|
||
abbr --list | ||
|
||
abbr (--list-abbreviations | -l) | ||
|
||
abbr (--list-commands | -L | --show | -s) | ||
|
||
abbr (--rename | -R) [scope] <old_abbreviation> <new_abbreviation> | ||
|
||
abbr (--help | -h) | ||
|
||
abbr (--version | -v) | ||
|
||
|
||
DESCRIPTION | ||
abbr manages abbreviations - user-defined words that are replaced with | ||
longer phrases after they are entered. | ||
|
||
For example, a frequently-run command like git checkout can be abbrevi- | ||
ated to gco. After entering gco and pressing [Space], the full text git | ||
checkout will appear in the command line. | ||
|
||
To prevent expansion, press [CTRL-SPACE] in place of [SPACE]. | ||
|
||
|
||
Options | ||
The following options are available: | ||
|
||
|
||
o --add abbreviation expansion or -a abbreviation expansion | ||
|
||
Adds a new abbreviation, causing abbreviation to be expanded as | ||
expansion. | ||
|
||
Will error rather than overwrite an existing abbreviation. | ||
|
||
Will warn if the abbreviation would replace an existing command. | ||
To add in spite of the warning, use [--force]. | ||
|
||
|
||
o --clear-session or -c | ||
|
||
Erases all session abbreviations. | ||
|
||
|
||
o --erase abbreviation or -e abbreviation | ||
|
||
Erases the abbreviation abbreviation . | ||
|
||
|
||
o --expand abbreviation or -x abbreviation | ||
|
||
Returns the expansion of the abbreviation abbreviation. | ||
|
||
|
||
o --export-aliases [<destination>] | ||
|
||
Exports a list of alias command for user abbreviations, suitable | ||
for pasting or piping to whereever you keep aliases. If a <des- | ||
tination> is provided, the commands will be appended to it. | ||
|
||
|
||
o --import-aliases | ||
|
||
Adds abbreviations for all aliases. | ||
|
||
|
||
o --import-fish <file> | ||
|
||
Adds abbreviations exported from fish. | ||
|
||
|
||
o --import-git-aliases | ||
|
||
Adds two abbreviations for each git alias: a regular abbrevia- | ||
tion, and a "g"-prefixed global abbreviation. | ||
|
||
|
||
o abbr --list | ||
|
||
Lists the available abbreviations without their expansions. | ||
Equivalent to fish's `abbr --list`. | ||
|
||
|
||
o --list-abbreviations or -l | ||
|
||
Lists all abbreviations. | ||
|
||
|
||
o --list-commands or -L (or --show or -s as in fish) | ||
|
||
Lists all abbreviations as commands suitable for export and | ||
import. | ||
|
||
|
||
o --rename old_abbreviation new_abbreviation or -R old_abbrevia- | ||
tion new_abbreviation | ||
|
||
Renames an abbreviation, from old_abbreviation to new_abbrevia- | ||
tion. | ||
|
||
|
||
o --version or -v | ||
|
||
Show the current version. | ||
|
||
|
||
All options except for --clear-session and --expand can take a scope: | ||
|
||
o --session or -S | ||
|
||
Abbreviations available in the current session only. | ||
|
||
|
||
o --user or -U | ||
|
||
Abbreviations available to all current and future ses- | ||
sions. | ||
|
||
|
||
All except for --clear-session, --expand, --import-fish, and --import- | ||
git-aliases can take a type: | ||
|
||
|
||
o --global or -g | ||
|
||
Abbreviation will expand anywhere on a line, rather than | ||
only in command (first word) position. | ||
|
||
|
||
o --regular or -r (default) | ||
|
||
Abbreviation will expand in command (first word) position | ||
only. | ||
|
||
|
||
All except for --clear-session, --expand, --export-aliases, --list- | ||
abbreviations, and --list-commands can be tried without making changes: | ||
|
||
|
||
o --dry-run Show whats the result of the command would be. | ||
|
||
|
||
All except for --clear-session, --expand, --export-aliases, --list- | ||
abbreviations, and --list-commands can be run with reduced output: | ||
|
||
|
||
o --quiet Do not log success, warning, or error messages. | ||
|
||
|
||
See INTERNALS for more information. | ||
|
||
|
||
EXAMPLES | ||
abbr gco="git checkout" | ||
|
||
"gco" will be expanded as "git checkout" when it is the first | ||
word in the command, in all open and future sessions. | ||
|
||
|
||
abbr -g gco="git checkout" | ||
|
||
"gco" will be replaced with "git checkout" anywhere on the line, | ||
in all open and future sessions. | ||
|
||
|
||
abbr -g -S gco="git checkout" | ||
|
||
"gco" will be replaced with "git checkout" anywhere on the line, | ||
in the current session. | ||
|
||
|
||
abbr -e -S -g gco; | ||
|
||
Erase the global session abbreviation "gco". Note that because | ||
expansion is triggered by [SPACE] and [ENTER], the semicolon (;) | ||
is necessary to prevent expansion when operating on global | ||
abbreviations. | ||
|
||
|
||
abbr -e -g gco; | ||
|
||
Erase the global user abbreviation "gco". | ||
|
||
|
||
abbr -e gco | ||
|
||
Erase the regular user abbrevation "gco". | ||
|
||
|
||
abbr -R -g gco gch | ||
|
||
Rename an existing global user abbreviation from "gco" to "gch". | ||
|
||
|
||
HISTORY | ||
Inspired by fish shell's abbr. | ||
|
||
|
||
AUTHORS | ||
Henry Bley-Vroman <olets@olets.dev> | ||
|
||
|
||
|
||
abbr 3.2.3 April 22 2020 ZSH-ABBR(1) | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters