every time i build my javadocs now I have upgraded to java1.4 I get this message all over the place
where would I put this "-breakiterator"? I've found by trial and error that if i put the text '-breakiterator' into the first sentence of my comments or package docs then i don't get this warning, but i do get the '-breakiterator' appearing in my docs as text. obviously this is also wrong. i can't find any documentation on this. TIA dave (Message edited by: Marilyn de Queiroz to break up long lines) [ March 08, 2003: Message edited by: Marilyn de Queiroz ]
JSF / Jini / Javaspaces / JDO - all rock in my opinion.
This is just a warning that they are planning to change the way that the end of the first sentence is recognized to clean up some problems that they were having with running into abbreviations (using a period that is not the sentence ender) in the middle of a sentence and such. from What's New in Javadoc 1.4
Added -breakiterator for new way to determine end of first sentence. We plan to change the algorithm for determining the end of the first sentence in the next major feature release. The -breakiterator option gives you a preview of the new algorithm. In 1.2 and 1.3, the java.text.BreakIterator class was used to determine the end of sentence for all languages but English (4165985). English had its own algorithm, which looked for a period followed by a space. When -breakiterator is omitted, the end of the first sentence is unchanged from 1.2 and 1.3, but warnings are emitted displaying where there would be a difference. Using -breakiterator uses the new algorithm. Differences in the algorithms show up in English as follows: (4165985)
Old algorithm - Stops at a period followed by a space or a paragraph-level HTML tag, such as <P>. New algorithm - Stops at a period, question mark or exclamation mark followed by a space if the next word starts with a capital letter. This is meant to handle most abbreviations (such as "Serial no. is valid", but won't handle "Mr. Smith"). Won't stop at HTML tags or sentences that begin with numbers or symbols.
[ March 07, 2003: Message edited by: Cindy Glass ]
"JavaRanch, where the deer and the Certified play" - David O'Meara
Joined: Feb 17, 2003
so are you saying I should just ignore it and it will go away? yay.