Hi Bogdan,
Yes javadoc support would be really really cool. It is not completely straightforward as both MATLAB and Python (that I now work most with) are different languages and the way they access documentation is different from javadoc and I don't think any of the interface supports accessing the javadoc directly. In the normal orekit-jar file I don't think the javadoc is included so somehow one needs to parse the javadoc and make some support functions that accesses it.
I'm having some ideas how to do this in Python but have not had the time to work on it. But it is definitely something that is on the wish-list!
Regards
/Petrus