|
3398.1.26
by Ian Clatworthy
jam feedback - make patterns a separate help topic |
1 |
Patterns |
2 |
======== |
|
3 |
||
4 |
Bazaar uses patterns to match files at various times. For example, |
|
5 |
the ``add`` command skips over files that match ignore patterns |
|
6 |
and preferences can be associated with files using rule patterns. |
|
7 |
The pattern syntax is described below. |
|
8 |
||
9 |
Trailing slashes on patterns are ignored. If the pattern contains a |
|
10 |
slash or is a regular expression, it is compared to the whole path |
|
11 |
from the branch root. Otherwise, it is compared to only the last |
|
12 |
component of the path. To match a file only in the root directory, |
|
13 |
prepend './'. Patterns specifying absolute paths are not allowed. |
|
14 |
||
15 |
Patterns may include globbing wildcards such as:: |
|
16 |
||
17 |
? - Matches any single character except '/' |
|
18 |
* - Matches 0 or more characters except '/' |
|
19 |
/**/ - Matches 0 or more directories in a path |
|
20 |
[a-z] - Matches a single character from within a group of characters |
|
21 |
||
22 |
Patterns may also be Python regular expressions. Regular expression |
|
23 |
patterns are identified by a 'RE:' prefix followed by the regular |
|
24 |
expression. Regular expression patterns may not include named or |
|
25 |
numbered groups. |
|
|
4948.5.2
by John Whitley
NEWS and various documentation updates for ignore exclusions. |
26 |
|
27 |
Ignore patterns may be prefixed with '!', which means that a filename |
|
28 |
matched by that pattern will not be ignored. |