Diff for "ChineseTutorialFirstChange"

教程 - 生成第一个[变更]

完成了教程-历史 的学习之后， 我们来到 my-hello [仓库]里面，就是我们在 教程-克隆中 [克隆] 得到的。

在 Mercurial 开发实践中一个好的做法是把每个变更隔离在各自的仓库里。这样可以避免把不相关的代码混杂起来， 并且便于一个接一个的测试每一部分工作。我们现在就开始采用这一模式。

我们的目标很简单，让“hello, world”程序打印另外一行输出。 首先， 我们给这个小项目创建一个新的仓库叫做 my-hello-new-output，方法是对my-hello做克隆。

$ cd ..
$ hg clone my-hello my-hello-new-output

updating to branch default 2 files updated, 0 files merged, 0 files removed, 0 files unresolved

注: 注意我们给新的 仓库 命名了一个描述性 的名字，基本上是说明这个仓库的目的。 在Mercurial里面给一个仓库创建[克隆]很方便，我们会很快的积攒起很多稍微不同的仓库。如果我们不给他们描述性的命名， 很快就会没法分辨它们。

现在可以在新的仓库里面进行修改了 。 我们进入工作目录，使用我们喜欢的编辑软件修改源文件。

$ cd my-hello-new-output

 * Placed in the public domain by Bryan O'Sullivan
 *
 * This program is not covered by patents in the United States or other
 * countries.
 */

#include <stdio.h>

int main(int argc, char **argv)
{
        printf("hello, world!\n");
        return 0;
}

我们要修改 main 让它再多打印一行输出：

(...)

int main(int argc, char **argv)
{
        printf("hello, world!\n");
        printf("sure am glad I'm using Mercurial!\n");
        return 0;
}

完成之后退出我们喜欢的编辑器，任务完成。 有了刚才的修改我们就可以创建一个[变更集]。

可是万一我们被别的事情打扰，在创建变更集之后忘记了它里面有哪些变更，怎么办呢？ 这时候我们要用到status命令。

$ hg status
M hello.c

输出很简短。总之以 M 开头的行意思就是hello.c文件修改过了，那么我们的变更已经可以加入一个变更集了。

使用 diff 命令我们可以检查文件实际的改变：

$ hg diff
diff -r 82e55d328c8c hello.c
--- a/hello.c   Fri Aug 26 01:21:28 2005 -0700
+++ b/hello.c   Fri Sep 30 10:27:47 2005 +0800
@@ -12,5 +12,6 @@
 int main(int argc, char **argv)
 {
        printf("hello, world!\n");
+       printf("sure am glad I'm using Mercurial!\n");
        return 0;
 }

万一我们希望放弃我们的变更并重新开始，我们可以用revert命令来恢复hello.c到我们没有更改的状态(或者用--all选项来恢复所有文件)。请确认你确实知道这是你真的希望做的(参见 Revert)。

$ hg revert hello.c

revert重命名被编辑文件hello.c为hello.c.orig并恢复hello.c到它的未编辑状态。 status命令现在会将hello.c.orig视为不被追踪的(以"?"为前缀)。

$ hg st
? hello.c.orig

如果我们又改变主意想要重用我们做的修改，我们只需要移除未编辑状态的hello.c然后重命名我们改过的hello.c.orig为hello.c

$ rm hello.c
$ mv hello.c.orig hello.c
$ hg st
M hello.c

创建一个变更集的动作称为提交它。我们用commit命令来执行提交。

$ hg commit

这个命令把我们带到一个编辑器内，同时给我们展示了几行语焉不详的文字。

注: 缺省的编辑器是vi。这可以用环境变量EDITOR 或 HGEDITOR 来改变。同样，根据你怎样输入和保存文件，变更集记录哈希表可能不一样。

(empty line)
HG: manifest hash 14595beb70bcfb74bf227437d70c38878421c944
HG: changed hello.c

第一行是空的，接下来的几行标明哪些文件将进入本变更集。T

为了提交变更集，我们必须描述它的原因。这通常称为变更集注释。让我们输入一些：

Express great joy at existence of Mercurial
HG: manifest hash 14595beb70bcfb74bf227437d70c38878421c944
HG: changed hello.c

接着，我保存测试并退出编辑器，如果一切正常，commit命令将没有任何提示地退出。 如果你在没有保存文本的情况下退出编辑器，commit 将中断操作，这样你可以在提交前改变你的想法。

让我们看看status命令现在告诉我们什么？

$ hg status

什么也没有！我们的变更已经提交到变更集里了，那里没有修改的文件需要提交的。我们的末端现在和我们工作目录的内容一致了。

我们现在可以为我们的新工作检查变更的历史：

$ hg log
changeset:   2:a58809af174d
tag:         tip
user:        mpm@selenic.com
date:        Fri Aug 26 01:26:28 2005 -0700
summary:     Express great joy at existence of Mercurial

(...)

就是它了！我们已经提交了一个变更集。

注: 用户，日期和变更集号当然和我的是不一样的。

正如我们在教程--复制中讨论的，新的变更集只存在于本仓库中。 这是Mercurial关键的一部分工作方法。

如果要分享变更，我们必须继续教程 - 与别的仓库分享改变。

CategoryChinese