教程 - 生成第一个[变更]
完成了[:ChineseTutorialHistory:教程-历史] 的学习之后， 我们来到 my-hello [仓库]里面，就是我们在 [:ChineseTutorialClone:教程-克隆]中 [克隆] 得到的。
在 ["Mercurial"] 开发实践中一个好的做法是把每个变更隔离在各自的[:Repository:仓库]里。这样可以避免把不相关的代码混杂起来， 并且便于一个接一个的测试每一部分工作。我们现在就开始采用这一模式。
我们的目标很简单，让“hello, world”程序打印另外一行输出。 首先， 我们给这个小项目创建一个新的仓库叫做 my-hello-new-output，方法是对my-hello做克隆。
$ cd .. $ hg clone my-hello my-hello-new-output
这一次， 克隆命令如果成功将不会打印任何输出。
注: 注意我们给新的 [:Repository:仓库] 命名了一个描述性 的名字，基本上是说明这个[:Repository:仓库]的目的。 在["Mercurial"]里面给一个[:Repository:仓库]创建[克隆]很方便，我们会很快的积攒起很多稍微不同的仓库。如果我们不给他们描述性的命名， 很快就会没法分辨它们。
现在可以在新的仓库里面进行修改了 。 我们进入[:WorkingDirectory:工作目录]，使用我们喜欢的编辑软件修改源文件。
$ 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命令来恢复到我们没有更改的状态。请确认你确实知道这是你真的希望做的。
$ hg revert
创建一个变更集的动作称为[:"Commit":提交]它。我们用commit命令来执行[:"Commit":提交]。
$ hg commit
这个命令把我们带到一个编辑器内，同时给我们展示了几行语焉不详的文字。
注: 缺省的编辑器是vi。这可以用环境变量EDITOR 或 HGEDITOR 来改变。同样，根据你怎样输入和保存文件，变更集记录哈希表可能不一样。
(empty line) HG: manifest hash 14595beb70bcfb74bf227437d70c38878421c944 HG: changed hello.c
第一行是空的，接下来的几行标明哪些文件将进入本变更集。T
为了[:"Commit":提交]变更集，我们必须描述它的原因。这通常称为变更集注释。让我们输入一些：
Express great joy at existence of Mercurial HG: manifest hash 14595beb70bcfb74bf227437d70c38878421c944 HG: changed hello.c
接着，我保存测试并退出编辑器，如果一切正常，commit命令将没有任何提示地退出。 如果你在没有保存文本的情况下退出编辑器，commit 将中断操作，这样你可以在提交前改变你的想法。
让我们看看status命令现在告诉我们什么？
$ hg status
什么也没有！我们的变更已经[:"Commit":提交]到变更集里了，那里没有修改的文件需要提交的。我们的[:"Tip":末端]现在和我们工作目录的内容一致了。
我们现在可以为我们的新工作检查变更的历史：
$ 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 (...)
就是它了！我们已经[:"Commit":提交]了一个变更集。
注: 用户，日期和[:ChangeSetID:变更集号]当然和我的是不一样的。
正如我们在[:ChineseTutorialClone:教程--复制]中讨论的，新的[:ChangeSet:变更集]只存在于本仓库中。 这是["Mercurial"]关键的一部分工作方法。
如果要分享变更，我们必须继续[:ChineseTutorialShareChange:教程 - 与别的仓库分享改变]。