1 # (Be in -*- python -*- mode.)
3 # ====================================================================
4 # Copyright (c) 2006-2007 CollabNet. All rights reserved.
6 # This software is licensed as described in the file COPYING, which
7 # you should have received as part of this distribution. The terms
8 # are also available at http://subversion.tigris.org/license-1.html.
9 # If newer versions of this license are posted there, you may use a
10 # newer version instead, at your option.
12 # This software consists of voluntary contributions made by many
13 # individuals. For exact contribution history, see the revision
14 # history and logs, available at http://cvs2svn.tigris.org/.
15 # ====================================================================
17 # #####################
18 # ## PLEASE READ ME! ##
19 # #####################
21 # This is a template for an options file that can be used to configure
22 # cvs2svn. Many options do not have defaults, so it is easier to copy
23 # this file and modify what you need rather than creating a new
24 # options file from scratch.
26 # This file is in Python syntax, but you don't need to know Python to
27 # modify it. But if you *do* know Python, then you will be happy to
28 # know that you can use arbitary Python constructs to do fancy
29 # configuration tricks.
31 # But please be aware of the following:
33 # * In many places, leading whitespace is significant in Python (it is
34 # used instead of curly braces to group statements together).
35 # Therefore, if you don't know what you are doing, it is best to
36 # leave the whitespace as it is.
38 # * In normal strings, Python uses backslashes ("\") are used as an
39 # escape character. Therefore you need to be careful, especially
40 # when specifying regular expressions or Windows filenames. It is
41 # recommended that you use "raw strings" for these cases.
42 # Backslashes in raw strings are treated literally. A raw string is
43 # written by prefixing an "r" character to a string. Example:
45 # ctx.sort_executable = r'c:\windows\system32\sort.exe'
47 # Two identifiers will have been defined before this file is executed,
48 # and can be used freely within this file:
50 # ctx -- a Ctx object (see cvs2svn_lib/context.py), which holds
51 # many configuration options
53 # run_options -- an instance of the OptionsFileRunOptions class
54 # (see cvs2svn_lib/run_options.py), which holds some variables
55 # governing how cvs2svn is run
58 # Import some modules that are used in setting the options:
61 from cvs2svn_lib import config
62 from cvs2svn_lib import changeset_database
63 from cvs2svn_lib.common import CVSTextDecoder
64 from cvs2svn_lib.log import Log
65 from cvs2svn_lib.project import Project
66 from cvs2svn_lib.svn_output_option import DumpfileOutputOption
67 from cvs2svn_lib.svn_output_option import ExistingRepositoryOutputOption
68 from cvs2svn_lib.svn_output_option import NewRepositoryOutputOption
69 from cvs2svn_lib.revision_manager import NullRevisionRecorder
70 from cvs2svn_lib.revision_manager import NullRevisionExcluder
71 from cvs2svn_lib.rcs_revision_manager import RCSRevisionReader
72 from cvs2svn_lib.cvs_revision_manager import CVSRevisionReader
73 from cvs2svn_lib.checkout_internal import InternalRevisionRecorder
74 from cvs2svn_lib.checkout_internal import InternalRevisionExcluder
75 from cvs2svn_lib.checkout_internal import InternalRevisionReader
76 from cvs2svn_lib.symbol_strategy import AllBranchRule
77 from cvs2svn_lib.symbol_strategy import AllTagRule
78 from cvs2svn_lib.symbol_strategy import BranchIfCommitsRule
79 from cvs2svn_lib.symbol_strategy import ExcludeRegexpStrategyRule
80 from cvs2svn_lib.symbol_strategy import ForceBranchRegexpStrategyRule
81 from cvs2svn_lib.symbol_strategy import ForceTagRegexpStrategyRule
82 from cvs2svn_lib.symbol_strategy import ExcludeTrivialImportBranchRule
83 from cvs2svn_lib.symbol_strategy import ExcludeVendorBranchRule
84 from cvs2svn_lib.symbol_strategy import HeuristicStrategyRule
85 from cvs2svn_lib.symbol_strategy import UnambiguousUsageRule
86 from cvs2svn_lib.symbol_strategy import HeuristicPreferredParentRule
87 from cvs2svn_lib.symbol_strategy import SymbolHintsFileRule
88 from cvs2svn_lib.symbol_transform import ReplaceSubstringsSymbolTransform
89 from cvs2svn_lib.symbol_transform import RegexpSymbolTransform
90 from cvs2svn_lib.symbol_transform import NormalizePathsSymbolTransform
91 from cvs2svn_lib.property_setters import AutoPropsPropertySetter
92 from cvs2svn_lib.property_setters import CVSBinaryFileDefaultMimeTypeSetter
93 from cvs2svn_lib.property_setters import CVSBinaryFileEOLStyleSetter
94 from cvs2svn_lib.property_setters import CVSRevisionNumberSetter
95 from cvs2svn_lib.property_setters import DefaultEOLStyleSetter
96 from cvs2svn_lib.property_setters import EOLStyleFromMimeTypeSetter
97 from cvs2svn_lib.property_setters import ExecutablePropertySetter
98 from cvs2svn_lib.property_setters import KeywordsPropertySetter
99 from cvs2svn_lib.property_setters import MimeMapper
100 from cvs2svn_lib.property_setters import SVNBinaryFileKeywordsPropertySetter
102 # To choose the level of logging output, uncomment one of the
104 #Log().log_level = Log.WARN
105 #Log().log_level = Log.QUIET
106 Log().log_level = Log.NORMAL
107 #Log().log_level = Log.VERBOSE
108 #Log().log_level = Log.DEBUG
111 # There are several possible options for where to put the output of a
112 # cvs2svn conversion. Please choose one of the following and adjust
113 # the parameters as necessary:
115 # Use this output option if you would like cvs2svn to create a new SVN
116 # repository and store the converted repository there. The first
117 # argument is the path to which the repository should be written (this
118 # repository must not already exist). The second (optional) argument
119 # allows a --fs-type option to be passed to "svnadmin create". The
120 # third (optional) argument can be specified to set the
121 # --bdb-txn-nosync option on a bdb repository. The fourth (optional)
122 # argument can be specified to set a list of verbatim options to be passed
123 # to "svnadmin create":
124 ctx.output_option = NewRepositoryOutputOption(
125 r'/path/to/svnrepo', # Path to repository
126 #fs_type='fsfs', # Type of repository to create
127 #bdb_txn_nosync=False, # For bsd repositories, this option can be added
128 #create_options=['--pre-1.5-compatible'], # Options for "svnadmin create"
131 # Use this output option if you would like cvs2svn to store the
132 # converted CVS repository into an SVN repository that already exists.
133 # The argument is the filesystem path of an existing local SVN
134 # repository (this repository must already exist):
135 #ctx.output_option = ExistingRepositoryOutputOption(
136 # r'/path/to/svnrepo', # Path to repository
139 # Use this type of output option if you want the output of the
140 # conversion to be written to a SVN dumpfile instead of committing
141 # them into an actual repository:
142 #ctx.output_option = DumpfileOutputOption(
143 # dumpfile_path=r'/path/to/cvs2svn-dump', # Name of dumpfile to create
147 # Independent of the ctx.output_option selected, the following option
148 # can be set to True to suppress cvs2svn output altogether:
151 # The following set of options specifies how the revision contents of
152 # the RCS files should be read.
154 # The default selection is InternalRevisionReader, which uses built-in
155 # code that reads the RCS deltas while parsing the files in
156 # CollectRevsPass. This method is very fast but requires lots of
157 # temporary disk space. The disk space is required for (1) storing
158 # all of the RCS deltas, and (2) during OutputPass, keeping a copy of
159 # the full text of every revision that still has a descendant that
160 # hasn't yet been committed. Since this can includes multiple
161 # revisions of each file (i.e., on multiple branches), the required
162 # amount of temporary space can potentially be many times the size of
163 # a checked out copy of the whole repository. Setting compress=True
164 # cuts the disk space requirements by about 50% at the price of
165 # increased CPU usage. Using compression usually speeds up the
166 # conversion due to the reduced I/O pressure, unless --tmpdir is on a
167 # RAM disk. This method does not expand CVS's "Log" keywords.
169 # The second possibility is RCSRevisionReader, which uses RCS's "co"
170 # program to extract the revision contents of the RCS files during
171 # OutputPass. This option doesn't require any temporary space, but it
172 # is relatively slow because (1) "co" has to be executed very many
173 # times; and (2) "co" itself has to assemble many file deltas to
174 # compute the contents of a particular revision. The constructor
175 # argument specifies how to invoke the "co" executable.
177 # The third possibility is CVSRevisionReader, which uses the "cvs"
178 # program to extract the revision contents out of the RCS files during
179 # OutputPass. This option doesn't require any temporary space, but it
180 # is the slowest of all, because "cvs" is considerably slower than
181 # "co". However, it works in some situations where RCSRevisionReader
182 # fails; see the HTML documentation of the "--use-cvs" option for
183 # details. The constructor argument specifies how to invoke the "co"
186 # Choose one of the following three groups of lines:
187 ctx.revision_recorder = InternalRevisionRecorder(compress=True)
188 ctx.revision_excluder = InternalRevisionExcluder()
189 ctx.revision_reader = InternalRevisionReader(compress=True)
191 #ctx.revision_recorder = NullRevisionRecorder()
192 #ctx.revision_excluder = NullRevisionExcluder()
193 #ctx.revision_reader = RCSRevisionReader(co_executable=r'co')
195 #ctx.revision_recorder = NullRevisionRecorder()
196 #ctx.revision_excluder = NullRevisionExcluder()
197 #ctx.revision_reader = CVSRevisionReader(cvs_executable=r'cvs')
199 # Set the name (and optionally the path) of some other executables
200 # required by cvs2svn:
201 ctx.svnadmin_executable = r'svnadmin'
202 ctx.sort_executable = r'sort'
204 # Change the following line to True if the conversion should only
205 # include the trunk of the repository (i.e., all branches and tags
206 # should be ignored):
207 ctx.trunk_only = False
209 # Change the following line to True if cvs2svn should delete a
210 # directory once the last file has been deleted from it:
213 # How to convert author names, log messages, and filenames to unicode.
214 # The first argument to CVSTextDecoder is a list of encoders that are
215 # tried in order in 'strict' mode until one of them succeeds. If none
216 # of those succeeds, then fallback_encoder is used in lossy 'replace'
217 # mode (if it is specified). Setting a fallback encoder ensures that
218 # the encoder always succeeds, but it can cause information loss.
219 ctx.cvs_author_decoder = CVSTextDecoder(
225 #fallback_encoding='ascii'
227 ctx.cvs_log_decoder = CVSTextDecoder(
233 #fallback_encoding='ascii'
235 # You might want to be especially strict when converting filenames to
236 # unicode (e.g., maybe not specify a fallback_encoding).
237 ctx.cvs_filename_decoder = CVSTextDecoder(
243 #fallback_encoding='ascii'
246 # Template for the commit message to be used for initial project
248 ctx.initial_project_commit_message = (
249 'Standard project directories initialized by cvs2svn.'
252 # Template for the commit message to be used for post commits, in
253 # which modifications to a vendor branch are copied back to trunk.
254 # This message can use '%(revnum)d' to include the revision number of
255 # the revision that included the change to the vendor branch.
256 ctx.post_commit_message = (
257 'This commit was generated by cvs2svn to compensate for '
258 'changes in r%(revnum)d, which included commits to RCS files '
259 'with non-trunk default branches.'
262 # Template for the commit message to be used for commits in which
263 # symbols are created. This message can use '%(symbol_type)d' to
264 # include the type of the symbol ('branch' or 'tag') or
265 # '%(symbol_name)' to include the name of the symbol.
266 ctx.symbol_commit_message = (
267 "This commit was manufactured by cvs2svn to create %(symbol_type)s "
271 # Some CVS clients for MacOS store resource fork data into CVS along
272 # with the file contents itself by wrapping it all up in a container
273 # format called "AppleSingle". Subversion currently does not support
274 # MacOS resource forks. Nevertheless, sometimes the resource fork
275 # information is not necessary and can be discarded. Set the
276 # following option to True if you would like cvs2svn to identify files
277 # whose contents are encoded in AppleSingle format, and discard all
278 # but the data fork for such files before committing them to
279 # Subversion. (Please note that AppleSingle contents are identified
280 # by the AppleSingle magic number as the first four bytes of the file.
281 # This check is not failproof, so only set this option if you think
283 ctx.decode_apple_single = False
285 # This option can be set to the name of a filename to which are stored
286 # statistics and conversion decisions about the CVS symbols.
287 ctx.symbol_info_filename = None
288 #ctx.symbol_info_filename = 'symbol-info.txt'
290 # cvs2svn uses "symbol strategy rules" to help decide how to handle
291 # CVS symbols. The rules in a project's symbol_strategy_rules are
292 # applied in order, and each rule is allowed to modify the symbol.
293 # The result (after each of the rules has been applied) is used for
296 # 1. A CVS symbol might be used as a tag in one file and as a branch
297 # in another file. cvs2svn has to decide whether to convert such a
298 # symbol as a tag or as a branch. cvs2svn uses a series of
299 # heuristic rules to decide how to convert a symbol. The user can
300 # override the default rules for specific symbols or symbols
301 # matching regular expressions.
303 # 2. cvs2svn is also capable of excluding symbols from the conversion
304 # (provided no other symbols depend on them.
306 # 3. CVS does not record unambiguously the line of development from
307 # which a symbol sprouted. cvs2svn uses a heuristic to choose a
308 # symbol's "preferred parents".
310 # The standard branch/tag/exclude StrategyRules do not change a symbol
311 # that has already been processed by an earlier rule, so in effect the
312 # first matching rule is the one that is used.
314 global_symbol_strategy_rules = [
315 # It is possible to specify manually exactly how symbols should be
316 # converted and what line of development should be used as the
317 # preferred parent. To do so, create a file containing the symbol
318 # hints and enable the following option.
320 # The format of the hints file is described in the documentation
321 # for the SymbolHintsFileRule class in
322 # cvs2svn_lib/symbol_strategy.py. The file output by the
323 # --write-symbol-info (i.e., ctx.symbol_info_filename) option is
324 # in the same format. The simplest way to use this option is to
325 # run the conversion through CollateSymbolsPass with
326 # --write-symbol-info option, copy the symbol info and edit it to
327 # create a hints file, then re-start the conversion at
328 # CollateSymbolsPass with this option enabled.
329 #SymbolHintsFileRule('symbol-hints.txt'),
331 # To force all symbols matching a regular expression to be
332 # converted as branches, add rules like the following:
333 #ForceBranchRegexpStrategyRule(r'branch.*'),
335 # To force all symbols matching a regular expression to be
336 # converted as tags, add rules like the following:
337 #ForceTagRegexpStrategyRule(r'tag.*'),
339 # To force all symbols matching a regular expression to be
340 # excluded from the conversion, add rules like the following:
341 #ExcludeRegexpStrategyRule(r'unknown-.*'),
343 # Sometimes people use "cvs import" to get their own source code
344 # into CVS. This practice creates a vendor branch 1.1.1 and
345 # imports the code onto the vendor branch as 1.1.1.1, then copies
346 # the same content to the trunk as version 1.1. Normally, such
347 # vendor branches are useless and they complicate the SVN history
348 # unnecessarily. The following rule excludes any branches that
349 # only existed as a vendor branch with a single import (leaving
350 # only the 1.1 revision). If you want to retain such branches,
351 # comment out the following line. (Please note that this rule
352 # does not exclude vendor *tags*, as they are not so easy to
354 ExcludeTrivialImportBranchRule(),
356 # To exclude all vendor branches (branches that had "cvs import"s
357 # on them bug no other kinds of commits), uncomment the following
359 #ExcludeVendorBranchRule(),
361 # Usually you want this rule, to convert unambiguous symbols
362 # (symbols that were only ever used as tags or only ever used as
363 # branches in CVS) the same way they were used in CVS:
364 UnambiguousUsageRule(),
366 # If there was ever a commit on a symbol, then it cannot be
367 # converted as a tag. This rule causes all such symbols to be
368 # converted as branches. If you would like to resolve such
369 # ambiguities manually, comment out the following line:
370 BranchIfCommitsRule(),
372 # Last in the list can be a catch-all rule that is used for
373 # symbols that were not matched by any of the more specific rules
374 # above. (Assuming that BranchIfCommitsRule() was included above,
375 # then the symbols that are still indeterminate at this point can
376 # sensibly be converted as branches or tags.) Include at most one
377 # of these lines. If none of these catch-all rules are included,
378 # then the presence of any ambiguous symbols (that haven't been
379 # disambiguated above) is an error:
381 # Convert ambiguous symbols based on whether they were used more
382 # often as branches or as tags:
383 HeuristicStrategyRule(),
384 # Convert all ambiguous symbols as branches:
386 # Convert all ambiguous symbols as tags:
389 # The last rule is here to choose the preferred parent of branches
390 # and tags, that is, the line of development from which the symbol
392 HeuristicPreferredParentRule(),
395 # Specify a username to be used for commits generated by cvs2svn. If
396 # this options is set to None then no username will be used for such
399 #ctx.username = 'cvs2svn'
401 # ctx.svn_property_setters contains a list of rules used to set the
402 # svn properties on files in the converted archive. For each file,
403 # the rules are tried one by one. Any rule can add or suppress one or
404 # more svn properties. Typically the rules will not overwrite
405 # properties set by a previous rule (though they are free to do so).
406 ctx.svn_property_setters.extend([
407 # To read auto-props rules from a file, uncomment the following line
408 # and specify a filename. The boolean argument specifies whether
409 # case should be ignored when matching filenames to the filename
410 # patterns found in the auto-props file:
411 #AutoPropsPropertySetter(
412 # r'/home/username/.subversion/config',
416 # To read mime types from a file, uncomment the following line and
417 # specify a filename:
418 #MimeMapper(r'/etc/mime.types'),
420 # Omit the svn:eol-style property from any files that are listed
421 # as binary (i.e., mode '-kb') in CVS:
422 CVSBinaryFileEOLStyleSetter(),
424 # If the file is binary and its svn:mime-type property is not yet
425 # set, set svn:mime-type to 'application/octet-stream'.
426 CVSBinaryFileDefaultMimeTypeSetter(),
428 # To try to determine the eol-style from the mime type, uncomment
429 # the following line:
430 #EOLStyleFromMimeTypeSetter(),
432 # Choose one of the following lines to set the default
433 # svn:eol-style if none of the above rules applied. The argument
434 # is the svn:eol-style that should be applied, or None if no
435 # svn:eol-style should be set (i.e., the file should be treated as
438 # The default is to treat all files as binary unless one of the
439 # previous rules has determined otherwise, because this is the
440 # safest approach. However, if you have been diligent about
441 # marking binary files with -kb in CVS and/or you have used the
442 # above rules to definitely mark binary files as binary, then you
443 # might prefer to use 'native' as the default, as it is usually
444 # the most convenient setting for text files. Other possible
445 # options: 'CRLF', 'CR', 'LF'.
446 DefaultEOLStyleSetter(None),
447 #DefaultEOLStyleSetter('native'),
449 # Prevent svn:keywords from being set on files that have
450 # svn:eol-style unset.
451 SVNBinaryFileKeywordsPropertySetter(),
453 # If svn:keywords has not been set yet, set it based on the file's
455 KeywordsPropertySetter(config.SVN_KEYWORDS_VALUE),
457 # Set the svn:executable flag on any files that are marked in CVS as
459 ExecutablePropertySetter(),
461 # Uncomment the following line to include the original CVS revision
462 # numbers as file properties in the SVN archive:
463 #CVSRevisionNumberSetter(),
467 # The directory to use for temporary files:
468 ctx.tmpdir = r'cvs2svn-tmp'
470 # To skip the cleanup of temporary files, uncomment the following
472 #ctx.skip_cleanup = True
475 # In CVS, it is perfectly possible to make a single commit that
476 # affects more than one project or more than one branch of a single
477 # project. Subversion also allows such commits. Therefore, by
478 # default, when cvs2svn sees what looks like a cross-project or
479 # cross-branch CVS commit, it converts it into a
480 # cross-project/cross-branch Subversion commit.
482 # However, other tools and SCMs have trouble representing
483 # cross-project or cross-branch commits. (For example, Trac's Revtree
484 # plugin, http://www.trac-hacks.org/wiki/RevtreePlugin is confused by
485 # such commits.) Therefore, we provide the following two options to
486 # allow cross-project/cross-branch commits to be suppressed.
488 # To prevent CVS commits from different projects from being merged
489 # into single SVN commits, change this option to False:
490 ctx.cross_project_commits = True
492 # To prevent CVS commits on different branches from being merged into
493 # single SVN commits, change this option to False:
494 ctx.cross_branch_commits = True
496 # By default, .cvsignore files are rendered in the output by setting
497 # corresponding svn:ignore properties on the parent directory, but the
498 # .cvsignore files themselves are not included in the conversion
499 # output. If you would like to include the .cvsignore files in the
500 # output, change this option to True:
501 ctx.keep_cvsignore = False
503 # By default, it is a fatal error for a CVS ",v" file to appear both
504 # inside and outside of an "Attic" subdirectory (this should never
505 # happen, but frequently occurs due to botched repository
506 # administration). If you would like to retain both versions of such
507 # files, change the following option to True, and the attic version of
508 # the file will be left in an SVN subdirectory called "Attic":
509 ctx.retain_conflicting_attic_files = False
511 # Now use stanzas like the following to define CVS projects that
512 # should be converted. The arguments are:
514 # - The filesystem path of the project within the CVS repository.
516 # - The path that should be used for the "trunk" directory of this
517 # project within the SVN repository. This is an SVN path, so it
518 # should always use forward slashes ("/").
520 # - The path that should be used for the "branches" directory of this
521 # project within the SVN repository. This is an SVN path, so it
522 # should always use forward slashes ("/").
524 # - The path that should be used for the "tags" directory of this
525 # project within the SVN repository. This is an SVN path, so it
526 # should always use forward slashes ("/").
528 # - A list of symbol transformations that can be used to rename
529 # symbols in this project. Each entry is a tuple (pattern,
530 # replacement), where pattern is a Python regular expression pattern
531 # and replacement is the text that should replace the pattern. Each
532 # pattern is matched against each symbol name. If the pattern
533 # matches, then it is replaced with the corresponding replacement
534 # text. The replacement can include substitution patterns (e.g.,
535 # r'\1' or r'\g<name>'). Typically you will want to use raw strings
536 # (strings with a preceding 'r', like shown in the examples) for the
537 # regexp and its replacement to avoid backslash substitution within
541 # Create the default project (using ctx.trunk, ctx.branches, and ctx.tags):
542 run_options.add_project(
543 r'test-data/main-cvsrepos',
545 branches_path='branches',
547 initial_directories=[
548 # The project's trunk_path, branches_path, and tags_path
549 # directories are added to the SVN repository in the project's
550 # first commit. If you would like additional SVN directories
551 # to be created in the project's first commit, list them here.
555 #RegexpSymbolTransform(r'release-(\d+)_(\d+)',
557 #RegexpSymbolTransform(r'release-(\d+)_(\d+)_(\d+)',
558 # r'release-\1.\2.\3'),
559 # Convert backslashes into forward slashes:
560 ReplaceSubstringsSymbolTransform('\\','/'),
561 # Eliminate leading, trailing, and repeated slashes:
562 NormalizePathsSymbolTransform(),
564 symbol_strategy_rules=[
565 # Additional, project-specific symbol strategy rules can
567 ] + global_symbol_strategy_rules,
570 # Add a second project, to be stored to projA/trunk, projA/branches,
572 #run_options.add_project(
573 # r'my/cvsrepo/projA',
574 # trunk_path='projA/trunk',
575 # branches_path='projA/branches',
576 # tags_path='projA/tags',
577 # initial_directories=[
578 # # The project's trunk_path, branches_path, and tags_path
579 # # directories are added to the SVN repository in the project's
580 # # first commit. If you would like additional SVN directories
581 # # to be created in the project's first commit, list them here.
584 # symbol_transforms=[
585 # #RegexpSymbolTransform(r'release-(\d+)_(\d+)',
586 # # r'release-\1.\2'),
587 # #RegexpSymbolTransform(r'release-(\d+)_(\d+)_(\d+)',
588 # # r'release-\1.\2.\3'),
589 # # Convert backslashes into forward slashes:
590 # ReplaceSubstringsSymbolTransform('\\','/'),
591 # # Eliminate leading, trailing, and repeated slashes:
592 # NormalizePathsSymbolTransform(),
594 # symbol_strategy_rules=[
595 # # Additional, project-specific symbol strategy rules can
597 # ] + global_symbol_strategy_rules,
600 # Change this option to True to turn on profiling of cvs2svn (for
601 # debugging purposes):
602 run_options.profiling = False
605 # Should CVSItem -> Changeset database files be memory mapped? In
606 # some tests, using memory mapping speeded up the overall conversion
607 # by about 5%. But this option can cause the conversion to fail with
608 # an out of memory error if the conversion computer runs out of
609 # virtual address space (e.g., when running a very large conversion on
610 # a 32-bit operating system). Therefore it is disabled by default.
611 # Uncomment the following line to allow these database files to be
613 #changeset_database.use_mmap_for_cvs_item_to_changeset_table = True