[Pydev-code] Javadoc association

[Jeff L. <jml...@ya...>]

Hope this attachment makes it (mail list is rejecting
zip files).  Shows where javadocs are associated with
the rt.jar (in addition to src.jar association).

I'm guessing the src.jar assc. is used for 'go to
declaration' and the javadoc assc. is used for hover
text/F2. You may disagree, and you may be right.
 
Whether we need javadoc help for Python is, to me, a
matter of performance, code reuse, and minimizing the
work involved. I don't know how Eclipse JDT manages
the lookup from rt.jar class/method to javadoc/src
comment, but in my mind's eye they're probably getting
the method signature and converting it to an HTML
anchor in the javadocs (or, they could be going to the
source declaration via a cached parse tree and
grabbing the javadoc comment there, like you say).
Somebody knows for sure, and I'd like a little word
with that somebody. 

In any case, we still need a method for grabbing
docustrings out of project source, which amounts to
the same thing as what you suggest. Did you look at
Epydoc? Looks like a good tool and there's a complete
javadoc for the Python 2.3.3 libs.  Cool stuff. Can be
run from the command line, so should be a simple
matter of chaining off to the executable when the
project code is interpreted to generate the necessary
documentation.

Thanks for the build info. Heading out on vacation
next week; with luck I'll get some hotel room time to
setup a project.

Later,

Jeff



__________________________________________________
Do You Yahoo!?
Tired of spam?  Yahoo! Mail has the best spam protection around 
http://mail.yahoo.com