~bzr-pqm/bzr/bzr.dev

Patterns

========

Bazaar uses patterns to match files at various times. For example,

the ``add`` command skips over files that match ignore patterns

and preferences can be associated with files using rule patterns.

The pattern syntax is described below.

Trailing slashes on patterns are ignored. If the pattern contains a

slash or is a regular expression, it is compared to the whole path

from the branch root. Otherwise, it is compared to only the last

component of the path. To match a file only in the root directory,

prepend ``./``. Patterns specifying absolute paths are not allowed.

Patterns may include globbing wildcards such as::

  ? - Matches any single character except '/'

  * - Matches 0 or more characters except '/'

  /**/ - Matches 0 or more directories in a path

  [a-z] - Matches a single character from within a group of characters

Patterns may also be `Python regular expressions`_. Regular expression

patterns are identified by a ``RE:`` prefix followed by the regular

expression.  Regular expression patterns may not include named or

numbered groups.

Case insensitive ignore patterns can be specified with regular expressions

by using the ``i`` (for ignore case) flag in the pattern.

For example, a case insensitive match for ``foo`` may be specified as::

  RE:(?i)foo

Ignore patterns may be prefixed with ``!``, which means that a filename

matched by that pattern will not be ignored.

.. _Python regular expressions: http://docs.python.org/library/re.html