Hi,

I noticed that there are several warnings in the javadoc building stage (at least on my Mac). Since these involve source that I haven't looked at, I feel a bit hesitant to fix these. So I won't unless somebody (Miguel/Egon) tells me to go ahead.

One set of warnings have to do with using ... in a comment, like
[javadoc] Standard Doclet version 1.4.2_05
[javadoc] Building tree for all the packages and classes...
[javadoc] Building index for all the packages and classes...
[javadoc] /Users/rkanters/Projects/Jmol10/src/org/jmol/viewer/datamodel/ Dots.java:751: warning - The first sentence is interpreted to be:
[javadoc] Generating /Users/rkanters/Projects/Jmol10/javadoc/index-all.html...
[javadoc] "I could not understand the algorithm that is described
[javadoc] in the Connolly article ..."
[javadoc] This sentence is different from what will be interpreted as the first sentence in the
[javadoc] next major release (when that interpretation will be internationalized), which is:
[javadoc] "I could not understand the algorithm that is described
[javadoc] in the Connolly article ... seemed too complicated ... :-(
[javadoc] All that it is trying to do is calculate the base point between
[javadoc] the two probes. "
[javadoc] To avoid this note, change the doc comment to make this a proper first sentence, then
[javadoc] use -breakiterator from that point forward, which will output this new sentence.


while the other ones are about unknown tags (@created) and @param arguments referring to a name that is not a parameter in the method.

Ren�



-------------------------------------------------------
This SF.net email is sponsored by: IT Product Guide on ITManagersJournal
Use IT products in your business? Tell us what you think of them. Give us
Your Opinions, Get Free ThinkGeek Gift Certificates! Click to find out more
http://productguide.itmanagersjournal.com/guidepromo.tmpl
_______________________________________________
Jmol-developers mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jmol-developers

Reply via email to