源文件文档语法 [关闭]

【问题标题】：Source file documentation syntax [closed]源文件文档语法 [关闭]
【发布时间】：2012-05-13 15:37:38
【问题描述】：

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

感谢您的帮助。

附： - 人们在 C/C++/Objec-C 项目中使用 Javadoc 语法，还是没有那么多？

【问题讨论】：

【解决方案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 源。

【讨论】：