~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/using_aliases.txt

• browse files at revision 2147
• compare with another revision
• download diff
• download tarball
• view history from revision 2147

• reverse the comparison (2147 to 1226)
• stop comparing with revision 1226

Show diffs side-by-side

added

removed

doc/using_aliases.txt

 

1

=================================

 

2

Using aliases for Bazaar commands

 

3

=================================

 

4

 

 

5

Command aliases are an easy way to customize the behaviour of Bazaar. Aliases

 

6

are an easy way to create shortcuts for commonly-typed commands, or to set

 

7

defaults for commands.

 

8

 

 

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

equal sign, then a command fragment.  Here's an example ALIASES section:

 

12

 

 

13

Examples

 

14

========

 

15

A typical example::

 

16

 

 

17

    [ALIASES]

 

18

    recentlog=log -r-3..-1

 

19

    ll=log --line -r-10..-1

 

20

    commit=commit --strict

 

21

    diff=diff --diff-options -p

 

22

 

 

23

Explanation of examples

 

24

=======================

 

25

 

 

26

 * The first alias makes a new 'recentlog' command that shows the logs for the

 

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

 

30

   files in the tree are not recognized.

 

31

 * the **diff** alias adds the coveted -p option to diff

 

32

 

 

33

 

 

34

Rules for Aliases

 

35

=================

 

36

 

 

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.

 

40

 * Aliases can override the standard behaviour of existing commands by giving

 

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.

 

45

 

 

46

This includes aliases that override standard commands

 

47

 

 

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**.

 

51

 

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1