From 8081e9f18900fd25436831f90f70dd3fd0c04523 Mon Sep 17 00:00:00 2001 From: Fabian Homborg Date: Sat, 16 Jan 2016 14:49:57 +0100 Subject: [PATCH] Document that abbrs should be added once While abbrs are still stored in a universal variable, it's much quicker to just add them once and not just put `abbr --add key value` in config.fish. --- doc_src/abbr.txt | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/doc_src/abbr.txt b/doc_src/abbr.txt index a32592d88..799e50032 100644 --- a/doc_src/abbr.txt +++ b/doc_src/abbr.txt @@ -14,7 +14,15 @@ abbr -e word Abbreviations are user-defined character sequences or words that are replaced with longer phrases after they are entered. For example, a frequently-run command such as `git checkout` can be abbreviated to `gco`. After entering `gco` and pressing @key{Space} or @key{Enter}, the full text `git checkout` will appear in the command line. -Abbreviations are stored, by default, in a universal variable. +Abbreviations are stored using universal variables. You can create abbreviations directly on the command line, and they will be saved automatically. Do not place them in config.fish, because this will lead to worse startup performance. Alternatively, guard the assignment with another universal variable, like: + +\fish +if not set -q my_fish_abbreviations + abbr gco='git checkout' + abbr abr='another abbreviation expansion' + set -U my_fish_abbreviations 1 +end +\endfish The following parameters are available: