Recently, the JavaDoc system transitioned to Sentence BreakIterator, a new method for detecting the first line of a JavaDoc. (Detecting the first line of JavaDoc is necessary so that this line can be replicated in the summary table).

The JavaDoc code generated by 'IDL-to-Java compiler (portable), version "3.1"' doesn't contain a period and therefore does not conform to the JavaDoc spec. The comments are similar to

/**
* org/omg/CosNaming/NamingContextExtPackage/InvalidAddress.java
* Generated by the IDL-to-Java compiler (portable), version "3.1"
* from ../../../../src/share/classes/org/omg/CosNaming/nameservice.idl
* Tuesday, August 7, 2001 10:17:49 PM GMT
*/

The lack of a period causes a warning message from the Sentence BreakIterator for each file. Therefore, now when doing a build of coredocs, over 2000 error messages are generated, many of them from the idl->Java files. This makes it quite cumbersome to notice other problems with JavaDoc. The comments in the idl generated Java files should include a period (perhaps after the file name) so that these warnings are no longer generated.

*****************************************************************************

###@###.### 2001-10-02

Fix verified OK.
 - With build - j2sdk-1_4_0-beta3-bin-b81-solsparc-27_sep_2001
 - Code inspection of idl generated java files.

*****************************************************************************