[RFC][PATCH] Make manpages via DocBook XML

[Luca Barbato]

On 21/07/15 14:37, Jon TURNEY wrote:
> 
> As I wrote a while ago, I've been looking for a better way to generate
> the Cygwin package containing manpages for newlib.
> 
> Attached is a patch implementing a replacement for the makedoc tool,
> which generates DocBook XML rather than .texinfo, which can then be
> processed into manpages and other formats.

Docbook is quite annoying in many different ways.

- There is kramdown with quite good formatters (including manpages) and
md is really easy to use.
- There is sphinx that generates lovely documentation with minimal
effort, the default language is rst that has a steeper learning curve
and some people dislike, I work on the spare time in adding markdown
(commonmark/markua) support to it because of that.
- There is asciidoc that gets quite nice results even if the toolchain
is more non-linear.

I wouldn't move from the frying pan to the stone oven.

lu