创作手册页的最佳方式？

Question

创作手册页的最佳方法是什么？我应该使用标准的man宏编写,还是现在有一些聪明的包可以使用某种XML-ified源并且可以输出手册页,HTML,ASCII,什么不是？

谢谢

Answer 1

对于我的atinout程序，我一直在使用ronn，它可以让您以非常非常易读的类似 Markdown 的语法编写手册页。我对此非常满意。

atinout(1) -- Send AT commands to modem, capturing the response
===============================================================

## SYNOPSIS

`atinout` <input_file>|`-` <modem_device> <output_file>|`-`<br>
`atinout` `--version`<br>
`atinout` `--usage`<br>
`atinout` `--help`<br>

## DESCRIPTION

**Atinout** reads a list of AT commands. It sends those commands one by one
to the modem, waiting for the final result code for the
currently running command before continuing with the next command in
the list. The output from the commands is saved.
...

在这里查看整个页面。