Re: Documentation stuff

[Eric S. Raymond]

Pradeep Padala <address@hidden>:
> Hi Thomas,
>   As you know I have been hacking on to convert the html stuff to docbook.
> I converted the html files to docbook. I am also trying to convert the man
> pages. I found a project named polyglotman 
> (http://polyglotman.sourceforge.net)
> which does some work. The output sgml is not perfect and the author
> mentioned about it. I tried to correct it, but the code is horrible. I am
> in touch with the author and actually planning to write a simple utility
> that can do the conversion for our ncurses man pages first.
>   So, it will take some time before I can convert all the man pages. But I
> will do it.
>   If you want me to send the docbook converted files, I will send.

There's a better way.  Go look at <http://www.tuxedo.org/~esr/doclifter/>.
I wrote this after trying to make PolyglotMan work better and deciding
its design is inherently limited.
-- 
                <a href="http://www.tuxedo.org/~esr/";>Eric S. Raymond</a>