JDK-4890489 : -breakiterator should be the default (possibly only) option
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 5.0
  • Priority: P3
  • Status: Closed
  • Resolution: Won't Fix
  • OS: solaris_8
  • CPU: generic
  • Submitted: 2003-07-15
  • Updated: 2017-05-19
  • Resolved: 2003-12-04
Related Reports
Relates :  
Relates :  
Relates :  
the javadoc tool should use the breakiterator by default for finding the
first sentence.

This change has been promised for 1.5 in the most commonly appearing
diagnostic from javadoc since 1.4.0.


EVALUATION The proposal is: - Follow through with our promise of making BreakIterator the default. - Do not provide any option for using the ad-hoc algorithm. - Continue to allow the -breakiterator option, though it no longer has any effect. - Document RFE 4921374 (assuming it's approved) as the suggested fix where this change causes problems. - Fix all resulting problems in our own J2SE source base. We could have proposed a new -nobreakiterator option. But there has been no feedback suggesting that this is needed, even though we've been warning since Merlin that BreakIterator would become the rule. We could have proposed that we not follow through on making BreakIterator the default, and either drop or update the warning message. That could cause some confusion for people who have been anticipating this change for some time now, and would require us to continue supporting the poor ad-hoc for some time to come. ###@###.### 2003-09-15 Closing as "will not fix". The solution to this problem is being addressed in an alternate manner by the following related bugs: 4959985: Javadoc BreakIterator warning is no longer current. 4921374: Add tag to explicitly mark the end of the summary 4959973: please warn when I don't use @summary ###@###.### 2003-12-04