源文件文档语法

Question

我正在寻找有关各种代码/API文档语法的资源，例如Javadocs。还有其他广泛使用的文档语法吗？我特别寻找那些与C，C++/Objective C/Cocoa，Shell脚本（如果有的话）和Java一起使用的，PHP/Ruby/Python等是第二优先级。

感谢您的任何帮助。

PS - 人们是否在C/C++/Objec-C项目中使用Javadoc语法，或者不那么多？

Answer 1

很多人

使用Doxygen来理解C++，C，Java，Objective-C，Python，Fortran，VHDL，PHP，C等。

Doxygen有自己的语法，但也可以与JavaDoc，MS-XML-Commenttags或Markdown-Syntax一起使用。OpenOffice使用f.ex。doxygen 因为它是带有 JavaDoc 语法的 API 文档，因为它可用于 Java 和 C 源代码。