/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
3398.1.20 by Ian Clatworthy
add rules help topic
1
Rules
2
=====
3
4
Introduction
5
------------
6
7
Rules are defined in ini file format where the sections are file glob
8
patterns and the contents of each section are the preferences for files
3943.3.3 by Marius Kruger
update rules topic
9
matching that pattern(s). For example::
3398.1.20 by Ian Clatworthy
add rules help topic
10
3398.1.32 by Ian Clatworthy
namespace keyword changed to name
11
    [name *.bat]
3398.1.20 by Ian Clatworthy
add rules help topic
12
    eol = dos
13
3943.3.3 by Marius Kruger
update rules topic
14
    [name *.html *.xml]
4303.1.1 by Neil Martinsen-Burrell
update the rules documentation to match the currently supported users of rules
15
    keywords = xml_escape
3398.1.20 by Ian Clatworthy
add rules help topic
16
17
Preferences like these are useful for commands and plugins wishing to
4303.1.1 by Neil Martinsen-Burrell
update the rules documentation to match the currently supported users of rules
18
provide custom behaviour for selected files.  For more information on 
19
end of line conversion see ``bzr help eol``.  Keyword support is provided
20
by the bzr-keywords plugin (http://launchpad.net/bzr-keywords).
3398.1.20 by Ian Clatworthy
add rules help topic
21
22
Files
23
-----
24
3606.2.5 by Robert Collins
Cherry pick Robert's 'disable .bzrrules in-tree' patch
25
Default rules for all branches are defined in the optional file
26
``BZR_HOME/rules``. 
3398.1.20 by Ian Clatworthy
add rules help topic
27
3515.1.1 by Ian Clatworthy
Rule-based preferences (Ian Clatworthy)
28
Rule Patterns
29
-------------
3398.1.20 by Ian Clatworthy
add rules help topic
30
31
Patterns are ordered and searching stops as soon as one matches.
32
As a consequence, more explicit patterns should be placed towards
3398.1.26 by Ian Clatworthy
jam feedback - make patterns a separate help topic
33
the top of the file. Rule patterns use exactly the same conventions
34
as ignore patterns. See ``bzr help patterns`` for details.
3398.1.20 by Ian Clatworthy
add rules help topic
35
3946.1.1 by Ian Clatworthy
Multi-glob rules (Marius Kruger)
36
Note: Patterns containing square brackets or spaces should be
4229.4.1 by Michael B. Trausch
Trivial typo fix.
37
surrounded in quotes to ensure they are correctly parsed.