6

subversion 存储库包含 doxygen 从源代码生成的 html、latex 和 man 目录。即使对于小的源代码更改,也会生成具有随机名称的新文件,这会导致版本控制系统发生较大的变化。

有办法解决这个问题吗?如何在仍然包含 doxygen 生成的文档的同时最小化修订之间的变更集?或者,我怎样才能找到哪些 doxygen 生成的文件不再被使用并且应该被删除?

4

1 回答 1

6

我讨厌在不提供特定问题的答案的情况下回答问题,但是在存储库中跟踪 doxygen 文档通常是个坏主意。autoconf 生成的配置脚本也是如此。

如果您担心人们由于缺乏 doxygen 而无法生成文档,最好以您选择的语言和区域设置将它们托管在他们自己的私人仓库中。

您可以修改构建脚本来您执行此操作,而无需太多努力。在我从事免费/开源软件多年后的经验中,那些真正关心文档的人将能够生成它们。但你的里程可能会有所不同。

消除多余的合并冲突(即乔更改了评论文档,现在必须合并两者)恕我直言,将生成的文档外部化是合理的。

于 2009-11-09T16:23:31.343 回答