Help: Index

+ + + + + + + + + + + +

Topics
config	Configuration Files
dates	Date Formats
diffs	Diff Formats
environment	Environment Variables
extensions	Using Additional Features
filesets	Specifying File Sets
glossary	Glossary
hgignore	Syntax for Mercurial Ignore Files
hgweb	Configuring hgweb
merge-tools	Merge Tools
multirevs	Specifying Multiple Revisions
patterns	File Name Patterns
phases	Working with Phases
revisions	Specifying Single Revisions
revsets	Specifying Revision Sets
subrepos	Subrepositories
templating	Template Usage
urls	URL Paths
topic-containing-verbose	This is the topic to test omit indicating.
Main Commands
add	add the specified files on the next commit
annotate	show changeset information by line for each file
clone	make a copy of an existing repository
commit	commit the specified files or all outstanding changes
diff	diff repository (or selected files)
export	dump the header and diffs for one or more changesets
forget	forget the specified files on the next commit
init	create a new repository in the given directory
log	show revision history of entire repository or files
merge	merge working directory with another revision
pull	pull changes from the specified source
push	push changes to the specified destination
remove	remove the specified files on the next commit
serve	start stand-alone webserver
status	show changed files in the working directory
summary	summarize working directory state
update	update working directory (or switch revisions)
Other Commands
addremove	add all new files, delete all missing files
archive	create an unversioned archive of a repository revision
backout	reverse effect of earlier changeset
bisect	subdivision search of changesets
bookmarks	track a line of development with movable markers
branch	set or show the current branch name
branches	list repository named branches
bundle	create a changegroup file
cat	output the current or given revision of files
copy	mark files as copied for the next commit
graft	copy changes from other branches onto the current branch
grep	search for a pattern in specified files and revisions
heads	show current repository heads or show branch heads
help	show help for a given topic or a help overview
identify	identify the working copy or specified revision
import	import an ordered set of patches
incoming	show new changesets found in source
locate	locate files matching specific patterns
manifest	output the current or given revision of the project manifest
nohelp	(no help text available)
outgoing	show changesets not found in the destination
parents	show the parents of the working directory or revision
paths	show aliases for remote repositories
phase	set or show the current phase name
recover	roll back an interrupted transaction
rename	rename files; equivalent of copy + remove
resolve	redo merges or set/view the merge status of files
revert	restore files to their checkout state
rollback	roll back the last transaction (dangerous)
root	print the root (top) of the current working directory
showconfig	show combined config settings from all hgrc files
tag	add one or more tags for the current or given revision
tags	list repository tags
tip	show the tip revision
unbundle	apply one or more changegroup files
verify	verify the integrity of the repository
version	output version and copyright information

Mercurial

Help: add

+ hg add [OPTION]... [FILE]... + + add the specified files on the next commit + + Schedule files to be version controlled and added to the repository. + + The files will be added to the repository at the next commit. To undo an + add before that, see "hg forget". + + If no names are given, add all files to the repository. + + An example showing how new (unknown) files are added automatically by "hg + add": + + $ ls + foo.c + $ hg status + ? foo.c + $ hg add + adding foo.c + $ hg status + A foo.c + + Returns 0 if all files are successfully added. + + options: + + -I --include PATTERN [+] include names matching the given patterns + -X --exclude PATTERN [+] exclude names matching the given patterns + -S --subrepos recurse into subrepositories + -n --dry-run do not perform actions, just print output + + [+] marked option can be specified multiple times + + global options: + + -R --repository REPO repository root directory or name of overlay bundle + file + --cwd DIR change working directory + -y --noninteractive do not prompt, automatically pick the first choice for + all prompts + -q --quiet suppress output + -v --verbose enable additional output + --config CONFIG [+] set/override config option (use 'section.name=value') + --debug enable debugging output + --debugger start debugger + --encoding ENCODE set the charset encoding (default: ascii) + --encodingmode MODE set the charset encoding mode (default: strict) + --traceback always print a traceback on exception + --time time how long the command takes + --profile print command execution profile + --version output version information and exit + -h --help display help and exit + --hidden consider hidden changesets + + [+] marked option can be specified multiple times + +

Mercurial

Help: remove

+ hg remove [OPTION]... FILE... + + aliases: rm + + remove the specified files on the next commit + + Schedule the indicated files for removal from the current branch. + + This command schedules the files to be removed at the next commit. To undo + a remove before that, see "hg revert". To undo added files, see "hg + forget". + + -A/--after can be used to remove only files that have already been + deleted, -f/--force can be used to force deletion, and -Af can be used to + remove files from the next revision without deleting them from the working + directory. + + The following table details the behavior of remove for different file + states (columns) and option combinations (rows). The file states are Added + [A], Clean [C], Modified [M] and Missing [!] (as reported by "hg status"). + The actions are Warn, Remove (from branch) and Delete (from disk): + + A C M ! + -------------- + none W RD W R + -f R RD RD R + -A W W W R + -Af R R R R + + Note that remove never deletes files in Added [A] state from the working + directory, not even if option --force is specified. + + Returns 0 on success, 1 if any warnings encountered. + + options: + + -A --after record delete for missing files + -f --force remove (and delete) file even if added or modified + -I --include PATTERN [+] include names matching the given patterns + -X --exclude PATTERN [+] exclude names matching the given patterns + + [+] marked option can be specified multiple times + + global options: + + -R --repository REPO repository root directory or name of overlay bundle + file + --cwd DIR change working directory + -y --noninteractive do not prompt, automatically pick the first choice for + all prompts + -q --quiet suppress output + -v --verbose enable additional output + --config CONFIG [+] set/override config option (use 'section.name=value') + --debug enable debugging output + --debugger start debugger + --encoding ENCODE set the charset encoding (default: ascii) + --encodingmode MODE set the charset encoding mode (default: strict) + --traceback always print a traceback on exception + --time time how long the command takes + --profile print command execution profile + --version output version information and exit + -h --help display help and exit + --hidden consider hidden changesets + + [+] marked option can be specified multiple times + +

Mercurial

Help: revisions

+ Specifying Single Revisions + + Mercurial supports several ways to specify individual revisions. + + A plain integer is treated as a revision number. Negative integers are + treated as sequential offsets from the tip, with -1 denoting the tip, -2 + denoting the revision prior to the tip, and so forth. + + A 40-digit hexadecimal string is treated as a unique revision identifier. + + A hexadecimal string less than 40 characters long is treated as a unique + revision identifier and is referred to as a short-form identifier. A + short-form identifier is only valid if it is the prefix of exactly one + full-length identifier. + + Any other string is treated as a bookmark, tag, or branch name. A bookmark + is a movable pointer to a revision. A tag is a permanent name associated + with a revision. A branch name denotes the tipmost revision of that + branch. Bookmark, tag, and branch names must not contain the ":" + character. + + The reserved name "tip" always identifies the most recent revision. + + The reserved name "null" indicates the null revision. This is the revision + of an empty repository, and the parent of revision 0. + + The reserved name "." indicates the working directory parent. If no + working directory is checked out, it is equivalent to null. If an + uncommitted merge is in progress, "." is the revision of the first parent. + +

Mercurial

Topics

Main Commands

Other Commands

Mercurial

Help: add

Mercurial

Help: remove

Mercurial

Help: revisions