From: Oleg Broytman <phd@phdru.name>
Date: Fri, 28 Apr 2017 13:07:51 +0000 (+0300)
Subject: Explain recursive aliases
X-Git-Url: https://git.phdru.name/?p=git-wiki.git;a=commitdiff_plain;h=08ff71dcde3af9361d87583c8de78f72737b0bee

Explain recursive aliases
---

diff --git a/git-wiki.txt b/git-wiki.txt
index 57ba284..c1a831a 100644
--- a/git-wiki.txt
+++ b/git-wiki.txt
@@ -756,6 +756,29 @@ See `WhatIsTheIndex
 Wiki.
 
 
+Aliases
+-------
+
+Recursive aliases
+'''''''''''''''''
+
+Git doesn't allow recursive aliases. The expansion of an alias is
+interpreted by git as a builtin command. I.e., in the following example
+alias ``com`` doesn't work because there is no builtin command ``git
+ci``::
+
+    [alias]
+    ci = commit
+    com = ci
+
+You can trick git by using shell. The following example works albeit a
+bit slow::
+
+    [alias]
+    ci = commit
+    com = !git ci
+
+
 Root
 ----