用该项目的源代码创建一个文档

Question

我有一个包含很多源代码的项目。出于文档目的，我必须将所有源代码合并到一个文件中，例如PDF，HTML或DOCX。优选地，每个合并的文件内容应该具有与其相对来源的标题。不错的格式是需要的，但不是强制性的。

有没有人做过这个任务？有没有简单的代码片段来自动执行任务？奇怪的是，我四处搜寻，没有发现任何关于这个挑战的提示。

Answer 1

如果在某种UNIXish上，a2ps做了一个非常好的工作，打印大量的源到postscript，这很容易通过例如转换为PDF。 ps2pdf。喜欢的东西：

a2ps *.c -o foo.ps 
ps2pdf foo.ps foo.pdf 

这会甩了你在命令行上指定的所有源（你可以去用递归查找和xargs的或类似的一些组合）。如果您不需要全部源代码转储，那么您可能最好阅读您的语言本地源文档（如doxygen或javadoc或类似文档）。大多数源文件记录系统可以输出到一揽子格式ime。