Subversion 的 Log

使用 Subversion 之類的 version control system 時，commit log 是非常重要的一項資訊。在你追查歷史時，可以幫助你回復記憶或幫助別人迅速理解 changeset 的目的。

但人吃五穀雜糧長大，打字難免會錯。因此，就有修改 commit log 的需求產生。Subversion 安裝預設是無法修改 commit log 的。以下是開放此項功能的方法 ($REPOS 代表 repository 的目錄)：

cd $REPOS/hooks
mv pre-revprop-change.tmpl pre-revprop-change
chmod +x pre-revprop-change

若設定正確，就可以用以下指令來修改任一版本的 log：

svn pe -r 1234 --revprop svn:log $REPOS

或

svn ps -r 1234 --revprop svn:log "New commit log" $REPOS

若你恰好跟我一樣，也用 Trac 搭配 Subversion 時，正確的 log 更重要。因為 log 可用來搜尋 changeset。不過 Trac 上的 log 是你 commit 時，Trac 偷偷複製的。你改了 Subversion 的 log，Trac 並不知道，所以 Trac 上的 log 還是舊的。

解決方法是要求 Trac 重新校正 log：

# Trac 0.12 以前
trac-admin $PROJENV resync 1234
# Trac 0.12 及以後
trac-admin $PROJENV repository resync "" 1234

其中 $PROJENV 是 Trac 的 environment 位置；1234 是 revision number，若你改了很多 log，省略這個參數就可以全部一起校正。

每次手動校正 log 很麻煩，管理也不方便。所以可以將上述指令寫在另外一個 Subversion 的 hook script -- post-revprop-change：

REPOS="$1"
REV="$2"
USER="$3"
PROPNAME="$4"
ACTION="$5"
TRAC_ENV="..."

if [ "$ACTION" = "M" -a "$PROPNAME" = "svn:log" ]; then
PYTHON_EGG_CACHE=/tmp trac-admin $TRAC_ENV repository resync "" $2
# 若你的 Trac 比 0.12 版舊，請改用以下這一行
# PYTHON_EGG_CACHE=/tmp trac-admin $TRAC_ENV resync $2
exit 0;
fi

注意！上面的 TRAC_ENV 要設定到對應此 repository 的 Trac environment。