I've also been searching desperately for some documentation. It's not much, but I've run javadoc over the sources retrieved from the eclipse-cvs (releng/all). I've uploaded it onto
eclipse.org and linked to it: http://wiki.eclipse.org/CDT#Developer_Resources