mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-30 05:22:44 +08:00
65 lines
66 KiB
HTML
65 lines
66 KiB
HTML
<div class="c-markdown doc-markdown"><div class="doc-postil"><div class="c-markdown"><h2>命名</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>git-svn - Subversion版本库和Git之间的双向操作</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>概要</h2></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git svn <command> [options] [arguments]</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git svn</code>是Subversion和Git之间变更集的简单渠道。它提供了Subversion和Git存储库之间的双向变化流。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git svn</code>可以跟踪常见的“trunk / branches / tags”布局，并使用--stdlayout选项来跟踪标准的Subversion存储库。它也可以使用-T / -t / -b选项在任何布局中跟随分支和标签（请参阅<code>init</code>下面的选项以及<code>clone</code>命令）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>一旦跟踪Subversion存储库（使用上述任何方法），可以通过<code>fetch</code>命令从Subversion更新Git存储库，并通过命令从Git更新Subversion <code>dcommit</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>命令</h2></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">init</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用其他元数据目录初始化一个空的Git存储库<code>git svn</code>。可以将Subversion URL指定为命令行参数，或者将其指定为-T / -t / -b的完整URL参数。或者，可以将要操作的目标目录指定为第二个参数。通常这个命令初始化当前目录。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-T<trunk_subdir> --trunk=<trunk_subdir> -t<tags_subdir> --tags=<tags_subdir> -b<branches_subdir> --branches=<branches_subdir> -s --stdlayout</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这些是init的可选命令行选项。每个标志都可以指向相对的存储库路径（--tags = project / tags）或完整的url（--tags = <a href="https://foo.org/project/tags" target="_blank">https://foo.org/project/tags</a>）。您可以指定多个--tags和/或--branches选项，以防Subversion存储库将标签或分支置于多个路径下。选项--stdlayout是将trunk，tags，branches设置为相对路径的简写方式，这是Subversion的默认设置。如果还有其他任何选项，则优先。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-metadata</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>noMetadata</code>在svn-remote配置中设置选项。不建议<code>svn.noMetadata</code>使用此选项，请在使用此选项之前阅读该手册页的部分。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--use-svm-props</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>useSvmProps</code>在svn-remote配置中设置选项。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--use-svnsync-props</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>useSvnsyncProps</code>在svn-remote配置中设置选项。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--rewrite-root=<URL></p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>rewriteRoot</code>在svn-remote配置中设置选项。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--rewrite-uuid=<UUID></p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>rewriteUUID</code>在svn-remote配置中设置选项。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--username=<user></p></div></div><div class="doc-postil"><div class="c-markdown"><p>对于SVN处理（http，https和普通svn）身份验证的传输，请指定用户名。对于其他传输（例如<code>svn+ssh://</code>），您必须在URL中包含用户名，例如<code>svn+ssh://foo@svn.bar.com/project</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--prefix=<prefix></p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果指定了trunk / branches / tags，这允许指定一个前缀作为远程名称的前缀。前缀不会自动包含结尾的斜杠，因此如果这是您想要的，请确保在参数中包含一个。如果指定了--branches / -b，则前缀必须包含尾部斜线。在任何情况下都强烈建议设置前缀（使用尾部斜线），因为您的SVN跟踪引用将位于“refs / remotes / $ prefix / <strong>”，这与Git自己的远程跟踪引用布局兼容（参考文献/远程/ $远程/</strong>）。如果您希望跟踪共享公共存储库的多个项目，那么设置前缀也很有用。默认情况下，前缀设置为<code>origin/</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><div class="table-wrapper"><table><thead><tr class="firstRow"><th style="text-align: left;"><div class="table-header"><p>注意</p></div></th><th style="text-align: left;"><div class="table-header"><p>在Git v2.0之前，默认的前缀是“”（无前缀）。这意味着SVN跟踪文件被放在“refs / remotes / *”，这与Git自己的远程跟踪文件的组织方式不兼容。如果你仍然想要旧的默认值，可以通过在命令行上传递--prefix“”来获得它（如果你的Perl的Getopt :: Long是<v2.37，那么--prefix =“”可能不起作用）。</p></div></th></tr></thead><tbody></tbody></table></div></div></div><div class="doc-postil"><div class="c-markdown"><p>--ignore-refs=<regex></p></div></div><div class="doc-postil"><div class="c-markdown"><p>当传递给<code>init</code>或<code>clone</code>正则表达式将被保存为配置密钥。请参阅<code>fetch</code>有关说明<code>--ignore-refs</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--ignore-paths=<regex></p></div></div><div class="doc-postil"><div class="c-markdown"><p>当传递给<code>init</code>或<code>clone</code>正则表达式将被保存为配置密钥。请参阅<code>fetch</code>有关说明<code>--ignore-paths</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--include-paths=<regex></p></div></div><div class="doc-postil"><div class="c-markdown"><p>当传递给<code>init</code>或<code>clone</code>正则表达式将被保存为配置密钥。请参阅<code>fetch</code>有关说明<code>--include-paths</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-minimize-url</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当跟踪多个目录（使用--stdlayout， - branch或-tags选项）时，git svn将尝试连接到Subversion存储库的根（或最高允许级别）。如果整个项目在存储库中移动，则此默认值允许更好地跟踪历史记录，但可能会导致存在读取访问限制的存储库中出现问题。传递<code>--no-minimize-url</code>将允许git svn按原样接受URL，而不尝试连接到更高级别的目录。当只有一个URL /分支被跟踪时，这个选项默认是关闭的（它不会有什么好处）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">fetch</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>从我们正在跟踪的Subversion远程获取未提取的修订。$ GIT_DIR / config文件中的svn-remote“...”部分的名称可以指定为可选的命令行参数。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果需要，这会自动更新rev_map（<code>$GIT_DIR/svn/*\*/.rev_map.*</code>有关详细信息，请参阅下面的FILES部分）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--localtime</p></div></div><div class="doc-postil"><div class="c-markdown"><p>将Git提交时间存储在本地时区而不是UTC。这使得<code>git log</code>（甚至没有--date = local）显示与<code>svn log</code>当地时区相同的时间。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这并不妨碍与克隆的Subversion版本库的互操作，但如果您希望本地Git存储库能够与其他人的本地Git存储库互操作，则不要使用此选项，或者您都应该使用它相同的当地时区。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--parent</p></div></div><div class="doc-postil"><div class="c-markdown"><p>仅从当前HEAD的SVN父节点获取。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--ignore-refs=<regex></p></div></div><div class="doc-postil"><div class="c-markdown"><p>忽略与Perl正则表达式匹配的分支或标记的引用。“负面预测断言” <code>^refs/remotes/origin/(?!tags/wanted-tag|wanted-branch).*$</code>可以用来仅允许某些参考。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn-remote.<name>.ignore-refs</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>如果ignore-refs配置键已设置，并且还提供了命令行选项，则将使用这两个正则表达式。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--ignore-paths=<regex></p></div></div><div class="doc-postil"><div class="c-markdown"><p>这允许指定一个Perl正则表达式，这会导致SVN从结帐中跳过所有匹配的路径。该<code>--ignore-paths</code>选项应与每一个<code>fetch</code>（包括自动取因<code>clone</code>，<code>dcommit</code>，<code>rebase</code>，等）在给定的存储库。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn-remote.<name>.ignore-paths</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>如果设置了ignore-paths配置键，并且还给出了命令行选项，则将使用这两个正则表达式。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>例子：</p></div></div><div class="doc-postil"><div class="c-markdown"><p>每次抓取跳过“doc *”目录</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">--ignore-paths="^doc"</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>跳过第一级目录的“分支”和“标签”</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">--ignore-paths="^[^/]+/(?:branches|tags)"</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>--include-paths=<regex></p></div></div><div class="doc-postil"><div class="c-markdown"><p>这样可以指定一个Perl正则表达式，这会导致只包含从SVN签出的匹配路径。该<code>--include-paths</code>选项应与每一个<code>fetch</code>（包括自动取因<code>clone</code>，<code>dcommit</code>，<code>rebase</code>，等）在给定的存储库。<code>--ignore-paths</code>优先<code>--include-paths</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn-remote.<name>.include-paths</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>--log-window-size=<n></p></div></div><div class="doc-postil"><div class="c-markdown"><p>扫描Subversion历史记录时，每个请求获取<n>日志条目。默认值为100对于非常大的Subversion资料库中，可能需要较大的值<code>clone</code>/ <code>fetch</code>在合理的时间内完成。但过大的值可能会导致更高的内存使用量和请求超时。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">clone</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>运行<code>init</code>和<code>fetch</code>。它会根据传递给它的URL的基名自动创建一个目录; 或者是否传递了第二个参数; 它会创建一个目录并在其中工作。它接受<code>init</code>和<code>fetch</code>命令接受的所有参数; 除了<code>--fetch-all</code>和<code>--parent</code>。克隆存储库后，该<code>fetch</code>命令将能够更新修订版而不影响工作树; 并且该<code>rebase</code>命令将能够使用最新更改更新工作树。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--preserve-empty-dirs</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在本地Git存储库中为从Subversion提取的每个空目录创建一个占位符文件。这包括通过删除Subversion存储库中的所有条目（但不包括目录本身）而变空的目录。当不再需要时，占位符文件也被跟踪和删除。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--placeholder-filename=<filename></p></div></div><div class="doc-postil"><div class="c-markdown"><p>设置由--preserve-empty-dirs创建的占位符文件的名称。默认：“.gitignore”</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">rebase</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>这会从当前HEAD的SVN父节点获取修订，并将当前（未提交到SVN）的工作重新绑定到它。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这与其相似<code>svn update</code>或<code>git pull</code>除了它保留了线性历史记录<code>git rebase</code>而不是<code>git merge</code>为了方便提交<code>git svn</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这接受所有选项<code>git svn fetch</code>并<code>git rebase</code>接受。但是，<code>--fetch-all</code>只能从当前的svn-remote中获取，而不是所有的svn-remote定义。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>像<code>git rebase</code>; 这要求工作树干净并且没有未提交的更改。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果需要，这会自动更新rev_map（<code>$GIT_DIR/svn/*\*/.rev_map.*</code>有关详细信息，请参阅下面的FILES部分）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-l --local</p></div></div><div class="doc-postil"><div class="c-markdown"><p>不要远程获取; 仅<code>git rebase</code>针对上游SVN上次提交的提交运行。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">dcommit</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>将当前分支中的每个diff直接提交到SVN存储库，然后重新绑定或重置（取决于SVN和head之间是否存在差异）。这将在Git中为每个提交创建SVN修订。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当一个可选的Git分支名称（或Git提交对象名称）被指定为参数时，子命令在指定的分支上工作，而不是在当前分支上。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用<code>dcommit</code>优于<code>set-tree</code>（下面）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-rebase</p></div></div><div class="doc-postil"><div class="c-markdown"><p>提交后，不要重新设置或重置。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--commit-url <URL></p></div></div><div class="doc-postil"><div class="c-markdown"><p>提交到这个SVN URL（完整路径）。这样做的目的在于，如果稍后用户可以访问替代传输方法（例如或）来提交，那么允许<code>git svn</code>使用一种传输方法（例如<code>svn://</code>或<code>http://</code>用于匿名读取）创建的现有存储库被重用。<code>svn+ssh://https://</code></p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn-remote.<name>.commiturl
|
||
|
||
config key: svn.commiturl (overwrites all svn-remote.<name>.commiturl options)</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>请注意，commiturl config密钥的SVN URL包含SVN分支。如果您想为整个SVN存储库设置提交URL，请改为使用svn-remote。<name> .pushurl。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用这个选项用于任何其他目的（不要问）非常不鼓励。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--mergeinfo=<mergeinfo></p></div></div><div class="doc-postil"><div class="c-markdown"><p>在dcommit（eg <code>--mergeinfo="/branches/foo:1-10"</code>）期间添加给定的合并信息。所有的svn服务器版本都可以存储这些信息（作为一个属性），从1.5版开始的svn客户端可以使用它。要从多个分支指定合并信息，请在分支之间使用单个空格字符（<code>--mergeinfo="/branches/foo:1-10 /branches/bar:3,5-6,8"</code>）</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.pushmergeinfo</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>这个选项会导致git-svn在可能的情况下尝试自动填充SVN信息库中的svn：mergeinfo属性。目前，只有在提交非快进合并的情况下，只有第一个父母已经被推入SVN的情况下才能完成此操作。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--interactive</p></div></div><div class="doc-postil"><div class="c-markdown"><p>要求用户确认补丁集应该实际发送给SVN。对于每个补丁，可以回答“是”（接受此补丁），“否”（丢弃此补丁），“全部”（接受所有补丁）或“退出”。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git svn dcommit</code> 如果回答为“否”或“退出”，则立即返回，但不向SVN提交任何内容。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">branch</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>在SVN存储库中创建一个分支。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-m --message</p></div></div><div class="doc-postil"><div class="c-markdown"><p>允许指定提交消息。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-t --tag</p></div></div><div class="doc-postil"><div class="c-markdown"><p>通过使用tags_subdir而不是在git svn init期间指定的branches_subdir创建一个标签。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-d<path> --destination=<path></p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果给<code>init</code>or <code>clone</code>命令提供了多个--branches（或--tags）选项，则必须提供您希望在SVN存储库中创建的分支（或标签）的位置。<path>指定用于创建分支或标记的路径，并且应该与其中一个配置的分支或标记refspecs的左侧的模式相匹配。您可以使用这些命令查看这些refspecs</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git config --get-all svn-remote.<name>.branches
|
||
|
||
git config --get-all svn-remote.<name>.tags</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>其中<name>是由-R选项<code>init</code>（默认情况下为“svn”）指定的SVN存储库的名称。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--username</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定SVN用户名以执行提交。该选项覆盖<code>username</code>配置属性。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--commit-url</p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用指定的URL连接到目标Subversion存储库。这在源SVN存储库为只读的情况下非常有用。该选项覆盖配置属性<code>commiturl</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git config --get-all svn-remote.<name>.commiturl</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>--parents</p></div></div><div class="doc-postil"><div class="c-markdown"><p>创建父文件夹。此参数等同于svn cp命令中的参数--parents，对于非标准存储库布局非常有用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">tag</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>在SVN存储库中创建一个标签。这是一个简写<code>branch -t</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">log</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>当svn用户引用-r / - 修订号时，这应该能够轻松查找svn日志消息。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>'svn log'支持以下功能：</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-r <n>:<n> --revision=<n>:<n></p></div></div><div class="doc-postil"><div class="c-markdown"><p>支持，非数字参数不是：HEAD，NEXT，BASE，PREV等...</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-v --verbose</p></div></div><div class="doc-postil"><div class="c-markdown"><p>它不完全兼容svn日志中的--verbose输出，但相当接近。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--limit=<n></p></div></div><div class="doc-postil"><div class="c-markdown"><p>与--max-count不同，不会计入合并/排除提交</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--incremental</p></div></div><div class="doc-postil"><div class="c-markdown"><p>支持的</p></div></div><div class="doc-postil"><div class="c-markdown"><p>新功能：</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--show-commit</p></div></div><div class="doc-postil"><div class="c-markdown"><p>也显示了Git commit sha1</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--oneline</p></div></div><div class="doc-postil"><div class="c-markdown"><p>我们的版本--pretty = oneline</p></div></div><div class="doc-postil"><div class="c-markdown"><div class="table-wrapper"><table><thead><tr class="firstRow"><th style="text-align: left;"><div class="table-header"><p>注意</p></div></th><th style="text-align: left;"><div class="table-header"><p>SVN本身只存储UTC时间，没有别的。常规svn客户端将UTC时间转换为当地时间（或基于TZ =环境）。该命令具有相同的行为。</p></div></th></tr></thead><tbody></tbody></table></div></div></div><div class="doc-postil"><div class="c-markdown"><p>任何其他参数都直接传递给 <code>git log</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">blame</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>显示修订版本和作者上次修改文件的每一行。默认情况下，此模式的输出格式与'svn blame'的输出格式兼容。像SVN blame命令一样，工作树中的本地未提交更改将被忽略; HEAD修订版本中的文件版本被注释。未知参数直接传递给<code>git blame</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--git-format</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git blame</code>以与SVN版本号相同的格式生成输出，而不是Git提交哈希。在此模式下，尚未提交给SVN的更改（包括本地工作副本编辑）显示为修订版0。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">find-rev</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>当给定表单的SVN修订号时<code>rN</code>，返回相应的Git提交散列（可以选择后跟一个tree-ish来指定应该搜索哪个分支）。当给定树时，返回相应的SVN修订版号。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-B --before</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果给定SVN修订版，不要求完全匹配，而是在指定修订版中找到与SVN存储库（在当前分支上）相对应的提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-A --after</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果提供SVN修订版本，则不需要完全匹配; 如果没有完全匹配，则返回在历史中向前搜索的最接近的匹配。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">set-tree</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>你应该考虑使用<code>dcommit</code>而不是这个命令。将指定的提交或树对象提交给SVN。这依赖于您导入的提取数据是最新的。这绝对不会尝试在提交SVN时进行修补，它只会覆盖树中指定的文件或提交的文件。假定所有合并都是独立于<code>git svn</code>功能而发生的。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">create-ignore</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>递归查找目录上的 svn：ignore 属性并创建匹配的 .gitignore 文件。生成的文件被分阶段提交，但未提交。使用 -r / - revision 来引用特定的版本。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">show-ignore</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>递归查找并列出目录上的 svn：ignore 属性。输出适用于追加到 $ GIT_DIR / info / exclude 文件。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">mkdirs</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>尝试根据$ GIT_DIR / svn / <refname> /unhandled.log文件中的信息重新创建核心 Git 无法跟踪的空目录。空目录在使用“git svn clone”和“git svn rebase”时会自动重新创建，因此“mkdirs”适用于诸如“git checkout”或“git reset”之类的命令之后。（有关更多信息，请参见 svn-remote。<name> .automkdirs 配置文件选项。）</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">commit-diff</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>提交命令行中两个树型参数的差异。该命令不依赖于在<code>git svn init</code>-ed存储库中。这个命令有三个参数，（a）原始树进行区分，（b）新的树结果，（c）目标Subversion存储库的URL。如果您正在使用<code>git svn</code>-aware存储库（已<code>init</code>与之配合使用<code>git svn</code>），则可以省略最后一个参数（URL ）。这需要-r <revision>选项。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当第二个 tree-ish 表示这样一个对象，或者通过调用一个编辑器（请参阅下面的选项）请求时，提交消息直接提供给<code>-m</code>or <code>-F</code>选项，或者间接来自标记或提交<code>--edit</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-m <msg> --message=<msg></p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用给定<code>msg</code>的提交消息。该选项禁用该<code>--edit</code>选项。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-F <filename> --file=<filename></p></div></div><div class="doc-postil"><div class="c-markdown"><p>从给定的文件中获取提交消息。该选项禁用该<code>--edit</code>选项。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">info</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>显示有关类似'svn info'提供的文件或目录的信息。目前不支持-r / - 修订参数。使用--url选项仅输出<code>URL:</code>字段的值。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">proplist</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>列出存储在Subversion存储库中关于给定文件或目录的属性。使用-r / - revision来引用特定的Subversion版本。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">propget</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>获取作为第一个参数给定的Subversion属性，用于文件。可以使用-r / - revision指定特定的修订版本。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">propset</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>将作为第一个参数给出的Subversion属性设置为作为第三个参数给出的文件的第二个参数给出的值。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>例子：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git svn propset svn:keywords "FreeBSD=%H" devel/py-tipper/Makefile</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>这将属性设置<code>svn:keywords</code>到<code>FreeBSD=%H</code>该文件<code>devel/py-tipper/Makefile</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">show-externals</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>显示Subversion外部。使用-r / - revision来指定特定的修订版本。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">gc</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>压缩$ GIT_DIR / svn / <refname> /unhandled.log文件并删除$ GIT_DIR / svn / <refname> / index文件。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">reset</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>取消<code>fetch</code>返回指定修订的效果。这使您可以重新<code>fetch</code>修订SVN。通常情况下，SVN修订版的内容不应该改变，<code>reset</code>不应该有必要。但是，如果SVN权限发生变化，或者如果您更改了--ignore-paths选项，a <code>fetch</code>可能会因“未在提交中找到”（文件先前不可见）或“校验和不匹配”（错过修改）而失败。如果问题文件永远不能被忽略（使用--ignore-paths），修复repo的唯一方法就是使用<code>reset</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>只有rev_map和refs / remotes / git-svn被更改（请参阅<code>$GIT_DIR/svn/*\*/.rev_map.*</code>下面的FILES部分了解详细信息）。跟随<code>reset</code>一个<code>fetch</code>然后<code>git reset</code>或<code>git rebase</code>移动当地分支到新的树上。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-r <n> --revision=<n></p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定要保留的最新版本。以后的所有修订都会被丢弃。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-p --parent</p></div></div><div class="doc-postil"><div class="c-markdown"><p>同样放弃指定的修订版本，而是保留最近的父版本。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>例子：</p></div></div><div class="doc-postil"><div class="c-markdown"><p>假设您在“主”中进行了本地更改，但您需要重新提取“r2”。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript"> r1---r2---r3 remotes/git-svn
|
||
|
||
\
|
||
|
||
A---B master</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>修复首先导致“r2”不完整的忽略路径或SVN权限问题。然后：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git svn reset -r2 -p
|
||
|
||
git svn fetch</pre></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript"> r1---r2'--r3' remotes/git-svn
|
||
|
||
\
|
||
|
||
r2---r3---A---B master</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>然后修正“主”与<code>git rebase</code>。不要使用<code>git merge</code>或您的历史将与未来不兼容<code>dcommit</code>！</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git rebase --onto remotes/git-svn A^ master</pre></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript"> r1---r2'--r3' remotes/git-svn
|
||
|
||
\
|
||
|
||
A'--B' master</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>--shared=(false|true|umask|group|all|world|everybody) --template=<template_directory></p></div></div><div class="doc-postil"><div class="c-markdown"><p>仅用于该<code>init</code>命令。这些直接传递给<code>git init</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-r <arg> --revision <arg></p></div></div><div class="doc-postil"><div class="c-markdown"><p>与<code>fetch</code>命令一起使用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这允许支持部分/烧灼历史的修订范围。$ NUMBER，$ NUMBER1：$ NUMBER2（数值范围），$ NUMBER：HEAD和BASE：$ NUMBER都支持。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这可以使您在运行提取时创建部分镜像; 但通常不推荐使用，因为历史记录会被跳过并丢失。</p></div></div><div class="doc-postil"><div class="c-markdown"><ul class="ul-level-0 list-paddingleft-2" style="margin: 10px 0px 10px 20px;"><li><p>--stdin</p></li></ul></div></div><div class="doc-postil"><div class="c-markdown"><p>仅用于该<code>set-tree</code>命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>从stdin中读取提交列表并按相反顺序提交它们。只有领先的sha1从每行读取，因此<code>git rev-list --pretty=oneline</code>可以使用输出。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--rmdir</p></div></div><div class="doc-postil"><div class="c-markdown"><p>只有用过的<code>dcommit</code>，<code>set-tree</code>和<code>commit-diff</code>命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果没有文件留下，请从SVN树中删除目录。SVN可以对空目录进行版本化，并且如果没有剩下文件，它们不会被默认删除。Git不能版本空目录。启用此标志将使SVN的行为像Git一样行事。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.rmdir</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>-e --edit</p></div></div><div class="doc-postil"><div class="c-markdown"><p>只有用过的<code>dcommit</code>，<code>set-tree</code>和<code>commit-diff</code>命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在提交SVN之前编辑提交消息。默认情况下，对于提交的对象是关闭的，并且在提交树对象时被强制关闭。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.edit</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>-l<num> --find-copies-harder</p></div></div><div class="doc-postil"><div class="c-markdown"><p>只有用过的<code>dcommit</code>，<code>set-tree</code>和<code>commit-diff</code>命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>他们都直接传递给<code>git diff-tree</code>; 有关更多信息，请参阅git-diff-tree [1]。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.l
|
||
|
||
config key: svn.findcopiesharder</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>-A<filename> --authors-file=<filename></p></div></div><div class="doc-postil"><div class="c-markdown"><p>语法与下列使用的文件兼容<code>git cvsimport</code>：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript"> loginname = Joe User <user@example.com></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>如果指定了此选项并<code>git svn</code>遇到作者文件中不存在的SVN提交者名称，<code>git svn</code>则会中止操作。用户将不得不添加适当的条目。<code>git svn</code>作者文件被修改后重新运行前面的命令应该继续运行。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.authorsfile</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>--authors-prog=<filename></p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果指定了此选项，则对于作者文件中不存在的每个SVN提交者名称，将使用提交者名称作为第一个参数来执行给定文件。该程序预计会返回一个形式为“Name <email>”的单行，该行将被视为包含在作者文件中。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.authorsProg</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>-q --quiet</p></div></div><div class="doc-postil"><div class="c-markdown"><p>让<code>git svn</code>更简洁。再指定一次，使其更加冗长。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-m --merge -s<strategy> --strategy=<strategy> -p --preserve-merges</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这些仅用于<code>dcommit</code>和<code>rebase</code>命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果a 不能使用，请直接转至<code>git rebase</code>使用时间（请参阅）。<code>dcommitgit resetdcommit</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>-n --dry-run</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这可以通过使用<code>dcommit</code>，<code>rebase</code>，<code>branch</code>和<code>tag</code>命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>对于<code>dcommit</code>，打印出一系列Git参数，这些参数将显示哪些差异将提交给SVN。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>对于<code>rebase</code>显示与当前分支关联的上游svn存储库相关联的本地分支以及将从中获取的svn存储库的URL。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>对于<code>branch</code>和<code>tag</code>，在创建分支或标记时显示将用于复制的URL。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--use-log-author</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当检索SVN提交到Git的（作为的一部分<code>fetch</code>，<code>rebase</code>或者<code>dcommit</code>操作），找第一<code>From:</code>或<code>Signed-off-by:</code>日志消息行和使用，作为作者的字符串。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.useLogAuthor</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>--add-author-from</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当承诺的SVN混帐（作为的一部分<code>commit-diff</code>，<code>set-tree</code>或者<code>dcommit</code>操作），如果现有的日志消息不已经有一个<code>From:</code>或<code>Signed-off-by:</code>行，追加一个<code>From:</code>基于Git的行提交的作者字符串。如果你使用这个，那么<code>--use-log-author</code>将为所有提交检索一个有效的作者字符串。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.addAuthorFrom</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>高级选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>-i<GIT_SVN_ID> --id <GIT_SVN_ID></p></div></div><div class="doc-postil"><div class="c-markdown"><p>这设置GIT_SVN_ID（而不是使用环境）。这允许用户覆盖默认的refname以在跟踪单个URL时获取。的<code>log</code>和<code>dcommit</code>命令不再需要此开关作为参数。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-R<remote name> --svn-remote <remote name></p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定要使用的svn-remote“<remote name>”部分，这允许SVN多个存储库被跟踪。默认值：“svn”</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--follow-parent</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果我们跟踪分支（使用存储库布局选项之一--trunk，--tags， - branch，--stdlayout），此选项才相关。对于每个追踪分支，尝试找出其修订版本从哪里复制而来，并在分支的第一个Git提交中设置合适的父代。当我们跟踪已在存储库中移动的目录时，这非常有用。如果此功能被禁用，则由所创建的分支<code>git svn</code>将全部为线性，并且不共享任何历史记录，这意味着将不会有关于分支分支或合并的信息。但是，长时间/复杂的历史记录可能需要很长时间，因此禁用此功能可能会加速克隆过程。此功能默认启用，请使用--no-follow-parent将其禁用。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">config key: svn.followparent</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>配置文件专用选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>svn.noMetadata svn-remote.<name>.noMetadata</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这可以<code>git-svn-id:</code>在每次提交结束时删除这些行。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>此选项只能用于一次导入，因为<code>git svn</code>如果没有元数据，将无法再次获取。此外，如果您丢失了<code>$GIT_DIR/svn/*\*/.rev_map.*</code>文件，<code>git svn</code>将无法重建它们。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这个<code>git svn log</code>命令也不会在使用它的存储库上工作。这与使用<code>useSvmProps</code>（希望）显而易见的原因相矛盾。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>不推荐使用此选项，因为这会导致难以在现有文档，错误报告和归档中追踪对SVN修订号的旧引用。如果你打算最终从SVN迁移到Git，并确定要删除SVN历史记录，请考虑使用git-filter-branch [1]。filter-branch还允许重新格式化元数据，以便读取和重写非“svn.authorsFile”用户的作者信息。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>svn.useSvmProps svn-remote.<name>.useSvmProps</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这允许<code>git svn</code>从使用SVN :: Mirror（或svk）为元数据创建的镜像中重新映射存储库URL和UUID。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果一个SVN修订版有一个属性“svm：headrev”，那么修改可能是由SVN :: Mirror（也被SVK使用）创建的。该属性包含存储库UUID和修订版。我们希望使它看起来像我们镜像原始URL，因此引入一个帮助函数，该函数返回原始标识URL和UUID，并在提交消息中生成元数据时使用它。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>svn.useSvnsyncProps svn-remote.<name>.useSvnsyncprops</p></div></div><div class="doc-postil"><div class="c-markdown"><p>类似于useSvmProps选项; 这是针对随SVN 1.4.x及更高版本分发的svnsync（1）命令的用户。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>svn-remote.<name>.rewriteRoot</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这允许用户从备用URL创建存储库。例如，管理员可以<code>git svn</code>在本地运行服务器（通过file：//访问），但希望在元数据中使用公共http：//或svn：// URL分发存储库，以便用户可以看到公共URL 。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>svn-remote.<name>.rewriteUUID</p></div></div><div class="doc-postil"><div class="c-markdown"><p>类似于useSvmProps选项; 这适用于需要手动重新映射UUID的用户。在原始UUID无法通过useSvmProps或useSvnsyncProps获得的情况下，这可能会很有用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>svn-remote.<name>.pushurl</p></div></div><div class="doc-postil"><div class="c-markdown"><p>与Git类似<code>remote.<name>.pushurl</code>，此密钥旨在用于<code>url</code>通过只读传输指向SVN存储库以提供备用读/写传输的情况。假定两个键都指向同一个存储库。不像<code>commiturl</code>，<code>pushurl</code>是一个基本路径。如果使用<code>commiturl</code>或<code>pushurl</code>可以使用，<code>commiturl</code>则优先。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>svn.brokenSymlinkWorkaround</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这将禁用潜在的昂贵检查来解决由破碎的客户端检入到SVN中的损坏的符号链接。如果您跟踪具有许多空符号链接的SVN存储库，请将此选项设置为“false”。该选项可以在<code>git svn</code>运行时更改，并在下一个修订版本生效。如果未设置，则<code>git svn</code>假定此选项为“true”。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>svn.pathnameencoding</p></div></div><div class="doc-postil"><div class="c-markdown"><p>这指示git svn重新编码给定编码的路径名。它可以被Windows用户和非UTF8语言环境中的用户使用，以避免使用非ASCII字符损坏的文件名。有效的编码是Perl的Encode模块支持的编码。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>svn-remote.<name>.automkdirs</p></div></div><div class="doc-postil"><div class="c-markdown"><p>通常，“git svn clone”和“git svn rebase”命令会尝试重新创建Subversion存储库中的空目录。如果此选项设置为“false”，则只有在显式运行“git svn mkdirs”命令时才会创建空目录。如果未设置，则<code>git svn</code>假定此选项为“true”。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>由于noMetadata，rewriteRoot，rewriteUUID，useSvnsyncProps和useSvmProps选项都会影响生成和使用的元数据<code>git svn</code>; 它们<strong>必须</strong>在导入任何历史记录之前在配置文件中设置，并且这些设置一旦设置就不会被更改。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>此外，每个svn-remote部分只能使用其中一个选项，因为它们会影响<code>git-svn-id:</code>元数据行，但可以一起使用的rewriteRoot和rewriteUUID除外。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>基本的例子</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>跟踪和贡献Subversion管理项目的主干（忽略标签和分支）：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript"># Clone a repo (like git clone):
|
||
|
||
git svn clone http://svn.example.com/project/trunk
|
||
|
||
# Enter the newly cloned directory:
|
||
|
||
cd trunk
|
||
|
||
# You should be on master branch, double-check with 'git branch'
|
||
|
||
git branch
|
||
|
||
# Do some work and commit locally to Git:
|
||
|
||
git commit ...# Something is committed to SVN, rebase your local changes against the
|
||
|
||
# latest changes in SVN:
|
||
|
||
git svn rebase
|
||
|
||
# Now commit your changes (that were committed previously using Git) to SVN,# as well as automatically updating your working HEAD:
|
||
|
||
git svn dcommit
|
||
|
||
# Append svn:ignore settings to the default Git exclude file:
|
||
|
||
git svn show-ignore >> .git/info/exclude</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>跟踪和贡献整个Subversion管理的项目（包含干线，标签和分支）：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript"># Clone a repo with standard SVN directory layout (like git clone):
|
||
|
||
git svn clone http://svn.example.com/project --stdlayout --prefix svn/# Or, if the repo uses a non-standard directory layout:
|
||
|
||
git svn clone http://svn.example.com/project -T tr -b branch -t tag --prefix svn/# View all branches and tags you have cloned:
|
||
|
||
git branch -r
|
||
|
||
# Create a new branch in SVN
|
||
|
||
git svn branch waldo
|
||
|
||
# Reset your master to trunk (or any other branch, replacing 'trunk'# with the appropriate name):
|
||
|
||
git reset --hard svn/trunk
|
||
|
||
# You may only dcommit to one branch/tag/trunk at a time. The usage
|
||
|
||
# of dcommit/rebase/show-ignore should be the same as above.</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>初始化<code>git svn clone</code>可能非常耗时（尤其是对于大型的Subversion版本库）。如果多个人（或多个机器的一个人）想要用于<code>git svn</code>与同一Subversion存储库进行交互，则可以将初始信息<code>git svn clone</code>写入服务器上的存储库，并让每个人都使用以下内容克隆该存储库<code>git clone</code>：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript"># Do the initial import on a server
|
||
|
||
ssh server "cd /pub && git svn clone http://svn.example.com/project [options...]"# Clone locally - make sure the refs/remotes/ space matches the server
|
||
|
||
mkdir project
|
||
|
||
cd project
|
||
|
||
git init
|
||
|
||
git remote add origin server:/pub/project
|
||
|
||
git config --replace-all remote.origin.fetch '+refs/remotes/*:refs/remotes/*'
|
||
|
||
git fetch
|
||
|
||
# Prevent fetch/pull from remote Git server in the future,# we only want to use git svn for future updates
|
||
|
||
git config --remove-section remote.origin
|
||
|
||
# Create a local branch from one of the branches just fetched
|
||
|
||
git checkout -b master FETCH_HEAD
|
||
|
||
# Initialize 'git svn' locally (be sure to use the same URL and
|
||
|
||
# --stdlayout/-T/-b/-t/--prefix options as were used on server)
|
||
|
||
git svn init http://svn.example.com/project [options...]# Pull the latest changes from Subversion
|
||
|
||
git svn rebase</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>Rebase vs. pull/merge</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>喜欢使用<code>git svn rebase</code>或<code>git rebase</code>，而不是<code>git pull</code>或<code>git merge</code>以非整合的提交与同步<code>git svn</code>分支。这样做会使未集成的提交历史与上游SVN存储库保持线性关系，并允许使用首选的<code>git svn dcommit</code>子命令将未集成的提交推回到SVN中。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>最初，<code>git svn</code>建议开发商从<code>git svn</code>分支机构撤出或合并。这是因为作者倾向于<code>git svn set-tree B</code>提交一个单独的头部而不是<code>git svn set-tree A..B</code>标记来提交多个提交。使用<code>git pull</code>或<code>git merge</code>使用<code>git svn set-tree A..B</code>会导致触犯到SVN时被压扁的非线性历史，这可能导致合并提交意外扭转了以前的SVN提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>Merge tracking</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>虽然<code>git svn</code>可以追踪采用标准布局的存储库的复制历史记录（包括分支和标签），但它还不能代表SVT用户在git上游发生的合并历史记录。因此，建议用户在Git中保持历史尽可能线性，以便与SVN兼容（请参阅下面的CAVEATS部分）。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>Handling of svn branches</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>如果<code>git svn</code>配置为获取分支（并且--follow分支有效），它有时会为一个SVN分支创建多个Git分支，其中附加分支具有表单名称<code>branchname@nnn</code>（其中nnn为SVN修订版号）。如果<code>git svn</code>在SVN分支中找不到第一次提交的父提交，则将创建这些附加分支，以将分支连接到其他分支的历史记录。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>通常情况下，SVN分支中的第一次提交由复制操作组成。<code>git svn</code>将读取此提交以获取分支创建的SVN修订。然后它将尝试找到与此SVN修订版相对应的Git提交，并将其用作分支的父代。但是，有可能没有合适的Git提交作为父代。除此之外，如果SVN分支是未被获取的修订副本<code>git svn</code>（例如，因为它是旧版本而被跳过<code>--revision</code>），或者在SVN中复制的目录未被跟踪<code>git svn</code>（比如根本没有跟踪的分支，或者被跟踪分支的子目录）。在这些情况下，<code>git svn</code>仍然会创建一个Git分支，但不是使用现有的Git提交作为分支的父代，它会读取分支复制的目录的SVN历史记录，并创建适当的Git提交。这由消息“Initializing parent：<branchname>”表示。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>另外，它会创建一个名为特殊分支<code><branchname>@<SVN-Revision></code>，其中<SVN-Revision>是该分支从其复制的SVN修订号。这个分支将指向分支的新创建的父提交。如果在SVN中该分支已被删除，并稍后从不同版本重新创建，则会有多个这样的分支<code>@</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>请注意，这可能意味着为单个SVN修订版创建了多个Git提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>一个例子：在一个具有标准trunk / tags / branches布局的SVN仓库中，在r.100中创建一个目录trunk / sub。在r.200中，trunk / sub通过将其复制到分支/来进行分支。<code>git svn clone -s</code>然后将创建一个分支<code>sub</code>。它还将为r.100到r.199创建新的Git提交并将其用作分支的历史记录<code>sub</code>。因此，从r.100到r.199的每个修订将有两个Git提交（其中一个包含trunk /，一个包含trunk / sub /）。最后，它会创建一个分支，<code>sub@200</code>指向分支的新的父提交<code>sub</code>（即提交r.200和trunk / sub /）。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>Caveats</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>为简单起见，并与Subversion互操作，则建议所有<code>git svn</code>用户克隆，提取和dcommit直接从SVN服务器，并避免所有<code>git clone</code>/ <code>pull</code>/ <code>merge</code>/ <code>push</code>Git存储区和支路之间的操作。GIT中分支和用户之间交换代码的推荐的方法是<code>git format-patch</code>和<code>git am</code>，或只是“dcommit'ing至SVN库。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>正在运行<code>git merge</code>或<code>git pull</code>不建议您计划<code>dcommit</code>从分支机构运行，因为Subversion用户无法看到您所做的任何合并。此外，如果您从SVN分支的镜像Git分支合并或拉出，<code>dcommit</code>可能会提交到错误的分支。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果您合并，请注意以下规则：<code>git svn dcommit</code>将尝试提交在名为in的SVN提交之上</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git log --grep=^git-svn-id: --first-parent -1</pre></div></div><div class="doc-postil"><div class="c-markdown"><p><code>must</code>因此，您确保您想要提交的分支的最近提交是<code>first</code>合并的父代。否则就会出现混乱，尤其是如果第一个父代在同一个SVN分支上是较旧的提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git clone</code>不会在refs / remotes /层次结构或任何<code>git svn</code>元数据或配置下克隆分支。因此，如果要完成克隆，使用创建和管理的存储库<code>git svn</code>应该<code>rsync</code>用于克隆。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>由于<code>dcommit</code>内部使用重订，任何的Git分支您<code>git push</code>之前<code>dcommit</code>就需要迫使现有裁判的覆盖上的远程存储库。这通常被认为是不好的做法，详情请参阅git-push [1]文档。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>不要在您已经提交的更改中使用git-commit [1]的--amend选项。对于已经推送到其他用户的远程存储库的验证提交被认为是不好的做法，而使用SVN的dcommit与此类似。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>克隆SVN仓库时，如果没有使用描述仓库布局的选项（--trunk，--tags， - branch，--stdlayout），<code>git svn clone</code>将创建一个完全线性历史记录的Git仓库，其中分支和标签在工作副本中显示为单独的目录。虽然这是获取完整存储库副本的最简单方法，但对于拥有多个分支的项目，它将导致工作副本比主干大很多倍。因此，对于使用标准目录结构（中继/分支/标签）的项目，建议使用选项进行克隆<code>--stdlayout</code>。如果项目使用非标准结构，并且/或者不需要分支和标签，则只需克隆一个目录（通常为主干）即可，而无需提供任何存储库布局选项。如果需要带分支和标签的完整历史记录，则必须使用选项<code>--trunk</code>/ <code>--branches</code>/ <code>--tags</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当使用多分支或 - 标签时，<code>git svn</code>不会自动处理名称冲突（例如，如果来自不同路径的两个分支具有相同名称，或者分支和标签具有相同名称）。在这些情况下，使用<code>init</code>设置您的Git存储库，然后在第一次之前<code>fetch</code>编辑$ GIT_DIR / config文件，以便分支和标签与不同的名称空间相关联。例如：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">branches = stable/*:refs/remotes/svn/stable/*
|
||
|
||
branches = debug/*:refs/remotes/svn/debug/*</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>Bugs</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>我们忽略除svn：executable之外的所有SVN属性。任何未处理的属性都会记录到$ GIT_DIR / svn / <refname> /unhandled.log</p></div></div><div class="doc-postil"><div class="c-markdown"><p>重命名和复制的目录不会被Git检测到，因此在提交SVN时不会被跟踪。我不打算增加对此的支持，因为为所有可能的角落案例工作是非常困难和耗时的（Git也没有这样做）。完全支持提交重命名和复制的文件，只要它们足够类似于Git来检测它们即可。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在SVN中，可以（虽然不鼓励）对标签提交更改（因为标签只是目录副本，因此在技术上与分支相同）。克隆SVN存储库时，<code>git svn</code>不知道将来是否会对此标签进行提交。因此，它保守地行事，并将所有SVN标签作为分支导入，以标签名称作为前缀<code>tags/</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>组态</h2></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git svn</code>将svn-remote配置信息存储在存储库$ GIT_DIR / config文件中。它类似于核心的Git远程部分，但<code>fetch</code>键不接受glob参数; 但它们是由<code>branches</code>和<code>tags</code>键来处理的。由于一些SVN存储库奇怪地配置了多个项目glob扩展，允许使用下面列出的项目：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">[svn-remote "project-a"]
|
||
|
||
url = http://server.org/svn
|
||
|
||
fetch = trunk/project-a:refs/remotes/project-a/trunk
|
||
|
||
branches = branches/*/project-a:refs/remotes/project-a/branches/*
|
||
|
||
branches = branches/release_*:refs/remotes/project-a/branches/release_*
|
||
|
||
branches = branches/re*se:refs/remotes/project-a/branches/*
|
||
|
||
tags = tags/*/project-a:refs/remotes/project-a/tags/*</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>请记住，<code>*</code>本地引用（<code>:</code>*）右边的（星号）通配符必须是最右边的正确路径组件; 但是，只要远程通配符是独立路径组件（由<code>/</code>EOL 包围），远程通配符就可以在任何地方。这种类型的配置不会自动创建<code>init</code>，应该使用文本编辑器或使用手动输入<code>git config</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>另请注意，每个单词只允许使用一个星号。例如：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">branches = branches/re*se:refs/remotes/project-a/branches/*</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>将匹配树枝<code>release</code>，<code>rese</code>，<code>re123se</code>然而，</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">branches = branches/re*s*e:refs/remotes/project-a/branches/*</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>会产生一个错误。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>也可以通过在大括号中使用逗号分隔的名称列表来获取分支或标签的子集。例如：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">[svn-remote "huge-project"]
|
||
|
||
url = http://server.org/svn
|
||
|
||
fetch = trunk/src:refs/remotes/trunk
|
||
|
||
branches = branches/{red,green}/src:refs/remotes/project-a/branches/*
|
||
|
||
tags = tags/{1.0,2.0}/src:refs/remotes/project-a/tags/*</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>支持多个提取，分支和标签密钥：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">[svn-remote "messy-repo"]
|
||
|
||
url = http://server.org/svn
|
||
|
||
fetch = trunk/project-a:refs/remotes/project-a/trunk
|
||
|
||
fetch = branches/demos/june-project-a-demo:refs/remotes/project-a/demos/june-demo
|
||
|
||
branches = branches/server/*:refs/remotes/project-a/branches/*
|
||
|
||
branches = branches/demos/2011/*:refs/remotes/project-a/2011-demos/*
|
||
|
||
tags = tags/server/*:refs/remotes/project-a/tags/*</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>在这种配置中创建分支需要使用-d或--destination标志来消除使用哪个位置：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">$ git svn branch -d branches/server release-2-3-0</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>请注意，git-svn会跟踪出现分支或标记的最高版本。如果分支或标签的子集在获取后发生更改，则必须手动编辑$ GIT_DIR / svn / .metadata以根据需要删除（或重置）分支-maxRev和/或tags-maxRev。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>Files</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>$GIT_DIR/svn/*\*/.rev_map.*</p></div></div><div class="doc-postil"><div class="c-markdown"><p>Subversion版本号和Git提交名之间的映射。在没有设置noMetadata选项的存储库中，可以从每次提交结束时的git-svn-id：行重新创建（参见<code>svn.noMetadata</code>上面的细节部分）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git svn fetch</code>并<code>git svn rebase</code>自动更新rev_map，如果它丢失或不是最新的。<code>git svn reset</code>自动倒带它。</p></div></div></div> |