Converting POD-based man pages to mdoc

[Joerg Sonnenberger <joerg%britannica.bec.de@localhost>]

Hi all,
I've been working on writing a converter from POD format to mdoc.
The existing pod -> man toolchain is lacking, especially when looking at
the HTML output.

There are currently two sources of POD-converted man pages:
- OpenSSL man pages are written directly in POD
- GNU man pages are generally converted from texinfo sources

A big problem is the second category, e.g. the gcc(1) man page is full
of conversion errors that need to be cleaned up manually. Look e.g. for
@pxref and friends, they exist in various pages.

The automatic conversion is still somewhat ad-hoc, but the result should
be reasonable easy to maintain via three-way merge. As example, you can
find the gcc man page in mdoc format with minimal post-processing under
http://www.netbsd.org/~joerg/gcc.man.

What do you think, is that desirable for NetBSD?

Joerg