← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/using_aliases.txt

  • Committer: Ian Clatworthy
  • Date: 2009-01-19 02:24:15 UTC
  • mto: This revision was merged to the branch mainline in revision 3944.
  • Revision ID: ian.clatworthy@canonical.com-20090119022415-mo0mcfeiexfktgwt
apply jam's log --short fix (Ian Clatworthy)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/using_aliases.txt
1
 
Command aliases are an eay way to customize the behaviour of Bazaar-NG. Aliases
2
 
are an easy way to create shortcuts for commonly-typed commands, or to set
 
1
Using aliases
 
2
=============
 
3
 
 
4
What are aliases?
 
5
-----------------
 
6
 
 
7
Aliases are an easy way to create shortcuts for commonly-typed commands, or to set
3
8
defaults for commands.
4
9
 
5
 
Command aliases can be defined in the **[ALIASES]** section of your
6
 
**.bazaar/bazaar.conf** file. Aliases start with the alias name, then an
7
 
equal sign, then a command fragment.  Here's an example ALIASES section:
 
10
Defining aliases
 
11
----------------
8
12
 
9
 
Examples
10
 
========
11
 
A typical example::
 
13
Command aliases can be defined in the ``[ALIASES]`` section of your
 
14
``bazaar.conf`` file. Aliases start with the alias name, then an
 
15
equal sign, then a command fragment.  Here's an example ALIASES section::
12
16
 
13
17
    [ALIASES]
14
18
    recentlog=log -r-3..-1
16
20
    commit=commit --strict
17
21
    diff=diff --diff-options -p
18
22
 
19
 
Explanation of examples
20
 
=======================
 
23
Here are the explanations of the examples above:
21
24
 
22
 
 * The first alias makes a new 'recentlog' command that shows the logs for the
 
25
 * The first alias makes a new ``recentlog`` command that shows the logs for the
23
26
   last three revisions
24
 
 * The **ll** alias shows the last 10 log entries in line format.
25
 
 * the **commit** alias sets the default for commit to refuse to commit if new
 
27
 * The ``ll`` alias shows the last 10 log entries in line format.
 
28
 * the ``commit`` alias sets the default for commit to refuse to commit if new
26
29
   files in the tree are not recognized.
27
 
 * the **diff** alias adds the coveted -p option to diff
28
 
 
29
 
 
30
 
Rules for Aliases
31
 
=================
32
 
 
33
 
 * You can override parts of the options given in an alias by overriding it.
34
 
   For example, if you run **lastlog -r-5..**, you will only get five
35
 
   line-based log entries instead of 10.
 
30
 * the ``diff`` alias adds the coveted -p option to diff
 
31
 
 
32
Using the aliases
 
33
-----------------
 
34
 
 
35
The aliases defined above would be used like so: ::
 
36
 
 
37
   % bzr recentlog
 
38
   % bzr ll
 
39
   % bzr commit
 
40
   % bzr diff
 
41
 
 
42
Rules for aliases
 
43
-----------------
 
44
 
 
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``.
 
51
 
36
52
 * Aliases can override the standard behaviour of existing commands by giving
37
 
   an alias name that is thesame as the orignal command. For example, default
38
 
   commit is changed with **commit=commit --strict**.
39
 
 * Aliases can not refer to other aliases. In other words making a
40
 
   **lastlog** alias and referring to it with a **ll** alias will not work.
41
 
 
42
 
This includes aliases that override standard commands
43
 
 
44
 
 * Giving the **--no-aliases** to the bzr command will tell it to ignore aliases
45
 
   for that run. For example, running **bzr --no-aliases commit** will perform a
46
 
   standard commit instead not do a **commit --strict**.
 
53
   an alias name that is the same as the orignal command. For example, default
 
54
   commit is changed with ``commit=commit --strict``.
 
55
 
 
56
 * Aliases cannot refer to other aliases. In other words making a
 
57
   ``lastlog`` alias and referring to it with a ``ll`` alias will not work.
 
58
   This includes aliases that override standard commands.
 
59
 
 
60
 * Giving the ``--no-aliases`` option to the bzr command will tell it to ignore aliases
 
61
   for that run. For example, running ``bzr --no-aliases commit`` will perform a
 
62
   standard commit instead, not do a ``commit --strict``.
47
63