comparison hgext/convert/__init__.py @ 12185:6a94459b7afa stable

convert: better quoting in help text
author Martin Geisler <mg@lazybytes.net>
date Fri, 10 Sep 2010 00:30:36 +0200
parents 025ca07351ea
children 3417b3d95b05
comparison
equal deleted inserted replaced
12184:025ca07351ea 12185:6a94459b7afa
38 If no revision is given, all revisions will be converted. 38 If no revision is given, all revisions will be converted.
39 Otherwise, convert will only import up to the named revision 39 Otherwise, convert will only import up to the named revision
40 (given in a format understood by the source). 40 (given in a format understood by the source).
41 41
42 If no destination directory name is specified, it defaults to the 42 If no destination directory name is specified, it defaults to the
43 basename of the source with '-hg' appended. If the destination 43 basename of the source with ``-hg`` appended. If the destination
44 repository doesn't exist, it will be created. 44 repository doesn't exist, it will be created.
45 45
46 By default, all sources except Mercurial will use --branchsort. 46 By default, all sources except Mercurial will use --branchsort.
47 Mercurial uses --sourcesort to preserve original revision numbers 47 Mercurial uses --sourcesort to preserve original revision numbers
48 order. Sort modes have the following effects: 48 order. Sort modes have the following effects:
87 87
88 exclude path/to/file-or-dir 88 exclude path/to/file-or-dir
89 89
90 rename path/to/source path/to/destination 90 rename path/to/source path/to/destination
91 91
92 Comment lines start with '#'. A specificed path matches if it 92 Comment lines start with ``#``. A specificed path matches if it
93 equals the full relative name of a file or one of its parent 93 equals the full relative name of a file or one of its parent
94 directories. The 'include' or 'exclude' directive with the longest 94 directories. The ``include`` or ``exclude`` directive with the
95 matching path applies, so line order does not matter. 95 longest matching path applies, so line order does not matter.
96 96
97 The 'include' directive causes a file, or all files under a 97 The ``include`` directive causes a file, or all files under a
98 directory, to be included in the destination repository, and the 98 directory, to be included in the destination repository, and the
99 exclusion of all other files and directories not explicitly 99 exclusion of all other files and directories not explicitly
100 included. The 'exclude' directive causes files or directories to 100 included. The ``exclude`` directive causes files or directories to
101 be omitted. The 'rename' directive renames a file or directory if 101 be omitted. The ``rename`` directive renames a file or directory if
102 is converted. To rename from a subdirectory into the root of the 102 is converted. To rename from a subdirectory into the root of the
103 repository, use '.' as the path to rename to. 103 repository, use ``.`` as the path to rename to.
104 104
105 The splicemap is a file that allows insertion of synthetic 105 The splicemap is a file that allows insertion of synthetic
106 history, letting you specify the parents of a revision. This is 106 history, letting you specify the parents of a revision. This is
107 useful if you want to e.g. give a Subversion merge two parents, or 107 useful if you want to e.g. give a Subversion merge two parents, or
108 graft two disconnected series of history together. Each entry 108 graft two disconnected series of history together. Each entry