[git/git.git] / Documentation / config / alias.txt
1 alias.*::
2 Command aliases for the linkgit:git[1] command wrapper - e.g.
3 after defining "alias.last = cat-file commit HEAD", the invocation
4 "git last" is equivalent to "git cat-file commit HEAD". To avoid
5 confusion and troubles with script usage, aliases that
6 hide existing Git commands are ignored. Arguments are split by
7 spaces, the usual shell quoting and escaping is supported.
8 A quote pair or a backslash can be used to quote them.
9 +
10 If the alias expansion is prefixed with an exclamation point,
11 it will be treated as a shell command. For example, defining
12 "alias.new = !gitk --all --not ORIG_HEAD", the invocation
13 "git new" is equivalent to running the shell command
14 "gitk --all --not ORIG_HEAD". Note that shell commands will be
15 executed from the top-level directory of a repository, which may
16 not necessarily be the current directory.
17 `GIT_PREFIX` is set as returned by running 'git rev-parse --show-prefix'
18 from the original current directory. See linkgit:git-rev-parse[1].