为我自己的C库创建手册页

Question

在某些C源文件中，我看到了以下格式的评论：

/**
 *  @bla bla bla
 *  bla bla..
 */

有人告诉我，如果我正确评论我的.c / .h文件，那么使用某个工具我可以自动从这些文件自动生成手册页。

有人知道这是否可行？ （怎么做，我应该使用哪种软件等）

Answer 1

看起来您正在搜索doxygen

Answer 2

您看到的那些评论可能是doxygen标记。这可以产生人，HTML和各种其他格式。

Answer 3

尝试doxygen

http://www.doxygen.nl/index.html

您展示的语法是doxygen。 AFAIK，它可以生成手册页（以及HTML和LaTeX）。