Hi folks; I raised this to a blocker for 4.3.0 as generating accurate API docs seems pretty crucial to actually using the software. This was a problem in 4.2 as well, but unfortunately caught too late in the cycle.
https://issues.apache.org/jira/browse/CLOUDSTACK-4912 --David
