273 If no revision is given, all revisions will be converted. Otherwise, |
273 If no revision is given, all revisions will be converted. Otherwise, |
274 convert will only import up to the named revision (given in a format |
274 convert will only import up to the named revision (given in a format |
275 understood by the source). |
275 understood by the source). |
276 |
276 |
277 If no destination directory name is specified, it defaults to the |
277 If no destination directory name is specified, it defaults to the |
278 basename of the source with '-hg' appended. If the destination |
278 basename of the source with \'-hg\' appended. If the destination |
279 repository doesn't exist, it will be created. |
279 repository doesn\'t exist, it will be created. |
280 |
280 |
281 If <mapfile> isn't given, it will be put in a default location |
281 If <mapfile> isn\'t given, it will be put in a default location |
282 (<dest>/.hg/shamap by default). The <mapfile> is a simple text |
282 (<dest>/.hg/shamap by default). The <mapfile> is a simple text |
283 file that maps each source commit ID to the destination ID for |
283 file that maps each source commit ID to the destination ID for |
284 that revision, like so: |
284 that revision, like so: |
285 <source ID> <destination ID> |
285 <source ID> <destination ID> |
286 |
286 |
287 If the file doesn't exist, it's automatically created. It's updated |
287 If the file doesn\'t exist, it\'s automatically created. It\'s updated |
288 on each commit copied, so convert-repo can be interrupted and can |
288 on each commit copied, so convert-repo can be interrupted and can |
289 be run repeatedly to copy new commits. |
289 be run repeatedly to copy new commits. |
290 |
290 |
291 The [username mapping] file is a simple text file that maps each source |
291 The [username mapping] file is a simple text file that maps each source |
292 commit author to a destination commit author. It is handy for source SCMs |
292 commit author to a destination commit author. It is handy for source SCMs |