comparison doc/hgignore.5.txt @ 9127:35c3f94233a0

hgignore.5.txt: improved description of matching Improved the description of the matching behavior used with .hgignore. Made some minor language improvements.
author Henri Wiechers <hwiechers@gmail.com>
date Sun, 12 Jul 2009 07:56:43 +0200
parents d19ab9a56bf4
children d6eecafaf12f 3a319bc8906d
comparison
equal deleted inserted replaced
9126:64994005bcb7 9127:35c3f94233a0
10 10
11 SYNOPSIS 11 SYNOPSIS
12 -------- 12 --------
13 13
14 The Mercurial system uses a file called `.hgignore` in the root 14 The Mercurial system uses a file called `.hgignore` in the root
15 directory of a repository to control its behavior when it finds files 15 directory of a repository to control its behavior when it searches
16 that it is not currently managing. 16 for files that it is not currently tracking.
17 17
18 DESCRIPTION 18 DESCRIPTION
19 ----------- 19 -----------
20 20
21 Mercurial ignores every unmanaged file that matches any pattern in an 21 An untracked file is ignored if its path relative to the repository
22 ignore file. The patterns in an ignore file do not apply to files 22 root directory, or any prefix path of that path, is matched against
23 managed by Mercurial. To control Mercurial's handling of files that it 23 any pattern in `.hgignore`.
24 manages, see the hg(1) man page. Look for the "-I" and "-X" options.
25 24
26 In addition, a Mercurial configuration file can point to a set of 25 For example, say we have an an untracked file, `file.c`, at
26 `a/b/file.c` inside our repository. Mercurial will ignore `file.c` if
27 any pattern in `.hgignore` matches `a/b/file.c`, `a/b` or `a`.
28
29 In addition, a Mercurial configuration file can reference a set of
27 per-user or global ignore files. See the hgrc(5) man page for details 30 per-user or global ignore files. See the hgrc(5) man page for details
28 of how to configure these files. Look for the "ignore" entry in the 31 of how to configure these files. Look for the "ignore" entry in the
29 "ui" section. 32 "ui" section.
33
34 To control Mercurial's handling of files that it manages, see the
35 hg(1) man page. Look for the "-I" and "-X" options.
30 36
31 SYNTAX 37 SYNTAX
32 ------ 38 ------
33 39
34 An ignore file is a plain text file consisting of a list of patterns, 40 An ignore file is a plain text file consisting of a list of patterns,