Mercurial > hg
comparison hgext/convert/__init__.py @ 5484:07bdb5e5d08c
Update convert help text
Add Mercurial as a source format, clarify that the include directive triggers the exclusion of all not explicitely included files/dirs and use MAPFILE instead of revmapfile in the text, following the short message convention.
author | "Rafael Villar Burke <pachi@rvburke.com>" |
---|---|
date | Fri, 02 Nov 2007 20:09:21 +0100 |
parents | 71e7c86adcb7 |
children | 247af577fe29 |
comparison
equal
deleted
inserted
replaced
5483:ec2cc1dadbf7 | 5484:07bdb5e5d08c |
---|---|
297 | 297 |
298 def convert(ui, src, dest=None, revmapfile=None, **opts): | 298 def convert(ui, src, dest=None, revmapfile=None, **opts): |
299 """Convert a foreign SCM repository to a Mercurial one. | 299 """Convert a foreign SCM repository to a Mercurial one. |
300 | 300 |
301 Accepted source formats: | 301 Accepted source formats: |
302 - Mercurial | |
302 - CVS | 303 - CVS |
303 - Darcs | 304 - Darcs |
304 - git | 305 - git |
305 - Subversion | 306 - Subversion |
306 | 307 |
313 | 314 |
314 If no destination directory name is specified, it defaults to the | 315 If no destination directory name is specified, it defaults to the |
315 basename of the source with '-hg' appended. If the destination | 316 basename of the source with '-hg' appended. If the destination |
316 repository doesn't exist, it will be created. | 317 repository doesn't exist, it will be created. |
317 | 318 |
318 If <revmapfile> isn't given, it will be put in a default location | 319 If <MAPFILE> isn't given, it will be put in a default location |
319 (<dest>/.hg/shamap by default). The <revmapfile> is a simple text | 320 (<dest>/.hg/shamap by default). The <MAPFILE> is a simple text |
320 file that maps each source commit ID to the destination ID for | 321 file that maps each source commit ID to the destination ID for |
321 that revision, like so: | 322 that revision, like so: |
322 <source ID> <destination ID> | 323 <source ID> <destination ID> |
323 | 324 |
324 If the file doesn't exist, it's automatically created. It's updated | 325 If the file doesn't exist, it's automatically created. It's updated |
340 exclude path/to/file | 341 exclude path/to/file |
341 | 342 |
342 rename from/file to/file | 343 rename from/file to/file |
343 | 344 |
344 The 'include' directive causes a file, or all files under a | 345 The 'include' directive causes a file, or all files under a |
345 directory, to be included in the destination repository. The | 346 directory, to be included in the destination repository, and the |
346 'exclude' directive causes files or directories to be omitted. | 347 exclussion of all other files and dirs not explicitely included. |
347 The 'rename' directive renames a file or directory. To rename | 348 The 'exclude' directive causes files or directories to be omitted. |
348 from a subdirectory into the root of the repository, use '.' as | 349 The 'rename' directive renames a file or directory. To rename from a |
349 the path to rename to. | 350 subdirectory into the root of the repository, use '.' as the path to |
351 rename to. | |
350 """ | 352 """ |
351 | 353 |
352 util._encoding = 'UTF-8' | 354 util._encoding = 'UTF-8' |
353 | 355 |
354 if not dest: | 356 if not dest: |