Best way to create pages for authors?

Question

What is the best way to create author pages? Should I write using standard man macros or is there some kind of smart package available now that takes some kind of XML-ified source and can output man pages, HTML, ASCII, and what not?

thanks

Answer 1

For my atinout, I used ronn , which allows you to write man pages in a very, very readable method, such as syntax. I am very pleased with this.

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. ... 

see the whole page here .

Answer 2

I previously used the GNU version of nroff, called groff, to write man pages.

A good article about him here:

http://www.linuxjournal.com/article/1158

Answer 3

Doxygen is what you are looking for. Keep in mind that it is intended to document source code, but you can easily adapt it.

It can also create html, pdf and latex documentation.

Answer 4

If you search once and create different output formats such as manpages, HTML, plain txt or even PDF, then the docbook should work best.

Answer 5

A tool commonly used in the Tcl community, doctools , which can create a limited (but useful) subset of the manpage format, is suitable for rendering with groff or nroff. It can also generate both plain text and HTML directly.