1   基本概念

Revision

在使用 Mercurial 的系统中每个改动隔离在各自的 repository 里， 既避免把不相关的代码混杂起来，又便于一个接一个的测试每一部分工作， 用户做的每个改动称为一个 revision。 一般会有一个所有用户都可以访问得到的 repository 保存了项目的“主要”版本， 工作repository 是用户自己做事情的地方，实现新的特性，修改漏洞，重构，实验等， 当完成改变后，你可以 push 到共用的 repositor y中，即完成了一个 revision。

Changeset

一个或多个文件的改变集合在一起形成一个逻辑单元，称为 changeset。 每一个 changeset 由两部分内容描述，版本号和 changeset 标识， 例如：changeset: 207:58e4906e69e3冒号前面的数字代表版本号， 它用来标识本地 changeset。这个版本号只有在用户的本地repository 中才有意义。 冒号后面的那个很长的十六进制串是changeset标识, 它是确定changeset的全局唯一标识符, 在所有包含这个 changese的 repository 中都相同。多个用户之间讨论changeset， 一般使用这个 changeset标识，而不是上面说的版本号， 因为完全有可能每个用户的 repository 中同样的changeset 版本号不同。

Head

Head 表示 repository 中每个分支最新的 revision， 通常在合并几个分支时会用到这个概念。

Tip

Tip 是最新的一个 changeset 的版本号的一个别名。 在命令中任何使用版本号的地方都可以使用 tip 来代替最新的 changeset的版本号。 Tip在各个repository中是不同的，同时一个repository 中只有一个 tip。

Log

Log 命令按时间顺序从近到远的记录着在 repository 中发生的每一次事件。 可以通过指定 -v 诊断输出选项来获得更多更详细的历史信息， 或者指定 -debug 选项来获得历史信息中的一切细节。

英文说明: Revisions, changesets, heads, and tip

Mercurial groups related changes to multiple files into single atomic changesets, which are revisions of the whole project. These each get a sequential revision number. Because Mercurial allows distributed parallel development, these revision numbers may disagree between users. So Mercurial also assigns each revision a global changeset ID. Changeset IDs are 40-digit hexadecimal numbers, but they can be abbreviated to any unambiguous prefix, like "e38487".

Branches and merges in the revision history can occur at any point. Each unmerged branch creates a new head of the revision history. Here, revisions 5 and 6 are heads. Mercurial considers revision 6 to be the tip of the repository, the head with the highest revision number. Revision 4 is a merge changeset, as it has two parent changesets (revisions 2 and 3).

2   基本操作

[ui]
username = xxx <xxx@xxx.com>
verbose = True

[extensions]
mercurial_keyring =

[extensions]
hgext.extdiff =

[extdiff]
cmd.kdiff3 =

[merge-tools]
kdiff3.args = $base $local $other -o $output

hg init example

hg add hello.txt

hg forgot hello.txt

hg forgot hello.txt

hg status

hg commit

hg diff

hg copy hello.txt hello2.txt
hg mv hello.txt hello1.txt

hg remove hello.txt

hg log

hg update
hg update tip
hg update -r 3

hg revert hello.txt

hg revert --all

hg revert -r 3 hello.txt

hg backout -r 3

hg revert -r 3 --all

3   进阶操作

hg clone example example2
hg clone http://bitbucket.org/xxxx xxxx

hg incoming

hg pull

hg incoming

hg push

hg merge

hg rollback

hg commit --amend

hg bookmarks

hg bookmark feature-a

hg bookmark --rename feature-a feature-hello

hg bookmark --delete feature-a

hg branches

hg branch stable
hg commit -m "Started stable branch."
hg tag 1.0

hg update stable
hg graft tip  # 或者 hg graft -r 12
hg tag 1.0.1
hg update default
hg merge stable

hg tags

hg tag 1.0

hg tag 1.1 -r 30

hg serve

4   使用 Hgweb 架设服务器

参考: http://mercurial.selenic.com/wiki/PublishingRepositories

系统环境:

• Apache 2.2 - 2.4
• Mod_wsgi 3.5
• Python 2.7.x
• Mercurial 3.2 - 3.4
• Virtualenv

Hgweb 从 Mercurial 代码仓库中获取.

相关路径:

• Hgweb 目录: /var/www/hgweb
• 虚拟环境路径: /var/www/hgweb/env
• 仓库路径: /var/www/hgweb/repos

文件 /var/www/hgweb/hgweb.wsgi:

# An example WSGI for use with mod_wsgi, edit as necessary
# See http://mercurial.selenic.com/wiki/modwsgi for more information

# Path to repo or hgweb config to serve (see 'hg help hgweb')
config = "/var/www/hgweb/hgweb.conf"

# Uncomment and adjust if Mercurial is not installed system-wide
# (consult "installed modules" path from 'hg debuginstall'):
# import sys; sys.path.insert(0, "/var/www/hgweb")

# Uncomment to send python tracebacks to the browser if an error occurs:
#import cgitb; cgitb.enable()

activate_this = '/var/www/hgweb/env/bin/activate_this.py'
execfile(activate_this, dict(__file__=activate_this))

# enable demandloading to reduce startup time
from mercurial import demandimport; demandimport.enable()

from mercurial.hgweb import hgweb
application = hgweb(config)

配置文件 /var/www/hgweb/hgweb.conf:

[paths]
# mysite = /var/www/hgweb/repos/mysite
/ = /var/www/hgweb/repos/*

[web]
baseurl = /hg
encoding = "UTF-8"
allow_archive = bz2 gz zip
descend = True
collapse = True
allow_push = *
push_ssl = False

创建仓库路径:

cd /var/www/hgweb/
mkdir repos
chown -R daemon:daemon repos
cd repos
hg init mysite
chown -R daemon:daemon mysite

Httpd 配置:

WSGIScriptReloading On
WSGIDaemonProcess hgweb threads=5 display-name=%{GROUP}
WSGIScriptAlias /hg /var/www/hgweb/hgweb.wsgi
WSGIProcessGroup hgweb

<Location /hg>
    AuthType Basic
    AuthName "Mercurial repositories"
    AuthUserFile /var/www/hgweb/hgweb_users
    <LimitExcept GET>
        Require valid-user
        # Require user digwtx
    </LimitExcept>
    # Require valid-user
</Location>

用户认证文件的操作:

htpasswd -c /var/www/hgweb/hgweb_users digwtx  # 创建文件和用户
htpasswd /var/www/hgweb/hgweb_users digwtx01  # 追加用户, 或修改密码

5   参考文档

• http://mercurial.aragost.com/kick-start/en/basic/
• https://mercurial.selenic.com/guide
• https://mercurial.selenic.com/wiki/UnderstandingMercurial
• http://hginit.com/
• http://hgbook.red-bean.com/