~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Marius Kruger
  • Date: 2010-07-10 21:28:56 UTC
  • mto: (5384.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 5385.
  • Revision ID: marius.kruger@enerweb.co.za-20100710212856-uq4ji3go0u5se7hx
* Update documentation
* add NEWS

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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
Ignore patterns may be prefixed with '!', which means that a filename
 
28
matched by that pattern will not be ignored.