SCM 是好東西

• 管程式碼
• 管文稿
• 管設定檔

RCSCVSSVN

• File based.
• File set based.
• Directory based.

通通都是 centralized。

什麼是管理

• commit 紀錄
  • diff
  • log
• 多重版本 -- branch
• 幫助記憶 -- tag, revision

CSCM 共享的問題

• 大家都要抓得到收藏庫。
  • 收藏庫是輸出入瓶頸。
  • 沒有網路便無法管理。

Mercurial DSCM 解決 CSCM 的共享問題

http://www.selenic.com/mercurial/wiki/index.cgi/Mercurial

• Changeset based.
• 所有收藏庫均獨立運作。
• 各收藏庫間用 pull push 溝通。
  • 用 changeset 識別修改。
• 程式員在本地工作時，不只有 working copy，同時還有一份收藏庫。

MERCURIALIZE

• 收藏庫轉換 OK for SVNCVSBZRGITDARCS。
• JUST ADD.
• 也有像 svk 一樣的 hgsvn (當然，還在 alpha 階段的東西沒法兒和成熟專案比)。

Filled with Hg

• 安裝 setuptools。
• easy_install mercurial
• 如果在 windows 下，可安裝 PyWin32，這樣 hg clone 就會用 NTFS 的 hardlink。
  • 還要找個 merge 程式來用。

開始使用 mercurial

• hg init repo

  • 會建個叫作 repo 的目錄，裡面有個 .hg 目錄。它就是收藏庫。

• echo 'print "Hello, world."' > test.py

  C:\worktmp\testrepo>hg add
  adding test.py
  

• hg ci -m "Add a file"

就這樣。

建立共享收藏庫

• mercurial 內建 CGI 與 FastCGI 支援。
  • 自己的收藏庫用 CGI 就好，省得麻煩。
  • 佈署零煩惱；有支援 Python 的 shared hosting 都可以用。
• 允許從客戶端 pull 和 push。
• 使用 HTTP basic authentication 資訊。

取用他人收藏庫

• hg clone blahblah

  C:\worktmp>hg clone http://hg.seety.org/software/bambook
  destination directory: bambook
  requesting all changes
  adding changesets
  adding manifests
  adding file changes
  added 51 changesets with 185 changes to 76 files
  59 files updated, 0 files merged, 0 files removed, 0 files unresolved
  

mercurial 重要操作

• pull：從來源收藏庫取得新資訊。
• push：把本地收藏庫變更傳給來源收藏庫。
• ci：把 working copy 變更記入本地收藏庫。
• up：把收藏庫的變更套進 working copy。
• merge：合併有差異的變更。

推回去

• hg push
• hg push http://the.host/of/the/repository/
• 都可以。
• 所以不是一定要推回「原來那個收藏庫」。

merge

• hg merge; hg commit -m "Merged blahblah."
• 噗的一聲就好了。
• 收藏庫裡出現兩個 head 時就要 merge。(除非....

branches and tags

和 SVN 不一樣！

• Are all named meta information.
• 各 branches 間不主動 merge。
  • 收藏庫允許 branch 有自己的 head，不必和別人 merge。
  • 不過單個 branch 裡若出現了兩個 head，還是得要 merge 才能繼續長。

hg view

帥啊。有圖就是比較棒。

• 畫出收藏庫的歷史演進。
• hgk 工具是要角。
  • 以 TCL/TK script 撰寫。
  • 在 Windows 下請安裝 ActiveTcl。
    • 記得改設定。
• 可惜還不會認 branches。
• 如果用 wx 改寫一個一定很酷。

other mercurial feathers

• 收藏庫不能放空目錄。
  • mercurial 的 changeset 只記檔案資訊。
  • 真要加空目錄，得補個 placeholder 檔案。
• Patch 管理：mercurial queue。
  • mercurial queue 就是在主收藏庫之外，專門給 patch 建的收藏庫。
• Trac 0.10/11 已經有可用的 mercurial plugin。

參考

• 很棒的 mercurial 書：http://hgbook.red-bean.com/ (未完成)
• 主網站 (wiki)：http://www.selenic.com/mercurial/wiki/index.cgi/Mercurial

END

• 謝謝

• 大家