mirror of
https://github.com/facebook/sapling.git
synced 2024-10-16 11:52:02 +03:00
d47e205e87
Summary: Disable parsing `.hgignore` and related fileset `hgignore()` by default. They can still be enabled via configuration. The plan is to completely remove them later. A replacement for `hgignore()` fileset was added as `gitignore()`. The `hgignore()` fileset seems to be only used by zertosh in the past 3 months. Reviewed By: singhsrb Differential Revision: D14543232 fbshipit-source-id: f2385062a0e816331f693239f62448979876078a
84 lines
3.3 KiB
Plaintext
84 lines
3.3 KiB
Plaintext
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 ``.gitignore`` are not rooted. And is different
|
|
from patterns used by **hg** in other places.
|
|
|
|
.. note::
|
|
|
|
In the future, patterns might be reworked to be more consistent with
|
|
``.gitignore``. For example, negative patterns are possible and patterns
|
|
are orders. Things listed below might change significantly.
|
|
|
|
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, and when the path points to a directory, it is matched
|
|
recursively. To match all files in a directory non-recursively (not including
|
|
any files in subdirectories), ``rootfilesin:`` can be used, specifying an
|
|
absolute path (relative to the 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), can match also against directories: files
|
|
under matched directories are treated as matched.
|
|
For ``-I`` and ``-X`` options, ``glob:`` will match directories recursively.
|
|
|
|
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"
|
|
rootfilesin:foo/bar the files in a directory called foo/bar, but not any files
|
|
in its subdirectories and not a file bar in directory foo
|
|
|
|
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/* any file in directory foo
|
|
foo/** any file in directory foo plus all its subdirectories,
|
|
recursively
|
|
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`.
|
|
|
|
Include examples::
|
|
|
|
include:path/to/mypatternfile reads patterns to be applied to all paths
|
|
subinclude:path/to/subignorefile reads patterns specifically for paths in the
|
|
subdirectory
|