[F007] Update
This functionality aims to surround : hg update and to adapt it for <ant> tags.
Shell command
hg update [-c] [-C] [-d DATE] [[-r] REV] aliases: up, checkout, co update working directory Update the repository's working directory to the specified changeset. If no changeset is specified, attempt to update to the head of the current branch. If this head is a descendant of the working directory's parent, update to it, otherwise abort. The following rules apply when the working directory contains uncommitted changes: 1. If neither -c/--check nor -C/--clean is specified, and if the requested changeset is an ancestor or descendant of the working directory's parent, the uncommitted changes are merged into the requested changeset and the merged result is left uncommitted. If the requested changeset is not an ancestor or descendant (that is, it is on another branch), the update is aborted and the uncommitted changes are preserved. 2. With the -c/--check option, the update is aborted and the uncommitted changes are preserved. 3. With the -C/--clean option, uncommitted changes are discarded and the working directory is updated to the requested changeset. Use null as the changeset to remove the working directory (like 'hg clone -U'). If you want to update just one file to an older changeset, use 'hg revert'. See 'hg help dates' for a list of formats valid for -d/--date. options: -C --clean discard uncommitted changes (no backup) -c --check check for uncommitted changes -d --date tipmost revision matching date -r --rev revision use "hg -v help update" to show global options
Parameters
Attribute | Description | Value | Required |
---|---|---|---|
cmd | hg command | update | yes |
dir | directory to update | yes | |
clean | overwrite locally modified files (no backup) | true/false, yes/no, on/off | no |
date | tipmost revision matching date | no | |
revision | revision | no | |
check | check for uncommitted changes | true/false, yes/no, on/off | no |
Nested element | Description | Required | |
dirset | resource collections | no | |
arg | command line argument value | no |
Examples
<hg cmd="update" dir="/my/rootdirectory/dir/to/update" revision="1"/>