upstream/mercurial-mirror Commit - r20290:50db996b

1

Mercurial accepts several notations for identifying one or more files

1

Mercurial accepts several notations for identifying one or more files

2

at a time.

2

at a time.

3

4

By default, Mercurial treats filenames as shell-style extended glob

4

By default, Mercurial treats filenames as shell-style extended glob

5

patterns.

5

patterns.

6

7

Alternate pattern notations must be specified explicitly.

7

Alternate pattern notations must be specified explicitly.

8

9

.. note::

9

.. note::

10

Patterns specified in ``.hgignore`` are not rooted.

10

Patterns specified in ``.hgignore`` are not rooted.

11

Please see :hg:`help hgignore` for details.

11

Please see :hg:`help hgignore` for details.

12

13

To use a plain path name without any pattern matching, start it with

13

To use a plain path name without any pattern matching, start it with

14

``path:``. These path names must completely match starting at the

14

``path:``. These path names must completely match starting at the

15

current repository root.

15

current repository root.

16

17

To use an extended glob, start a name with ``glob:``. Globs are rooted

17

To use an extended glob, start a name with ``glob:``. Globs are rooted

18

at the current directory; a glob such as ``*.c`` will only match files

18

at the current directory; a glob such as ``*.c`` will only match files

19

in the current directory ending with ``.c``.

19

in the current directory ending with ``.c``.

20

21

The supported glob syntax extensions are ``**`` to match any string

21

The supported glob syntax extensions are ``**`` to match any string

22

across path separators and ``{a,b}`` to mean "a or b".

22

across path separators and ``{a,b}`` to mean "a or b".

23

24

To use a Perl/Python regular expression, start a name with ``re:``.

24

To use a Perl/Python regular expression, start a name with ``re:``.

25

Regexp pattern matching is anchored at the root of the repository.

25

Regexp pattern matching is anchored at the root of the repository.

26

27

To read name patterns from a file, use ``listfile:`` or ``listfile0:``.

27

To read name patterns from a file, use ``listfile:`` or ``listfile0:``.

28

The latter expects null delimited patterns while the former expects line

28

The latter expects null delimited patterns while the former expects line

29

feeds. Each string read from the file is itself treated as a file

29

feeds. Each string read from the file is itself treated as a file

30

pattern.

30

pattern.

31

32

All patterns, except for ``glob:`` specified in command line (not for

33

``-I`` or ``-X`` options) or ``.hgignore`` file, can match also

34

against directories: files under matched directories are treated as

35

matched.

36

32

Plain examples::

37

Plain examples::

33

38

34

path:foo/bar a name bar in a directory named foo in the root

39

path:foo/bar a name bar in a directory named foo in the root

35

of the repository

40

of the repository

36

path:path:name a file or directory named "path:name"

41

path:path:name a file or directory named "path:name"

37

42

38

Glob examples::

43

Glob examples::

39

44

40

glob:*.c any name ending in ".c" in the current directory

45

glob:*.c any name ending in ".c" in the current directory

41

*.c any name ending in ".c" in the current directory

46

*.c any name ending in ".c" in the current directory

42

**.c any name ending in ".c" in any subdirectory of the

47

**.c any name ending in ".c" in any subdirectory of the

43

current directory including itself.

48

current directory including itself.

44

foo/*.c any name ending in ".c" in the directory foo

49

foo/*.c any name ending in ".c" in the directory foo

45

foo/**.c any name ending in ".c" in any subdirectory of foo

50

foo/**.c any name ending in ".c" in any subdirectory of foo

46

including itself.

51

including itself.

47

52

48

Regexp examples::

53

Regexp examples::

49

54

50

re:.*\.c$ any name ending in ".c", anywhere in the repository

55

re:.*\.c$ any name ending in ".c", anywhere in the repository

51

56

52

File examples::

57

File examples::

53

58

54

listfile:list.txt read list from list.txt with one file pattern per line

59

listfile:list.txt read list from list.txt with one file pattern per line

55

listfile0:list.txt read list from list.txt with null byte delimiters

60

listfile0:list.txt read list from list.txt with null byte delimiters

56

61

57

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

             Mercurial accepts several notations for identifying one or more files
             at a time.
             By default, Mercurial treats filenames as shell-style extended glob
             patterns.
             Alternate pattern notations must be specified explicitly.
             .. note::
               Patterns specified in ``.hgignore`` are not rooted.
               Please see :hg:`help hgignore` for details.
             To use a plain path name without any pattern matching, start it with
             ``path:``. These path names must completely match starting at the
             current repository root.
             To use an extended glob, start a name with ``glob:``. Globs are rooted
             at the current directory; a glob such as ``*.c`` will only match files
             in the current directory ending with ``.c``.
             The supported glob syntax extensions are ``**`` to match any string
             across path separators and ``{a,b}`` to mean "a or b".
             To use a Perl/Python regular expression, start a name with ``re:``.
             Regexp pattern matching is anchored at the root of the repository.
             To read name patterns from a file, use ``listfile:`` or ``listfile0:``.
             The latter expects null delimited patterns while the former expects line
             feeds. Each string read from the file is itself treated as a file
             pattern.
+            All patterns, except for ``glob:`` specified in command line (not for
+            ``-I`` or ``-X`` options) or ``.hgignore`` file, can match also
+            against directories: files under matched directories are treated as
+            matched.
             Plain examples::
               path:foo/bar   a name bar in a directory named foo in the root
                              of the repository
               path:path:name a file or directory named "path:name"
             Glob examples::
               glob:*.c       any name ending in ".c" in the current directory
               *.c            any name ending in ".c" in the current directory
               **.c           any name ending in ".c" in any subdirectory of the
                              current directory including itself.
               foo/*.c        any name ending in ".c" in the directory foo
               foo/**.c       any name ending in ".c" in any subdirectory of foo
                              including itself.
             Regexp examples::
               re:.*\.c$      any name ending in ".c", anywhere in the repository
             File examples::
               listfile:list.txt  read list from list.txt with one file pattern per line
               listfile0:list.txt read list from list.txt with null byte delimiters
             See also :hg:`help filesets`.