<quote who="Pierangelo Masarati">
Gavin Henry wrote:
<quote who="Howard Chu"> > Pierangelo Masarati wrote: >> I'm trying to automatically document OpenLDAP code. Since I ha >> previous >> experience with doxygen and C++, which looks pretty reliable and >> versatile, I made some experiments, with less than encouraging >> results. >>
Hey, I already asked this in Dec ;-)
http://www.openldap.org/cgi-bin/wilma_hiliter/openldap-devel/200612/msg00005...
But obviously I didn't know much about the typedef stuff. Good work!
OK, I think I overlooked your message. Usually, doxygen is not something I use too much with code I'm used to. But I had precise requirements for browsable description of the sources, and just running plain doxygen on OpenLDAP produces nothing really usable (for example, it pretends ldap.h and slap.h are empty files...) minly because it gets confused by the LDAP_P() macro.
I'm still checking if the results are complete, but now I've got something working acceptably.
Excellent! I'd love to see some API docs on the main site etc.
Would save folks in #ldap (howard) getting bombarded all the time ;-)
Thanks.
p.
Ing. Pierangelo Masarati OpenLDAP Core Team
SysNet s.n.c. Via Dossi, 8 - 27100 Pavia - ITALIA http://www.sys-net.it
Office: +39.02.23998309 Mobile: +39.333.4963172 Email: pierangelo.masarati@sys-net.it