121 to a named branch. |
121 to a named branch. |
122 |
122 |
123 Mercurial Source |
123 Mercurial Source |
124 '''''''''''''''' |
124 '''''''''''''''' |
125 |
125 |
126 --config convert.hg.ignoreerrors=False (boolean) |
126 The Mercurial source recognizes the following configuration options, which |
127 ignore integrity errors when reading. Use it to fix Mercurial |
127 you can set on the command line with "--config": |
128 repositories with missing revlogs, by converting from and to |
128 |
129 Mercurial. |
129 convert.hg.ignoreerrors |
130 |
130 ignore integrity errors when reading. Use it to fix Mercurial |
131 --config convert.hg.saverev=False (boolean) |
131 repositories with missing revlogs, by converting from and to |
132 store original revision ID in changeset (forces target IDs to change) |
132 Mercurial. Default is False. |
133 |
133 convert.hg.saverev |
134 --config convert.hg.startrev=0 (hg revision identifier) |
134 store original. revision ID in changeset (forces target IDs to |
135 convert start revision and its descendants |
135 change). It takes and boolean argument and defaults to False. |
|
136 convert.hg.startrev |
|
137 convert start revision and its descendants. It takes a hg |
|
138 revision identifier and defaults to 0. |
136 |
139 |
137 CVS Source |
140 CVS Source |
138 '''''''''' |
141 '''''''''' |
139 |
142 |
140 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 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 |
145 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 |
146 starting directory will be converted, and that any directory |
149 starting directory will be converted, and that any directory |
147 reorganization in the CVS sandbox is ignored. |
150 reorganization in the CVS sandbox is ignored. |
148 |
151 |
149 The options shown are the defaults. |
152 The following options can be used with "--config": |
150 |
153 |
151 --config convert.cvsps.cache=True (boolean) |
154 convert.cvsps.cache |
152 Set to False to disable remote log caching, for testing and debugging |
155 Set to False to disable remote log caching, for testing and |
153 purposes. |
156 debugging purposes. Default is True. |
154 |
157 convert.cvsps.fuzz |
155 --config convert.cvsps.fuzz=60 (integer) |
158 Specify the maximum time (in seconds) that is allowed between |
156 Specify the maximum time (in seconds) that is allowed between commits |
159 commits with identical user and log message in a single |
157 with identical user and log message in a single changeset. When very |
160 changeset. When very large files were checked in as part of a |
158 large files were checked in as part of a changeset then the default |
161 changeset then the default may not be long enough. The default |
159 may not be long enough. |
162 is 60. |
160 |
163 convert.cvsps.mergeto |
161 --config convert.cvsps.mergeto='{{mergetobranch ([-\w]+)}}' |
164 Specify a regular expression to which commit log messages are |
162 Specify a regular expression to which commit log messages are matched. |
165 matched. If a match occurs, then the conversion process will |
163 If a match occurs, then the conversion process will insert a dummy |
166 insert a dummy revision merging the branch on which this log |
164 revision merging the branch on which this log message occurs to the |
167 message occurs to the branch indicated in the regex. Default |
165 branch indicated in the regex. |
168 is "{{mergetobranch ([-\w]+)}}" |
166 |
169 convert.cvsps.mergefrom |
167 --config convert.cvsps.mergefrom='{{mergefrombranch ([-\w]+)}}' |
170 Specify a regular expression to which commit log messages are |
168 Specify a regular expression to which commit log messages are matched. |
171 matched. If a match occurs, then the conversion process will |
169 If a match occurs, then the conversion process will add the most |
172 add the most recent revision on the branch indicated in the |
170 recent revision on the branch indicated in the regex as the second |
173 regex as the second parent of the changeset. Default is |
171 parent of the changeset. |
174 "{{mergefrombranch ([-\w]+)}}" |
172 |
175 hook.cvslog |
173 --config hook.cvslog |
176 Specify a Python function to be called at the end of gathering |
174 Specify a Python function to be called at the end of gathering the CVS |
177 the CVS log. The function is passed a list with the log |
175 log. The function is passed a list with the log entries, and can |
178 entries, and can modify the entries in-place, or add or delete |
176 modify the entries in-place, or add or delete them. |
179 them. |
177 |
180 hook.cvschangesets |
178 --config hook.cvschangesets |
181 Specify a Python function to be called after the changesets |
179 Specify a Python function to be called after the changesets are |
182 are calculated from the the CVS log. The function is passed a |
180 calculated from the the CVS log. The function is passed a list with |
183 list with the changeset entries, and can modify the changesets |
181 the changeset entries, and can modify the changesets in-place, or add |
184 in-place, or add or delete them. |
182 or delete them. |
|
183 |
185 |
184 An additional "debugcvsps" Mercurial command allows the builtin changeset |
186 An additional "debugcvsps" Mercurial command allows the builtin changeset |
185 merging code to be run without doing a conversion. Its parameters and |
187 merging code to be run without doing a conversion. Its parameters and |
186 output are similar to that of cvsps 2.1. Please see the command help for |
188 output are similar to that of cvsps 2.1. Please see the command help for |
187 more details. |
189 more details. |
197 looked for tags referencing converted branches. Default "trunk", |
199 looked for tags referencing converted branches. Default "trunk", |
198 "branches" and "tags" values can be overridden with following options. Set |
200 "branches" and "tags" values can be overridden with following options. Set |
199 them to paths relative to the source URL, or leave them blank to disable |
201 them to paths relative to the source URL, or leave them blank to disable |
200 auto detection. |
202 auto detection. |
201 |
203 |
202 --config convert.svn.branches=branches (directory name) |
204 The following options can be set with "--config": |
203 specify the directory containing branches |
205 |
204 |
206 convert.svn.branches |
205 --config convert.svn.tags=tags (directory name) |
207 specify the directory containing branches. The defaults is |
206 specify the directory containing tags |
208 branches. |
207 |
209 convert.svn.tags |
208 --config convert.svn.trunk=trunk (directory name) |
210 specify the directory containing tags. The default is tags. |
209 specify the name of the trunk branch |
211 convert.svn.trunk |
|
212 specify the name of the trunk branch The defauls is trunk. |
210 |
213 |
211 Source history can be retrieved starting at a specific revision, instead |
214 Source history can be retrieved starting at a specific revision, instead |
212 of being integrally converted. Only single branch conversions are |
215 of being integrally converted. Only single branch conversions are |
213 supported. |
216 supported. |
214 |
217 |
215 --config convert.svn.startrev=0 (svn revision number) |
218 convert.svn.startrev |
216 specify start Subversion revision. |
219 specify start Subversion revision number. The default is 0. |
217 |
220 |
218 Perforce Source |
221 Perforce Source |
219 ''''''''''''''' |
222 ''''''''''''''' |
220 |
223 |
221 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 |
223 Mercurial repository, ignoring labels, branches and integrations. Note |
226 Mercurial repository, ignoring labels, branches and integrations. Note |
224 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 |
225 directory, because otherwise the target may be named ...-hg. |
228 directory, because otherwise the target may be named ...-hg. |
226 |
229 |
227 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 |
228 specifying an initial Perforce revision. |
231 specifying an initial Perforce revision: |
229 |
232 |
230 --config convert.p4.startrev=0 (perforce changelist number) |
233 convert.p4.startrev |
231 specify initial Perforce revision. |
234 specify initial Perforce revision, a Perforce changelist |
|
235 number). |
232 |
236 |
233 Mercurial Destination |
237 Mercurial Destination |
234 ''''''''''''''''''''' |
238 ''''''''''''''''''''' |
235 |
239 |
236 --config convert.hg.clonebranches=False (boolean) |
240 The following options are supported: |
237 dispatch source branches in separate clones. |
241 |
238 |
242 convert.hg.clonebranches |
239 --config convert.hg.tagsbranch=default (branch name) |
243 dispatch source branches in separate clones. The default is |
240 tag revisions branch name |
244 False. |
241 |
245 convert.hg.tagsbranch |
242 --config convert.hg.usebranchnames=True (boolean) |
246 branch name for tag revisions, defaults to "default". |
243 preserve branch names |
247 convert.hg.usebranchnames |
|
248 preserve branch names. The default is True |
244 |
249 |
245 options: |
250 options: |
246 |
251 |
247 -s --source-type TYPE source repository type |
252 -s --source-type TYPE source repository type |
248 -d --dest-type TYPE destination repository type |
253 -d --dest-type TYPE destination repository type |