[F011] Export
This functionality aims to surround : hg export and to adapt it for <ant> tags.
Shell command
hg export [OPTION]... [-o OUTFILESPEC] REV...
dump the header and diffs for one or more changesets
Print the changeset header and diffs for one or more revisions.
The information shown in the changeset header is: author, changeset hash,
parent(s) and commit comment.
NOTE: export may generate unexpected diff output for merge changesets, as
it will compare the merge changeset against its first parent only.
Output may be to a file, in which case the name of the file is given using
a format string. The formatting rules are as follows:
"%%" literal "%" character
"%H" changeset hash (40 bytes of hexadecimal)
"%N" number of patches being generated
"%R" changeset revision number
"%b" basename of the exporting repository
"%h" short-form changeset hash (12 bytes of hexadecimal)
"%n" zero-padded sequence number, starting at 1
"%r" zero-padded changeset revision number
Without the -a/--text option, export will avoid generating diffs of files
it detects as binary. With -a, export will generate a diff anyway,
probably with undesirable results.
Use the -g/--git option to generate diffs in the git extended diff format.
See 'hg help diffs' for more information.
With the --switch-parent option, the diff will be against the second
parent. It can be useful to review a merge.
options:
-o --output print output to file with formatted name
--switch-parent diff against the second parent
-a --text treat all files as text
-g --git use git extended diff format
--nodates don't include dates in diff headers
use "hg -v help export" to show global options
Parameters
| Attribute | Description | Value | Required |
|---|---|---|---|
| cmd | hg command | export | yes |
| dir | the directory to export | yes | |
| revision | the revision(s) to export | R1[;R2;...] | yes |
| output | print output to file with formatted name | no | |
| switchparent | diff against the second parent | true/false, yes/no, on/off | no |
| text | treat all files as text | true/false, yes/no, on/off | no |
| git | use git extended diff format | true/false, yes/no, on/off | no |
| nodates | don't include dates in diff headers | true/false, yes/no, on/off | no |
| Nested element | Description | Required | |
| dirset | resource collections | no | |
| arg | command line argument value | no | |
Examples
<hg cmd="export" dir="/my/directory/to/export"/>