--- a/doc/hg.1.txt Sat Jul 16 15:13:40 2005 -0800
+++ b/doc/hg.1.txt Mon Jul 18 06:54:21 2005 -0800
@@ -33,7 +33,8 @@
----------------
files ...::
- indicates one or more filename or relative path filenames
+ indicates one or more filename or relative path filenames; see
+ "FILE NAME PATTERNS" for information on pattern matching
path::
indicates a path on the local machine
@@ -51,11 +52,14 @@
COMMANDS
--------
-add [files ...]::
+add [options] [files ...]::
Schedule files to be version controlled and added to the repository.
The files will be added to the repository at the next commit.
+ If no names are given, add all files in the current directory and
+ its subdirectory.
+
addremove::
Add all new files and remove all missing files from the repository.
@@ -183,14 +187,10 @@
init::
Initialize a new repository in the current directory.
-locate [options] [patterns]::
- Print all files under Mercurial control whose basenames match the
+locate [options] [files]::
+ Print all files under Mercurial control whose names match the
given patterns.
- Patterns are shell-style globs. To restrict searches to specific
- directories, use the "-i <pat>" option. To eliminate particular
- directories from searching, use the "-x <pat>" option.
-
This command searches the current directory and its
subdirectories. To search an entire repository, move to the root
of the repository.
@@ -207,9 +207,9 @@
-0, --print0 end filenames with NUL, for use with xargs
-f, --fullpath print complete paths from the filesystem root
- -i, --include <pat> include directories matching the given globs
+ -I, --include <pat> include directories matching the given patterns
-r, --rev <rev> search the repository as it stood at rev
- -x, --exclude <pat> exclude directories matching the given globs
+ -X, --exclude <pat> exclude directories matching the given patterns
log [-r revision ...] [-p] [file]::
Print the revision history of the specified file or the entire project.
@@ -398,6 +398,52 @@
the changelog, manifest, and tracked files, as well as the
integrity of their crosslinks and indices.
+FILE NAME PATTERNS
+------------------
+
+ Mercurial accepts several notations for identifying one or more
+ file at a time.
+
+ By default, Mercurial treats file names as shell-style extended
+ glob patterns.
+
+ Alternate pattern notations must be specified explicitly.
+
+ To use a plain path name without any pattern matching, start a
+ name with "path:". These path names must match completely, from
+ the root of the current repository.
+
+ To use an extended glob, start a name with "glob:". Globs are
+ rooted at the current directory; a glob such as "*.c" will match
+ files ending in ".c" in the current directory only.
+
+ 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.
+
+ 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 the current directory, or
+ any subdirectory
+ foo/*.c any name ending in ".c" in the directory foo
+ foo/**.c any name ending in ".c" in the directory foo, or any
+ subdirectory
+
+ Regexp examples:
+
+ re:.*\.c$ any name ending in ".c", anywhere in the repsitory
+
+
SPECIFYING SINGLE REVISIONS
---------------------------