DCMTK

IMHO the best solution would be to add a new define DCMTK_RUNNING_UNDER_DOXYGEN and using that to modify all #ifdefs suitably. However, this still sounds ugly. :-(

This awk-magic should produce all #ifs which possible might need an "|| defined(DCMTK_RUNNING_UNDER_DOXYGEN)":

 awk '/^ *#.*ifn?def/ { file=FILENAME ; gsub(/.*\//, "", file) ; gsub(/\.h/, "", file) ; file=toupper(file) ; if (!match($2, file)) { print FILENAME " " $0 } } /^ *#.*defined/ { print FILENAME " " $0}' $(find */include/ -type f)  | sort -u

Btw, it would also be interesting to mark the platform-specific API in the documentation, i.e. add something like "Windows only" or "Unix only" ...

The API documentation should be generated such that all APIs are included in the documentation. For those methods, classes and functions that are only available under certain conditions (compiling on Windows, compiling with OpenSSL etc.), notes should be added in the documentation explaining under which conditions the method/class/function is available.

Test of Redmine mail subsystem, please ignore.