BreakIterator determines a sentence break between a period and "/overview"
with no intervening white space. This does not seem like a valid sentence
boundary. Shouldn't a sentence boundary require white space? Is this a bug
in BreakIterator, or was it designed this way?

Running the javadoc.exe from SDK 1.4.0.02 with standard doclet 1.4.0, I
find that the comment

   /**
    * Obtain a new <A HREF="../../../../overview-summary.html#Addition
operators">addition operator</A>.
    * @return the operator
    */

yields the error message

warning - The first sentence is interpreted to be:
   "Obtain a new <A
   HREF="../../../../overview-summary.html#Addition">addition
   operator</A>."
   This sentence is different from what would be generated using
   -breakiterator:
   "Obtain a new <A HREF="../../../.."

Two objections:

(1) Your documentation states that the BreakIterator algorithm "Stops at a
   period, question mark or exclamation mark followed by a space if the
   next word starts with a capital letter." If so, the algorithm should
   not stop where the warning claims it would stop.

(2) If the warning is correctly describing the behavior of the
   BreakIterator algorithm (and it is the documentation that is
   misleading), that algorithm needs rethinking, as the example above
   shows. You should not break in the middle of a quoted attribute string
   in the middle of an HTML tag that is typically found embedded inside a
   sentence!!!!
###@###.### 11/2/04 18:35 GMT