tests/test-convert.t
changeset 12924 2f1174b2c4fa
parent 12922 58f0c60b7f40
child 13011 4936a04b6792
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