mkDoxy is a program that attempts to document Makefiles in the same way that
Doxygen works on C[++] source. It also integrates rather tightly with Doxygen
itself.

To use mkDoxy, first run Doxygen as usual to generate your documentation.
Then, run mkdoxy, giving it the path to Doxygen's HTML output directory and
the Makefiles to process:

mkdoxy html/ Makefile Makefile.new

Now, open the Doxygen File List HTML page (files.html in the Doxygen HTML
output directory) in your web browser. You should see your Makefiles there,
and be able to view the commentary just like any of the source files in your
project.

Note that mkdoxy may spew some warnings, such as:

Use of uninitialized value in hash element at /usr/bin/mkdoxy line 148, <GEN0> line 46.

This does not mean that mkdoxy has failed. We are working on getting rid of
this.

For all questions, comments, and bug reports, email <mkdoxy@jmglov.net>.
