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.
(Message edited by: Marilyn de Queiroz to break up long lines)
[ March 08, 2003: Message edited by: Marilyn de Queiroz ]
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 ]