aspose file tools*
The moose likes Java in General and the fly likes use of -breakiterator when building javadocs in Java 1.4.1 Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login
JavaRanch » Java Forums » Java » Java in General
Bookmark "use of -breakiterator when building javadocs in Java 1.4.1" Watch "use of -breakiterator when building javadocs in Java 1.4.1" New topic
Author

use of -breakiterator when building javadocs in Java 1.4.1

dave sag
Ranch Hand

Joined: Feb 17, 2003
Posts: 47
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.
Cindy Glass
"The Hood"
Sheriff

Joined: Sep 29, 2000
Posts: 8521
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
dave sag
Ranch Hand

Joined: Feb 17, 2003
Posts: 47
so are you saying I should just ignore it and it will go away? yay.
Paul Bailey
Ranch Hand

Joined: Oct 20, 2000
Posts: 91
No, it is warning you of a future change. Notice that if you capatalize the first world after a period it won't bother you any more.
 
With a little knowledge, a cast iron skillet is non-stick and lasts a lifetime.
 
subject: use of -breakiterator when building javadocs in Java 1.4.1