##// END OF EJS Templates
docs: don't use :hg: at the beginning of lines in notes (issue3397)...
Mads Kiilerich -
r16510:c7c9473f stable
parent child Browse files
Show More
@@ -1,57 +1,57 b''
1 1 Mercurial accepts several notations for identifying one or more files
2 2 at a time.
3 3
4 4 By default, Mercurial treats filenames as shell-style extended glob
5 5 patterns.
6 6
7 7 Alternate pattern notations must be specified explicitly.
8 8
9 9 .. note::
10 Patterns specified in ``.hgignore`` are not rooted. Please see
11 :hg:`help hgignore` for details.
10 Patterns specified in ``.hgignore`` are not rooted.
11 Please see :hg:`help hgignore` for details.
12 12
13 13 To use a plain path name without any pattern matching, start it with
14 14 ``path:``. These path names must completely match starting at the
15 15 current repository root.
16 16
17 17 To use an extended glob, start a name with ``glob:``. Globs are rooted
18 18 at the current directory; a glob such as ``*.c`` will only match files
19 19 in the current directory ending with ``.c``.
20 20
21 21 The supported glob syntax extensions are ``**`` to match any string
22 22 across path separators and ``{a,b}`` to mean "a or b".
23 23
24 24 To use a Perl/Python regular expression, start a name with ``re:``.
25 25 Regexp pattern matching is anchored at the root of the repository.
26 26
27 27 To read name patterns from a file, use ``listfile:`` or ``listfile0:``.
28 28 The latter expects null delimited patterns while the former expects line
29 29 feeds. Each string read from the file is itself treated as a file
30 30 pattern.
31 31
32 32 Plain examples::
33 33
34 34 path:foo/bar a name bar in a directory named foo in the root
35 35 of the repository
36 36 path:path:name a file or directory named "path:name"
37 37
38 38 Glob examples::
39 39
40 40 glob:*.c any name ending in ".c" in the current directory
41 41 *.c any name ending in ".c" in the current directory
42 42 **.c any name ending in ".c" in any subdirectory of the
43 43 current directory including itself.
44 44 foo/*.c any name ending in ".c" in the directory foo
45 45 foo/**.c any name ending in ".c" in any subdirectory of foo
46 46 including itself.
47 47
48 48 Regexp examples::
49 49
50 50 re:.*\.c$ any name ending in ".c", anywhere in the repository
51 51
52 52 File examples::
53 53
54 54 listfile:list.txt read list from list.txt with one file pattern per line
55 55 listfile0:list.txt read list from list.txt with null byte delimiters
56 56
57 57 See also :hg:`help filesets`.
General Comments 0
You need to be logged in to leave comments. Login now