~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: mbp at sourcefrog
  • Date: 2005-03-09 04:51:05 UTC
  • Revision ID: mbp@sourcefrog.net-20050309045105-d02cd410a115da2c
import all docs from arch

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.