Rev 5059: (parthm) Document case insensitive patterns in `bzr help patterns` (#594386) in file:///home/pqm/archives/thelove/bzr/2.2/

[Canonical.com Patch Queue Manager]

At file:///home/pqm/archives/thelove/bzr/2.2/

------------------------------------------------------------
revno: 5059 [merge]
revision-id: pqm at pqm.ubuntu.com-20100716172956-0gj9grxjxvppcayb
parent: pqm at pqm.ubuntu.com-20100714142240-5iwpamdlnhpvv5l2
parent: parth.malwankar at gmail.com-20100716125303-pgh4m2y6q43mpds9
committer: Canonical.com Patch Queue Manager <pqm at pqm.ubuntu.com>
branch nick: 2.2
timestamp: Fri 2010-07-16 18:29:56 +0100
message:
  (parthm) Document case insensitive patterns in `bzr help patterns` (#594386)
   (Parth Malwankar)
modified:
  NEWS                           NEWS-20050323055033-4e00b5db738777ff
  bzrlib/help_topics/en/patterns.txt patterns.txt-20080625070357-wx8qm46a19ejwfns-1
=== modified file 'NEWS'
--- a/NEWS	2010-07-14 14:22:40 +0000
+++ b/NEWS	2010-07-16 12:53:03 +0000
@@ -42,6 +42,10 @@
 Documentation
 *************
 
+* ``bzr help patterns`` now explains case insensitive patterns and
+  points to Python regular expression documentation.
+  (Parth Malwankar, #594386)
+
 API Changes
 ***********
 

=== modified file 'bzrlib/help_topics/en/patterns.txt'
--- a/bzrlib/help_topics/en/patterns.txt	2010-01-02 07:36:36 +0000
+++ b/bzrlib/help_topics/en/patterns.txt	2010-07-16 12:51:21 +0000
@@ -10,7 +10,7 @@
 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.
+prepend ``./``. Patterns specifying absolute paths are not allowed.
 
 Patterns may include globbing wildcards such as::
 
@@ -19,10 +19,20 @@
   /**/ - 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
+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.
 
-Ignore patterns may be prefixed with '!', which means that a filename
+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
+