dfhack/docs/builtins/alias.rst

alias
=====
Tags: `tag/system`
:dfhack-keybind:`alias`

:index:`Configure helper aliases for other DFHack commands.
<alias; Configure helper aliases for other DFHack commands.>` Aliases are
resolved immediately after built-in commands, which means that an alias cannot
override a built-in command, but can override a command implemented by a plugin
or script.

Usage:

``alias list``
    Lists all configured aliases
``alias add <name> <command> [arguments...]``
    Adds an alias
``alias replace <name> <command> [arguments...]``
    Replaces an existing alias with a new command, or adds the alias if it does
    not already exist
``alias delete <name>``
    Removes the specified alias

Aliases can be given additional arguments when created and invoked, which will
be passed to the underlying command in order.

Example
-------

::

    [DFHack]# alias add pargs devel/print-args example
    [DFHack]# pargs text
    example
    text
move builtin docs to individual files 2022-07-18 11:58:35 -06:00			`alias`
reformat builtins and properly read tags 2022-07-20 00:01:25 -06:00			`=====`
use a label instead of a custom role since I can't seem to figure out how to inject a link to a label via the role processing code 2022-07-22 16:16:57 -06:00			Tags: `tag/system`
reformat builtins and properly read tags 2022-07-20 00:01:25 -06:00			:dfhack-keybind:`alias`
move builtin docs to individual files 2022-07-18 11:58:35 -06:00
enable index building and update builtin docs 2022-07-22 00:21:56 -06:00			:index:`Configure helper aliases for other DFHack commands.
			<alias; Configure helper aliases for other DFHack commands.>` Aliases are
			`resolved immediately after built-in commands, which means that an alias cannot`
			`override a built-in command, but can override a command implemented by a plugin`
			`or script.`
move builtin docs to individual files 2022-07-18 11:58:35 -06:00
			`Usage:`

update all docs I've done so far to new standards 2022-07-23 17:03:40 -06:00			``alias list``
spacing is important otherwise the usage and examples lists don't put the explanations on the next line 2022-07-18 12:16:05 -06:00			`Lists all configured aliases`
update all docs I've done so far to new standards 2022-07-23 17:03:40 -06:00			``alias add <name> <command> [arguments...]``
spacing is important otherwise the usage and examples lists don't put the explanations on the next line 2022-07-18 12:16:05 -06:00			`Adds an alias`
update all docs I've done so far to new standards 2022-07-23 17:03:40 -06:00			``alias replace <name> <command> [arguments...]``
spacing is important otherwise the usage and examples lists don't put the explanations on the next line 2022-07-18 12:16:05 -06:00			`Replaces an existing alias with a new command, or adds the alias if it does`
			`not already exist`
update all docs I've done so far to new standards 2022-07-23 17:03:40 -06:00			``alias delete <name>``
spacing is important otherwise the usage and examples lists don't put the explanations on the next line 2022-07-18 12:16:05 -06:00			`Removes the specified alias`
move builtin docs to individual files 2022-07-18 11:58:35 -06:00
			`Aliases can be given additional arguments when created and invoked, which will`
			`be passed to the underlying command in order.`

reformat builtins and properly read tags 2022-07-20 00:01:25 -06:00			`Example`
			`-------`

			`::`
move builtin docs to individual files 2022-07-18 11:58:35 -06:00
			`[DFHack]# alias add pargs devel/print-args example`
			`[DFHack]# pargs text`
			`example`
			`text`