源代碼文檔中的git修訂號

Question

我曾在幾個項目中看到開發人員在源代碼文檔中包含類似$Revision$的內容。我認爲它們是某些工具的宏或環境變量，但我不知道如何使用它們。

我有興趣將此功能添加到我的下一個項目中。我通常使用TextMate，git和doxygen。有什麼建議麼？

Answer 1

是的：建議：不要這樣做。
關鍵字擴展可以使用gitattribute過濾器來完成，如「Git equivalent of subversion's $URL$ keyword expansion」中所示，但是這會在數據中引入元數據，這通常會使得它們實際上更復雜。

你可以在「What are the basic clearcase concepts every developer should know?」這個（冗長的）答案中看到關於「嵌入式版本號 - 好還是壞？」的所有爭論。
除非你有一個好的合併管理器來忽略這些特殊值，否則你會得到一個「合併地獄」。
對於Git，詳見「How does Git solve the merging problem?」，合併是非常基本的。沒有花哨的合併經理。

Answer 2

$Revision:$（'：'是必需的）由RCS和CVS使用。其他一些系統具有類似的功能，但似乎更現代的系統沒有。