Doxygen does not currently build

[Joel Sherrill]

The full build log is at:

http://www.rtems.org/onlinedocs/doxygen/doxy.log

/home/rtems/work/b-doc/sparc-rtems4.11/lib/include/rtems/bsd/sys/cdefs.h:180: Error: More #endif's than #if's found.

Below is fragments from the script that builds it for the website.

# Doxygen is run on the preinstalled include tree so the @file names match
# those from a caller's perspective.

$r/configure --target=sparc-rtems4.11 --enable-multilib \

--disable-networking >c.log 2>&1

make preinstall >b.log 2>&1
cd sparc-rtems4.11/cpukit

# Doxygen has an output directory in its config file and we just change it
# to somewhere we like.

mv Doxyfile Doxyfile.tmp
sed -e "s,^{OUTPUT_DIRECTORY.*=.*$,OUTPUT_DIRECTORY = ${dp}-tmp," <Doxyfile.tmp >Doxyfile}

# This just saves the log

doxygen >${d}/doxy.log 2>&1

[Ralf Corsepius]

No idea why you are generating the docs this arkward way.

mkdir BUILD
cd BUILD
../configure ....
make RTEMS_BSP= preinstall
cd <target>/cpukit
doxygen

works for me.

Nevertheless the generated docs are quite broken. I just applied a couple of fixes and hacks to get rid of the worst issues with them.