Mercurial > hg

comparison tests/test-convert.t @ 12924:2f1174b2c4fa

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
convert: better ReST markup in docstring
author Martin Geisler <mg@aragost.com>
date Thu, 04 Nov 2010 18:19:10 +0100
parents 58f0c60b7f40
children 4936a04b6792
comparison
equal deleted inserted replaced
12923:7d384a372ce8 12924:2f1174b2c4fa
46 looking changelogs but are often an order of magnitude 46 looking changelogs but are often an order of magnitude
47 larger than the same ones generated by --branchsort. 47 larger than the same ones generated by --branchsort.
48 --sourcesort try to preserve source revisions order, only supported by 48 --sourcesort try to preserve source revisions order, only supported by
49 Mercurial sources. 49 Mercurial sources.
50 50
51 If <REVMAP> isn't given, it will be put in a default location 51 If "REVMAP" isn't given, it will be put in a default location
52 (<dest>/.hg/shamap by default). The <REVMAP> is a simple text file that 52 ("<dest>/.hg/shamap" by default). The "REVMAP" is a simple text file that
53 maps each source commit ID to the destination ID for that revision, like 53 maps each source commit ID to the destination ID for that revision, like
54 so: 54 so:
55 55
56 <source ID> <destination ID> 56 <source ID> <destination ID>
57 57
141 '''''''''' 141 ''''''''''
142 142
143 CVS source will use a sandbox (i.e. a checked-out copy) from CVS to 143 CVS source will use a sandbox (i.e. a checked-out copy) from CVS to
144 indicate the starting point of what will be converted. Direct access to 144 indicate the starting point of what will be converted. Direct access to
145 the repository files is not needed, unless of course the repository is 145 the repository files is not needed, unless of course the repository is
146 :local:. The conversion uses the top level directory in the sandbox to 146 ":local:". The conversion uses the top level directory in the sandbox to
147 find the CVS repository, and then uses CVS rlog commands to find files to 147 find the CVS repository, and then uses CVS rlog commands to find files to
148 convert. This means that unless a filemap is given, all files under the 148 convert. This means that unless a filemap is given, all files under the
149 starting directory will be converted, and that any directory 149 starting directory will be converted, and that any directory
150 reorganization in the CVS sandbox is ignored. 150 reorganization in the CVS sandbox is ignored.
151 151
203 203
204 The following options can be set with "--config": 204 The following options can be set with "--config":
205 205
206 convert.svn.branches 206 convert.svn.branches
207 specify the directory containing branches. The defaults is 207 specify the directory containing branches. The defaults is
208 branches. 208 "branches".
209 convert.svn.tags 209 convert.svn.tags
210 specify the directory containing tags. The default is tags. 210 specify the directory containing tags. The default is "tags".
211 convert.svn.trunk 211 convert.svn.trunk
212 specify the name of the trunk branch The defauls is trunk. 212 specify the name of the trunk branch The defauls is "trunk".
213 213
214 Source history can be retrieved starting at a specific revision, instead 214 Source history can be retrieved starting at a specific revision, instead
215 of being integrally converted. Only single branch conversions are 215 of being integrally converted. Only single branch conversions are
216 supported. 216 supported.
217 217
223 223
224 The Perforce (P4) importer can be given a p4 depot path or a client 224 The Perforce (P4) importer can be given a p4 depot path or a client
225 specification as source. It will convert all files in the source to a flat 225 specification as source. It will convert all files in the source to a flat
226 Mercurial repository, ignoring labels, branches and integrations. Note 226 Mercurial repository, ignoring labels, branches and integrations. Note
227 that when a depot path is given you then usually should specify a target 227 that when a depot path is given you then usually should specify a target
228 directory, because otherwise the target may be named ...-hg. 228 directory, because otherwise the target may be named "...-hg".
229 229
230 It is possible to limit the amount of source history to be converted by 230 It is possible to limit the amount of source history to be converted by
231 specifying an initial Perforce revision: 231 specifying an initial Perforce revision:
232 232
233 convert.p4.startrev 233 convert.p4.startrev