comparison tests/test-convert.out @ 8692:827d4e807d57

convert: default revisions order depends on source When converting Mercurial repositories you expect the revision numbers to be preserved, while other sources conversions focus on efficiency.
author Patrick Mezard <pmezard@gmail.com>
date Mon, 01 Jun 2009 17:12:41 +0200
parents c5b4f662109f
children d2ef4f2b904a
comparison
equal deleted inserted replaced
8691:a0a541d6fed6 8692:827d4e807d57
22 (given in a format understood by the source). 22 (given in a format understood by the source).
23 23
24 If no destination directory name is specified, it defaults to the 24 If no destination directory name is specified, it defaults to the
25 basename of the source with '-hg' appended. If the destination 25 basename of the source with '-hg' appended. If the destination
26 repository doesn't exist, it will be created. 26 repository doesn't exist, it will be created.
27
28 By default, all sources except Mercurial will use
29 --branchsort. Mercurial uses --sourcesort to preserve original
30 revision numbers order. Sort modes have the following effects:
31 --branchsort: convert from parent to child revision when
32 possible, which means branches are usually converted one after
33 the other. It generates more compact repositories.
34 --datesort: sort revisions by date. Converted repositories have
35 good-looking changelogs but are often an order of magnitude
36 larger than the same ones generated by --branchsort.
37 --sourcesort: try to preserve source revisions order, only
38 supported by Mercurial sources.
27 39
28 If <REVMAP> isn't given, it will be put in a default location 40 If <REVMAP> isn't given, it will be put in a default location
29 (<dest>/.hg/shamap by default). The <REVMAP> is a simple text file 41 (<dest>/.hg/shamap by default). The <REVMAP> is a simple text file
30 that maps each source commit ID to the destination ID for that 42 that maps each source commit ID to the destination ID for that
31 revision, like so: 43 revision, like so:
207 --filemap remap file names using contents of file 219 --filemap remap file names using contents of file
208 -r --rev import up to target revision REV 220 -r --rev import up to target revision REV
209 -s --source-type source repository type 221 -s --source-type source repository type
210 --splicemap splice synthesized history into place 222 --splicemap splice synthesized history into place
211 --branchmap change branch names while converting 223 --branchmap change branch names while converting
224 --branchsort try to sort changesets by branches
212 --datesort try to sort changesets by date 225 --datesort try to sort changesets by date
213 --sourcesort preserve source changesets order 226 --sourcesort preserve source changesets order
214 227
215 use "hg -v help convert" to show global options 228 use "hg -v help convert" to show global options
216 adding a 229 adding a