1 files changed, 63 insertions, 0 deletions
diff --git a/doc/en/user-guide/using_aliases.txt b/doc/en/user-guide/using_aliases.txt
new file mode 100644
index 0000000..7afd005
--- /dev/null
+++ b/doc/en/user-guide/using_aliases.txt
@@ -0,0 +1,63 @@
+Using aliases
+=============
+
+What are aliases?
+-----------------
+
+Aliases are an easy way to create shortcuts for commonly-typed commands, or to set
+defaults for commands.
+
+Defining aliases
+----------------
+
+Command aliases can be defined in the ``[ALIASES]`` section of your
+``bazaar.conf`` file. Aliases start with the alias name, then an
+equal sign, then a command fragment.  Here's an example ALIASES section::
+
+    [ALIASES]
+    recentlog=log -r-3..-1
+    ll=log --line -r-10..-1
+    commit=commit --strict
+    diff=diff --diff-options -p
+
+Here are the explanations of the examples above:
+
+ * The first alias makes a new ``recentlog`` command that shows the logs for the
+   last three revisions
+ * The ``ll`` alias shows the last 10 log entries in line format.
+ * the ``commit`` alias sets the default for commit to refuse to commit if new
+   files in the tree are not recognized.
+ * the ``diff`` alias adds the coveted -p option to diff
+
+Using the aliases
+-----------------
+
+The aliases defined above would be used like so: ::
+
+   % bzr recentlog
+   % bzr ll
+   % bzr commit
+   % bzr diff
+
+Rules for aliases
+-----------------
+
+ * You can override a portion of the options given in an alias by
+   specifying the new part on the command-line.  For example, if
+   you run ``lastlog -r-5..``, you will only get five line-based log
+   entries instead of 10.  Note that all boolean options have an
+   implicit inverse, so you can override the commit alias with
+   ``commit --no-strict``.
+
+ * Aliases can override the standard behaviour of existing commands by giving
+   an alias name that is the same as the original command. For example, default
+   commit is changed with ``commit=commit --strict``.
+
+ * Aliases cannot refer to other aliases. In other words making a
+   ``lastlog`` alias and referring to it with a ``ll`` alias will not work.
+   This includes aliases that override standard commands.
+
+ * Giving the ``--no-aliases`` option to the bzr command will tell it to ignore aliases
+   for that run. For example, running ``bzr --no-aliases commit`` will perform a
+   standard commit instead, not do a ``commit --strict``.
+