~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Patch Queue Manager
  • Date: 2011-09-22 14:12:18 UTC
  • mfrom: (6155.3.1 jam)
  • Revision ID: pqm@pqm.ubuntu.com-20110922141218-86s4uu6nqvourw4f
(jameinel) Cleanup comments bzrlib/smart/__init__.py (John A Meinel)

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
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