comparison doc/hgignore.5.txt @ 9194:0de7cf8db5fd

hgignore.5: mark file names and cmdline options as literal text

9193:52de439b8d99

-----------

The working directory of a Mercurial repository will often contain
files that should not be tracked by Mercurial. These include backup
files created by editors and build products created by compilers.
These files can be ignored by listing them in a `.hgignore` file in
the root of the working directory. The `.hgignore` file must be
created manually. It is typically put under version control, so that
the settings will propagate to other repositories with push and pull.

An untracked file is ignored if its path relative to the repository
root directory, or any prefix path of that path, is matched against
any pattern in `.hgignore`.

For example, say we have an an untracked file, ``file.c``, at
``a/b/file.c`` inside our repository. Mercurial will ignore ``file.c``
if any pattern in ``.hgignore`` matches ``a/b/file.c``, ``a/b`` or ``a``.

per-user or global ignore files. See the |hgrc(5)|_ man page for details
of how to configure these files. Look for the "ignore" entry in the
"ui" section.

To control Mercurial's handling of files that it manages, see the
|hg(1)|_ man page. Look for the "-I" and "-X" options.

SYNTAX
------

An ignore file is a plain text file consisting of a list of patterns,

9194:0de7cf8db5fd

-----------

The working directory of a Mercurial repository will often contain
files that should not be tracked by Mercurial. These include backup
files created by editors and build products created by compilers.
These files can be ignored by listing them in a ``.hgignore`` file in
the root of the working directory. The ``.hgignore`` file must be
created manually. It is typically put under version control, so that
the settings will propagate to other repositories with push and pull.

An untracked file is ignored if its path relative to the repository
root directory, or any prefix path of that path, is matched against
any pattern in ``.hgignore``.

For example, say we have an an untracked file, ``file.c``, at
``a/b/file.c`` inside our repository. Mercurial will ignore ``file.c``
if any pattern in ``.hgignore`` matches ``a/b/file.c``, ``a/b`` or ``a``.

per-user or global ignore files. See the |hgrc(5)|_ man page for details
of how to configure these files. Look for the "ignore" entry in the
"ui" section.

To control Mercurial's handling of files that it manages, see the
|hg(1)|_ man page. Look for the "``-I``" and "``-X``" options.

SYNTAX
------

An ignore file is a plain text file consisting of a list of patterns,