gistfile1.txt

.. _cmd-abbr:

abbr - manage fish abbreviations
================================

Synopsis
--------

``abbr`` **-a**, **--add** [*-Gu*] *WORD* *EXPANSION*

``abbr`` **-e**, **--erase** *WORD*

``abbr`` **-r**, **--rename** [*-Gu*] *OLD_WORD* *NEW_WORD*

``abbr`` **WORD** *...*

``abbr`` **-s**, **--show** | **-l**, **--list** | **-q**, **--query**

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 abbreviated to ``gco``. After entering ``gco`` and pressing :kbd:`Space` or :kbd:`Enter`, the full text ``git checkout`` will appear in the command line.

Options
-------

The following options are available:

-a EXPANSION, --add EXPANSION
                           Adds a new abbreviation, causing **WORD** to be expanded to **PHRASE**.

-r OLD NEW, --rename OLD NEW
                           Renames an abbreviation, from **OLD** to **NEW**.

-s, --show                 Show all abbreviations in a manner suitable for export and import.

-l, --list                 Lists all abbreviated words.

-e WORD, --erase WORD      Erase the abbreviation **WORD**.

-q, --query                Return 0 (true) if one of the **WORD**s is an abbreviation.

In addition, when adding abbreviations:

-g, --global                 Use a global variable.

-U, --universal              Use a universal variable (default).