源代码文档中的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使用。其他一些系统具有相似的功能，但似乎更现代的系统没有。