stg - 云端在线

程序：

您的姓名

stg - 使用 Git 内容跟踪器管理补丁堆栈

概要

STG [--版本 | - 帮助]
STG [ - 帮助| - 帮助]
STG [命令选项] [ARGS]

商品描述

StGit (Stacked Git) 是一个应用程序，它提供了一种方便的方式来维护一个 补丁
堆 在 Git 分支之上：

· 分支的最顶层（最近）提交被命名。 这样的命名提交是
叫做 补丁.

· 对工作树进行更改后，您可以将更改合并到现有的
修补; 这就是所谓的 清爽. 您可以刷新任何补丁，而不仅仅是最上面的补丁。

· 你可以 流行的 贴片：暂时搁置一旁，使其下方的贴片变成
最上面的补丁。 以后你可能 推 它再次进入堆栈。 推挤罐头
用于重新排序补丁。

·你可以轻松 变基 您的补丁堆栈位于任何其他 Git 提交之上。 （这 基地 的
补丁堆栈是不是 StGit 补丁的最新 Git 提交。）例如，如果
你开始在别人的分支上打补丁，然后那个人发布
更新的分支，您可以获取所有补丁并将它们应用到更新的分支之上
科。

· 如您所料，更改补丁下方的内容可能会导致该补丁不再
干净地应用——当你重新排序补丁、重新设置补丁或刷新一个补丁时，可能会发生这种情况
非顶级补丁。 StGit 使用 Git 的重命名感知三路合并功能
自动修复它可以修复的东西； 如果它仍然失败，它可以让您手动解决
冲突就像在 Git 中解决合并冲突一样。

· 补丁栈只是一些附加到常规 Git 提交的额外元数据，所以你
可以继续使用大多数 Git 工具以及 StGit。

Typical 使用
跟踪分支
跟踪来自远程分支的更改，同时维护针对
那个分支，可能是为了向上游发送一些补丁。 你可以修改
尽可能多地堆叠您的补丁程序，以及您的补丁程序何时最终被接受
在上游，永久记录的 Git 历史将只包含最终的序列
补丁，而不是产生它们的混乱编辑序列。

在这个工作流程中感兴趣的命令是例如 rebase 和 mail。

开发分公司
即使你没有“上游”可以发送补丁，你也可以使用 StGit 作为一个方便的
修改 Git 分支最近历史的方法。 例如，而不是第一个
提交改变 A，然后更改 B， 接着 A2 修复 A 因为它不完全
是的，您可以将修复程序直接合并到 A. 这种工作方式导致
比如果你把你犯下的每一个错误都永生化，那么更易读的 Git 历史
您找到正确解决方案的方法。

在这个工作流中感兴趣的命令是例如 uncommit，它可以用来移动
向下补丁堆栈基础 - 即，事后将 Git 提交转换为 StGit 补丁
- 并提交，它的反面。
欲了解更多信息，请参阅 此 教程[1]。

指定 补丁
许多 StGit 命令将 StGit 补丁的引用作为参数。 堆栈中的补丁
用短名称标识，每个短名称在堆栈中必须是唯一的。

当前分支中的补丁仅通过其名称进行引用。 一些命令允许
您在存储库的另一个分支中指定补丁； 这是通过添加前缀来完成的
带有分支名称和冒号的补丁名称（例如 otherbranch:thatpatch）。

指定 提交
一些 StGit 命令将 Git 提交作为参数。 StGit 接受所有提交表达式
Git 做到了； 此外，补丁名称（可选地以分支名称和
冒号）在这种情况下是允许的。 通常的 Git 修饰符 ^ 和 ~ 也是允许的； 例如，
abranch:apatch~2 是提交的祖父，它是分支上的补丁补丁
分店。

代替补丁名称，您可以说 {base} 来引用堆栈基础（提交只是
在最底部的补丁下方）； 所以，abranch:{base} 是 branch 中堆栈的基础
分店。

