← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/help_topics/en/patterns.txt

[merge] robert's knit-performance work

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help_topics/en/patterns.txt
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.
26
 
 
27
 
Case insensitive ignore patterns can be specified with regular expressions
28
 
by using the ``i`` (for ignore case) flag in the pattern.
29
 
 
30
 
For example, a case insensitive match for ``foo`` may be specified as::
31
 
 
32
 
  RE:(?i)foo
33
 
 
34
 
Ignore patterns may be prefixed with ``!``, which means that a filename
35
 
matched by that pattern will not be ignored.
36
 
 
37
 
.. _Python regular expressions: http://docs.python.org/library/re.html
38