GPL Distributed Version Control Software

Using aliases for Bazaar commands

Command aliases are an easy way to customize the behaviour of Bazaar. Aliases are an easy way to create shortcuts for commonly-typed commands, or to set defaults for commands.

Command aliases can be defined in the [ALIASES] section of your .bazaar/bazaar.conf file. Aliases start with the alias name, then an equal sign, then a command fragment. Here's an example ALIASES section:


A typical example:

recentlog=log -r-3..-1
ll=log --line -r-10..-1
commit=commit --strict
diff=diff --diff-options -p

Explanation of examples

  • 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

Rules for Aliases

  • You can override parts of the options given in an alias by overriding it. For example, if you run lastlog -r-5.., you will only get five line-based log entries instead of 10.
  • Aliases can override the standard behaviour of existing commands by giving an alias name that is thesame as the orignal command. For example, default commit is changed with commit=commit --strict.
  • Aliases can not 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 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.