← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/using_aliases.txt

  • Committer: James Blackwell
  • Date: 2006-03-14 16:57:35 UTC
  • mto: This revision was merged to the branch mainline in revision 1700.
  • Revision ID: jblack@merconline.com-20060314165735-30bae1b8da652fa4
Now they look good in rst2html

Show diffs side-by-side

added added

removed removed

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