6
6
are an easy way to create shortcuts for commonly-typed commands, or to set
7
7
defaults for commands.
9
Command aliases can be defined in the ``[ALIASES]`` section of your
10
``.bazaar/bazaar.conf`` file. Aliases start with the alias name, then an
9
Command aliases can be defined in the **[ALIASES]** section of your
10
**.bazaar/bazaar.conf** file. Aliases start with the alias name, then an
11
11
equal sign, then a command fragment. Here's an example ALIASES section:
23
23
Explanation of examples
24
24
=======================
26
* The first alias makes a new ``recentlog`` command that shows the logs for the
26
* The first alias makes a new 'recentlog' command that shows the logs for the
27
27
last three revisions
28
* The ``ll`` alias shows the last 10 log entries in line format.
29
* the ``commit`` alias sets the default for commit to refuse to commit if new
28
* The **ll** alias shows the last 10 log entries in line format.
29
* the **commit** alias sets the default for commit to refuse to commit if new
30
30
files in the tree are not recognized.
31
* the ``diff`` alias adds the coveted -p option to diff
35
The aliases defined above would be used like so: ::
31
* the **diff** alias adds the coveted -p option to diff
45
* You can override a portion of the options given in an alias by
46
specifying the new part on the command-line. For example, if
47
you run ``lastlog -r-5..``, you will only get five line-based log
48
entries instead of 10. Note that all boolean options have an
49
implicit inverse, so you can override the commit alias with
50
``commit --no-strict``.
37
* You can override parts of the options given in an alias by overriding it.
38
For example, if you run **lastlog -r-5..**, you will only get five
39
line-based log entries instead of 10.
52
40
* Aliases can override the standard behaviour of existing commands by giving
53
an alias name that is the same as the orignal command. For example, default
54
commit is changed with ``commit=commit --strict``.
55
* Aliases cannot refer to other aliases. In other words making a
56
``lastlog`` alias and referring to it with a ``ll`` alias will not work.
57
This includes aliases that override standard commands
58
* Giving the ``--no-aliases`` to the bzr command will tell it to ignore aliases
59
for that run. For example, running ``bzr --no-aliases commit`` will perform a
60
standard commit instead not do a ``commit --strict``.
41
an alias name that is thesame as the orignal command. For example, default
42
commit is changed with **commit=commit --strict**.
43
* Aliases can not refer to other aliases. In other words making a
44
**lastlog** alias and referring to it with a **ll** alias will not work.
46
This includes aliases that override standard commands
48
* Giving the **--no-aliases** to the bzr command will tell it to ignore aliases
49
for that run. For example, running **bzr --no-aliases commit** will perform a
50
standard commit instead not do a **commit --strict**.
added
removed
doc/using_aliases.txt
