Mercurial > hg
comparison hgext/convert/__init__.py @ 7983:7b813bdbd5d0
Change double spaces to single spaces in help texts.
| author | Martin Geisler <mg@daimi.au.dk> |
|---|---|
| date | Sat, 04 Apr 2009 21:09:43 +0200 |
| parents | 026bcd12a0ad |
| children | 468ab22785aa |
comparison
equal
deleted
inserted
replaced
| 7982:cab4a521a3fd | 7983:7b813bdbd5d0 |
|---|---|
| 35 If no revision is given, all revisions will be converted. Otherwise, | 35 If no revision is given, all revisions will be converted. Otherwise, |
| 36 convert will only import up to the named revision (given in a format | 36 convert will only import up to the named revision (given in a format |
| 37 understood by the source). | 37 understood by the source). |
| 38 | 38 |
| 39 If no destination directory name is specified, it defaults to the | 39 If no destination directory name is specified, it defaults to the |
| 40 basename of the source with '-hg' appended. If the destination | 40 basename of the source with '-hg' appended. If the destination |
| 41 repository doesn't exist, it will be created. | 41 repository doesn't exist, it will be created. |
| 42 | 42 |
| 43 If <REVMAP> isn't given, it will be put in a default location | 43 If <REVMAP> isn't given, it will be put in a default location |
| 44 (<dest>/.hg/shamap by default). The <REVMAP> is a simple text | 44 (<dest>/.hg/shamap by default). The <REVMAP> is a simple text |
| 45 file that maps each source commit ID to the destination ID for | 45 file that maps each source commit ID to the destination ID for |
| 46 that revision, like so: | 46 that revision, like so: |
| 47 <source ID> <destination ID> | 47 <source ID> <destination ID> |
| 48 | 48 |
| 49 If the file doesn't exist, it's automatically created. It's updated | 49 If the file doesn't exist, it's automatically created. It's updated |
| 50 on each commit copied, so convert-repo can be interrupted and can | 50 on each commit copied, so convert-repo can be interrupted and can |
| 51 be run repeatedly to copy new commits. | 51 be run repeatedly to copy new commits. |
| 52 | 52 |
| 53 The [username mapping] file is a simple text file that maps each source | 53 The [username mapping] file is a simple text file that maps each source |
| 54 commit author to a destination commit author. It is handy for source SCMs | 54 commit author to a destination commit author. It is handy for source SCMs |
| 55 that use unix logins to identify authors (eg: CVS). One line per author | 55 that use unix logins to identify authors (eg: CVS). One line per author |
| 56 mapping and the line format is: | 56 mapping and the line format is: |
| 57 srcauthor=whatever string you want | 57 srcauthor=whatever string you want |
| 58 | 58 |
| 59 The filemap is a file that allows filtering and remapping of files | 59 The filemap is a file that allows filtering and remapping of files |
| 60 and directories. Comment lines start with '#'. Each line can | 60 and directories. Comment lines start with '#'. Each line can |
| 61 contain one of the following directives: | 61 contain one of the following directives: |
| 62 | 62 |
| 63 include path/to/file | 63 include path/to/file |
| 64 | 64 |
| 65 exclude path/to/file | 65 exclude path/to/file |
| 68 | 68 |
| 69 The 'include' directive causes a file, or all files under a | 69 The 'include' directive causes a file, or all files under a |
| 70 directory, to be included in the destination repository, and the | 70 directory, to be included in the destination repository, and the |
| 71 exclusion of all other files and dirs not explicitely included. | 71 exclusion of all other files and dirs not explicitely included. |
| 72 The 'exclude' directive causes files or directories to be omitted. | 72 The 'exclude' directive causes files or directories to be omitted. |
| 73 The 'rename' directive renames a file or directory. To rename from a | 73 The 'rename' directive renames a file or directory. To rename from a |
| 74 subdirectory into the root of the repository, use '.' as the path to | 74 subdirectory into the root of the repository, use '.' as the path to |
| 75 rename to. | 75 rename to. |
| 76 | 76 |
| 77 The splicemap is a file that allows insertion of synthetic | 77 The splicemap is a file that allows insertion of synthetic |
| 78 history, letting you specify the parents of a revision. This is | 78 history, letting you specify the parents of a revision. This is |
| 79 useful if you want to e.g. give a Subversion merge two parents, or | 79 useful if you want to e.g. give a Subversion merge two parents, or |
| 80 graft two disconnected series of history together. Each entry | 80 graft two disconnected series of history together. Each entry |
| 81 contains a key, followed by a space, followed by one or two | 81 contains a key, followed by a space, followed by one or two |
| 82 comma-separated values. The key is the revision ID in the | 82 comma-separated values. The key is the revision ID in the |
| 83 source revision control system whose parents should be modified | 83 source revision control system whose parents should be modified |
| 84 (same format as a key in .hg/shamap). The values are the revision | 84 (same format as a key in .hg/shamap). The values are the revision |
| 85 IDs (in either the source or destination revision control system) | 85 IDs (in either the source or destination revision control system) |
| 86 that should be used as the new parents for that node. | 86 that should be used as the new parents for that node. |
| 87 | 87 |
| 88 Mercurial Source | 88 Mercurial Source |
| 89 ----------------- | 89 ----------------- |