如果您需要将给定的 StGit 引用传递给 Git 命令， stg-id(1) 将其转换为
一个 Git 提交 ID 给你。

配置

以下通用选项标志可用。 附加选项可用于
（并记录在案）不同的子命令。

- 版
打印 StGit 版本，以及使用的其他组件的版本，例如 Git 和
蟒蛇。

- 帮帮我
打印概要和所有子命令的列表。 如果给出了 StGit 子命令，
打印该子命令的概要。

科学与技术学院 指令

我们将 StGit 命令划分为主题组，根据它们的主要对象类型
创造或改变。

以下是每个命令的简短说明。 更详细的描述可在
单独的命令联机帮助页。 这些联机帮助页被命名为 stg- (1).

存储库 命令
stg-克隆(1)
制作远程存储库的本地克隆

stg-id(1)
打印 StGit 引用的 git 哈希值

堆 （分支） 命令
stg-分支(1)
分支操作：切换、列出、创建、重命名、删除、...

stg-清洁(1)
删除系列中的空补丁

stg-提交(1)
将应用的补丁永久存储到堆栈库中

stg-浮动(1)
将补丁推到顶部，即使应用

stg-转到(1)
将补丁推送或弹出给给定的补丁

stg-隐藏(1)
隐藏系列中的补丁

初始化(1)
初始化当前分支以与 StGIT 一起使用

stg 日志(1)
显示补丁更改日志

stg-下一个(1)
打印下一个补丁的名称

stg-补丁(1)
显示修改文件的应用补丁

stg-流行音乐(1)
从堆栈中弹出一个或多个补丁

上一页(1)
打印上一个补丁的名称

stg-发布(1)
将堆栈更改推送到合并友好的分支

stg 拉(1)
从远程存储库中拉取更改

stg推送(1)
将一个或多个补丁推入堆栈

stg 变基(1)
将堆栈基移动到历史中的另一个点

stg-重做(1)
撤消上次撤消操作

stg-修复(1)
如果使用 git 命令修改了分支，则修复 StGit 元数据

stg-重置(1)
将补丁堆栈重置为较早的状态

stg系列(1)
打印补丁系列

stg-接收器(1)
将补丁发送到堆栈的更深处

stg-壁球(1)
将两个或多个补丁压缩成一个

顶层(1)
打印顶部补丁的名称

stg-取消提交(1)
将常规的 git 提交转换为 StGit 补丁

stg-撤消(1)
撤销上次操作

stg-取消隐藏(1)
取消隐藏隐藏补丁

打补丁 命令
stg-删除(1)
删除补丁

stg-编辑(1)
编辑补丁描述或差异

stg-出口(1)
将补丁导出到目录

stg 文件(1)
显示补丁修改的文件（或当前补丁）

stg 折叠(1)
将 GNU 差异补丁集成到当前补丁中

stg-进口(1)
将 GNU diff 文件作为新补丁导入

stg邮件(1)
通过电子邮件发送一个补丁或一系列补丁

stg-新(1)
创建一个新的空补丁

stg选择(1)
从不同的分支或提交对象导入补丁

stg-刷新(1)
为当前补丁生成一个新的提交

stg-重命名(1)
重命名补丁

stg秀(1)
显示与补丁对应的提交

stg同步(1)
将补丁与分支或系列同步

索引/工作树 命令
stg差异(1)
显示树差异

配置 机制

StGit 使用与 Git 相同的配置机制。 看 混帐(7) 了解更多详情。

TEMPLATES

许多 StGit 命令使用模板文件来提供有用的默认文本
由用户编辑。 这些.tmpl模板文件在下面搜索
目录：

1. $GITDIR/（实际上是你仓库中的 .git/ 目录）

2. $HOME/.stgit/模板/

3. /usr/share/stgit/模板/

附注

1.教程
[设置 $man.base.url.for.relative.links]/tutorial.html

使用 onworks.net 服务在线使用 stg