macro_to_html + macro_to xml unix manpage

[Guido Draheim]

I have extracted some routines from the current AC-Archive
website engine (implemented in Python) to work standalone
on a single macro (or small number of macros if you like).

Given a macro ax_example.m4 you can now say
> ac_archive_macro_to_html ax_example.m4
which creates the output file ax_example.html
as it would be presented at ac-archive.sf.net

Additionally I have turned that into a CGI script at
http://ac-archive.sourceforge.net/doc/contribute.html
where you can test the macro submission format and
how it would like to be formatted at the AC-Archive.
Have fun with it,

* Unix Manpage Generation

A long while back I decided to render the AC-Archive
macros also as docbook xml files. Using "xmlto" one
can create unix manpages for each single autoconf
macro in the AC-Archive. A complete man7/* tarball
can be downloaded directly from the website at
http://ac-archive.sourceforge.net/doc/introduction.html

Using that locally, you would say
> ac_archive_macro_to_docbook ax_example.m4
# creates a file ax_example.docbook
> xmlto man ax_example.docbook
# creates a file ax_example.7
> man -l ax_example.7

* -tools.rpm

All these tools are now installed as a separate rpm
ac-archive-tools-2007.0205-0000.noarch.rpm
If you do download the source tarball from the
http://sourceforge.net/project/showfiles.php?group_id=32081
then you would say
> make install-tools

That does also install a tool to rebuild any other autoconf
repository named ac_archive_gendocs and a combined tool for
html/docbook that prints to stdout named just macro_to, i.e.
> ac_archive_macro_to xml ax_example.m4

Please test,
and have fun,
-- Guido