22.5　用Topgit方式改造Topgit

    在Topgit的使用中陆续发现了一些不合用的地方，于是便以Topgit特性分支的方式来对Topgit进行改造。在群英汇的博客上介绍了如下几个改造：

    TopGit改进（1）：tg push全部分支[1]

    TopGit改进（2）：tg导出全部分支[2]

    TopGit改进（3）：更灵活的tg patch[3]

    TopGit改进（4）：tg命令补齐[4]

    TopGit改进（5）：tg summary执行的更快[5]

    下面就以Topgit改造过程为例，来介绍如何参与一个Topgit管理下的项目的开发。改造后的Topgit版本库地址为：git://github.com/ossxp-com/topgit.git。

    首先克隆该版本库：

    $git clone git://github.com/ossxp-com/topgit.git $cd topgit

    查看远程分支：

    $git branch-r origin/HEAD-＞origin/master origin/master origin/t/debian_locations origin/t/export_quilt_all origin/t/fast_tg_summary origin/t/graphviz_layout origin/t/tg_completion_bugfix origin/t/tg_graph_ascii_output origin/t/tg_patch_cdup origin/t/tg_push_all origin/tgmaster

    看到远程分支中出现了熟悉的以t/为前缀的Topgit分支，说明这个版本库是一个由Topgit进行管理的版本库。为了能够获取Topgit各个特性分支的基准分支，需要用tg remote命令对默认的origin远程版本库注册一下。

    $tg remote—populate origin tg:Remote origin can now follow TopGit topic branches. tg:Populating local topic branches from remote'origin'… From git://github.com/ossxp-com/topgit *[new branch]refs/top-bases/t/debian_locations-＞ origin/top-bases/t/debian_locations *[new branch]refs/top-bases/t/export_quilt_all-＞ origin/top-bases/t/export_quilt_all *[new branch]refs/top-bases/t/fast_tg_summary-＞ origin/top-bases/t/fast_tg_summary *[new branch]refs/top-bases/t/graphviz_layout-＞ origin/top-bases/t/graphviz_layout *[new branch]refs/top-bases/t/tg_completion_bugfix-＞ origin/top-bases/t/tg_completion_bugfix *[new branch]refs/top-bases/t/tg_graph_ascii_output-＞ origin/top-bases/t/tg_graph_ascii_output *[new branch]refs/top-bases/t/tg_patch_cdup-＞ origin/top-bases/t/tg_patch_cdup *[new branch]refs/top-bases/t/tg_push_all-＞ origin/top-bases/t/tg_push_all tg:Adding branch t/debian_locations… tg:Adding branch t/export_quilt_all… tg:Adding branch t/fast_tg_summary… tg:Adding branch t/graphviz_layout… tg:Adding branch t/tg_completion_bugfix… tg:Adding branch t/tg_graph_ascii_output… tg:Adding branch t/tg_patch_cdup… tg:Adding branch t/tg_push_all… tg:The remote'origin'is now the default source of topic branches.

    执行tg summary查看一下本地Topgit特性的分支状态。

    $tg summary r!t/debian_locations[PATCH]make file locations Debian-compatible r!t/export_quilt_all[PATCH]t/export_quilt_all r!t/fast_tg_summary[PATCH]t/fast_tg_summary r!t/graphviz_layout[PATCH]t/graphviz_layout r!t/tg_completion_bugfix[PATCH]t/tg_completion_bugfix r t/tg_graph_ascii_output[PATCH]t/tg_graph_ascii_output r!t/tg_patch_cdup[PATCH]t/tg_patch_cdup r!t/tg_push_all[PATCH]t/tg_push_all

    怎么？出现了感叹号？记得前面在介绍tg summary命令的章节中提到过，感叹号的出现说明该特性分支所依赖的分支丢失了。用tg info查看一下其中的某个特性分支。

    $tg info t/export_quilt_all Topic Branch:t/export_quilt_all(6/4 commits) Subject:[PATCH]t/export_quilt_all Base:8b0f1f9 Remote Mate:origin/t/export_quilt_all Depends:tgmaster MISSING:tgmaster Up-to-date.

    原来该特性分支依赖tgmaster分支，而不是master分支。远程存在tgmaster分

    空标题文档 - 图1

    空标题文档 - 图2

    其中：

    特性分支t/export_quilt_all，为tg export—quilt命令增加—all选项，以便导出所有的特性分支。

    特性分支t/fast_tg_summary，主要是改进tg命令补齐时分支的显示速度，当特性分支接近上百个时差异非常明显。

    特性分支t/graphviz_layout，改进了分支的图形输出格式。

    特性分支t/tg_completion_bugfix，解决了命令补齐的一个Bug。

    特性分支t/tg_graph_ascii_output，源自Bert Wesarg的贡献，非常巧妙地实现了文本化的分支图显示，展示了gvpr命令的强大功能。

    特性分支t/tg_patch_cdup，解决了在项目的子目录下无法执行tg patch的问题。

    特性分支t/tg_push_all，通过为tg push增加—all选项，解决了当tg从0.7版升级到0.8版后，无法批量向上游推送特性分支的问题。

    下面展示一下如何跟踪上游的最新改动，并迁移到新的上游版本。分支tgmaster用于跟踪上游的Topgit分支，以t/开头的分支是对Topgit改进的特性分支，而master分支实际上是导出Topgit补丁文件并负责编译特定Linux平台发行包的分支。具体操作过程如下：

    （1）把官方的Topgit版本库以upstream的名称加入作为新的远程版本库。

    $git remote add upstream git://repo.or.cz/topgit.git

    （2）然后将upstream远程版本的master分支合并到本地的tgmaster分支。

    $git pull upstream master:tgmaster From git://repo.or.cz/topgit 29ab4cf..8b0f1f9 master-＞tgmaster

    （3）此时再执行tg summary会发现所有的Topgit分支都多了一个标记D，表明因为依赖分支的更新而导致Topgit特性分支过时了。

    $tg summary r D t/debian_locations[PATCH]make file locations Debian-compatible r D t/export_quilt_all[PATCH]t/export_quilt_all r D t/fast_tg_summary[PATCH]t/fast_tg_summary r D t/graphviz_layout[PATCH]t/graphviz_layout r D t/tg_completion_bugfix[PATCH]t/tg_completion_bugfix r D t/tg_graph_ascii_output[PATCH]t/tg_graph_ascii_output r D t/tg_patch_cdup[PATCH]t/tg_patch_cdup r D t/tg_push_all[PATCH]t/tg_push_all

    （4）依次对各个分支执行tg update，完成对更新的依赖分支的合并。

    $tg update t/export_quilt_all …

    （5）对各个分支完成更新后，会发现tg summary的输出中，标识过时的D标记变为L，即本地比远程服务器分支要新。

    $tg summary rL t/debian_locations[PATCH]make file locations Debian-compatible rL t/export_quilt_all[PATCH]t/export_quilt_all rL t/fast_tg_summary[PATCH]t/fast_tg_summary rL t/graphviz_layout[PATCH]t/graphviz_layout rL t/tg_completion_bugfix[PATCH]t/tg_completion_bugfix rL t/tg_graph_ascii_output[PATCH]t/tg_graph_ascii_output rL t/tg_patch_cdup[PATCH]t/tg_patch_cdup rL t/tg_push_all[PATCH]t/tg_push_all

    （6）执行tg push—all就可以实现将所有的Topgit特性分支推送到远程服务器上，当然需要有提交权限才可以。

    [1]http://blog.ossxp.com/2010/01/247/

    [2]http://blog.ossxp.com/2010/01/255/

    [3]http://blog.ossxp.com/2010/01/257/

    [4]http://blog.ossxp.com/2010/01/259/

    [5]http://blog.ossxp.com/2010/01/261/