(ITS#4862) Doxygen support

[ando@sys-net.it]

Full_Name: Pierangelo Masarati
Version: HEAD (almost irrelevant)
OS: irrelevant
URL: ftp://ftp.openldap.org/incoming/openldap-doxygen.tar.gz
Submission from: (NULL) (81.72.89.40)
Submitted by: ando


I've updated a simple doxygen configuration file that allows to create a
(hopefully) complete and useful browsable tree of OpenLDAP software.  The
current configuration is quite redundant, since it includes sources in the tree,
and may take a while to process.  It needs "doxygen" and "dot" (the latter can
be disabled by setting HAVE_DOT to "no", if unavailable, at the expense of
loosing the graphical description of relations between data types and files).  

To "install":
- cd into the root of the source tree
- untar openldap-doxygen.tar.gz

this puts a couple .html files in doc/devel, and Doxyfile in the root of the
source tree.  Edit this to customize.

Finally, run doxygen from the root of the source tree (and be patient).

Documents will be installed in doc/source_html.  Edit Doxyfile to customize. 
Enjoy.

p.