Ground Up Mercuial
翻译自：http://hginit.com/01.html
即使你只是一个人在战斗，你也应当使用水银来得到版本控制的诸多好处。此教程会展示将一个文件夹交由水银管理是多么地容易，你可以因此而方便地跟踪软件的旧版本。
水银是一个版本控制系统。开发者用它来管理源代码。用它的目的主要有两个：
- 它跟踪旧版本的每一个文件。
- 它可以合并不同版本的代码。因而团队成员可以各自独立地工作，然后把他们所作出的改变合并到一起。
如果没有水银，你可能需要复制一大堆文件夹来保存你的旧版本：
这样做会占据很多磁盘空间，并且过段时间你就搞不清楚哪个是哪个了。使用版本控制器可以很好地解决这个问题。
大多数人使用命令行来管理水银，它在Windows, Unix和Mac平台上都适用。水银的命令为hg:
仅仅输入hg，你会得到一个常用命令的列表。你也可以输入hg help来获得一份更为详尽的列表。
为了使用版本控制，你需要一个repository（仓库）。仓库里保存了你所有文件的历史版本。为了节约硬盘空间，它并没有真的去保存每一个历史版本——它只是保存了版本之间的差异。
在以前，建一个仓库是一件大事。你需要一个中央服务器，并且在上面装软件。然而水银是分布式的，你不需要建什么中央服务器。你完全可以就在个人计算机上使用它。而且建一个仓库超级容易：你只需要进入代码的顶层目录……
……，然后输入hg init：
等等，好像什么事也没有发生？然而，如果仔细瞧一瞧，你会发现多了一个叫.hg的新目录：
那就是仓库！那是一个装满着水银所需的所有文件的目录。里面有一些设置，有文件的历史版本，有标签tags，还有备份，等等。记住这句忠告吧：不要修改里面的任何东西。你也不需要与这个文件夹直接打交道。
好了，我们现在有了一个新的仓库。我们想要把一些源代码添加进去。很简单，输入hg add。
还需要一个步骤…你需要提交变更。什么变更？变更就是：你添加了那么多的文件。
你为什么需要提交？用水银的时候，提交就好比是说：“嘿，请你记住现在这样的文档布局和内容。”这就好像是拷贝了一下整个文件夹…每一次你改变了一些内容，你就可以commit一下。
水银会弹出一个编辑器，从而你可以输入一些提交信息。这些信息只是为了提醒你自己，这次提交作了哪些改变。
当你保存并退出，你的文件就被提交了。
你可以输入hg log来看一看历史变更。这就像你的仓库的部落格。
现在不如再来编辑一个文件，看看会发生什么。
现在我们又作了另外一个变更，我们可以用hg commit来提交。
看，水银能够知道只有一个文件，a.txt被改变了：
提交过后，我们再来看看log：
就像任何现代的部落格一样，水银把最新的事件放在最上面。
再来一次变更：
提交：
提交信息：
现在的log：
OK。到现在为之，我做了一些变更。而且每当我作出一个重要的变更之后，我都会把它提交到仓库中去。
我知道你在想些什么。你在想，“JOEL, 这简直在浪费时间！”为什么一个提交讲这么久！真是懒婆娘的裹脚布！
请耐心一点，年轻人！你马上就会学到如何从提交中得到好处。
首先，比如说你在编辑的时候犯了点错。
然后，天呐，你删了一些非常重要的文件。
【此处有原作者的小故事。因与主题关系不大，略过……】
感谢水银，当你对自己的改变不满时，你可以输入hg revert。水银会把你的目录里的所有东西恢复到最后一次提交时的样子。
之所以使用参数--all是因为想要把所有的文件都回滚到它们的初始状态上。
因此，当你使用水银管理你的源代码时，你可以：
- 做一些变更
- 看它们是否正确有效
- 如果是，则commit它们
- 如果不是，则revert它们
- GOTO 1
（我知道，我一会儿用Windows的CMD界面，一会儿又用GOTO语句，一定会招来你们的不满与吐槽。）
随着时间的流逝，你可能不记得每个版本都具体做过哪些变化。不过不要紧，水银替你跟踪了。你只需要输入hg status，水银就会给你显示你改变过的文件。
假设我首先创建了一个文件，然后编辑了一个文件，最后删除了一个文件。
hg status将你改变的任何一个文件都显示出来。“M”表示“更改”——文件被修改过了。“！”表示丢失——文件本来应该在的，可现在却没了。“？”表示不知道——水银对那个文件现在还一无所知。
我们一个一个来看。那个更改了的文件，a.txt。更改了什么？你可能已经忘了。有一个命令可以帮助你：hg diff。它会告诉你从上一次的提交到现在，文件作了哪些变化。
这种格式似乎有一点神秘，但最让人感兴趣的部分是：如果那块看到一些行前面有一个减号，表示它们被删除了；一些行前面有一个加号，则表明这些行被添加了。所以上面的例子中，“Normal people”被编辑成了“Civilians”。
现在来看那个遗失的文件，favicon.ico。像之前说的那样，如果你并不想删除它，则可以使用hg revert；如果你真的要删除它的话，你需要告诉水银：
“R”表示“Removed”。因此下次commit的时候，这个文件将被删除。最后，我们需要加上新的文件，b.txt：
“A”表示“Added。”你有没有发现我已经懒得把hg status打全了？水银只需要足够多的可以区分的字母。而以st打头的也只有这一条命令而已。
把所有的？和！都解决了之后，就可以继续commit了。
关于hg log还有一件事：变更集（changeset）那一行显示了一个数字……实际上是两个数字。一个简单的，比如“0”来表示最初的版本。还有一串长的，十六进制的数字你可以暂时忽略。
记住，水银保存了足够的信息，可以来重构任何一个历史版本。
首先，一个简单的命令hg cat可以被用来打印某个文件的任何历史版本。
例如，我们可以看看a.txt现在长什么样子。
如果想看它过去的样子，可以加一个-r("revision")参数：
如果文件很长，很复杂，并且其实至改变了一点点。那我们可以使用hg diff带上-r参数来查看两个版本之间的差异在什么地方。
最后，在你快达到你看一篇文章的身体极限之前，我还想告诉你一件小事：你可以使用hg update这个命令来到达你想要的任何一个版本。
如果不带任何参数，则hg update会更新到最新的版本。
自测
OK！ 此为教程1。下面是你应当已经掌握的知识：
- 创建一个仓库
- 在仓库中添加或删除文件
- 当做了变更，看看有哪些没有提交的变更，然后
- 如果你觉得这些变更还不错，就commit，
- 如果你觉得这些变更不行，就revert。
- 查看文件的旧版本，并让自己的工作目录可以update成任何一个版本。