源代码文档中的 git 修订号

标签 git comments

我在几个项目中看到开发人员在源代码文档中包含类似 $Revision$ 的内容。我认为它们是某些工具的宏或环境变量,但我不知道如何使用它们。

我有兴趣将此功能添加到我的下一个项目中。我通常使用 TextMate、git 和 doxygen。有什么建议吗?

最佳答案

是:建议:不要这样做。
关键字扩展可以使用 gitattribute 过滤器完成,如“Git equivalent of subversion's $URL$ keyword expansion”中所示,但这会在数据中引入元数据,这通常会使 merge 比实际情况复杂得多。

您可以在关于“What are the basic clearcase concepts every developer should know?”的这个(冗长)回答中看到关于“嵌入式版本号 - 好还是坏?”的所有争论。
除非你有一个好的 merge 管理器来忽略这些特殊值,否则你会遇到“merge hell ”。
使用 Git,如“How does Git solve the merging problem?”中详述, merge 是非常基本的。没有花哨的 merge 管理器。

关于源代码文档中的 git 修订号,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/7016300/

相关文章:

git - 如何在推送时自动部署我的 git repo 的子模块?

git - 获取 git 用户名以链接到个人资料

git clone -c core.symlinks=true 不起作用

python-3.x - 如何注释Python中字符串中包含反斜杠的代码块?

Git 服务器 喜欢 GitHub 吗?

Git:如何在命令行上指定包含八进制符号的文件名

Java - 通过程序方式创建注释

javascript - 在帖子评论部分显示评论,无需重新加载页面

java - 什么才算足够的评论?

sdk - "This is an ' on-wire' 格式结构到底意味着什么?”