JDK-4261388 : javadoc first line cannot end with question mark?
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.2.2
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • OS: generic
  • CPU: generic
  • Submitted: 1999-08-10
  • Updated: 2002-06-27
  • Resolved: 2001-03-06
Related Reports
Duplicate :  
Description

Name: rlT66838			Date: 08/10/99


If my first line of my javadoc comment ends in a 
question mark instead of a period, the next line
gets included as part of the first line.  Not good.

Question marks are good for describing boolean attributes
or methods that return a boolean value.  

I know that the requirement is to find a line that ends 
in a period and then a space, but perhaps this can be
extended to include a quesion mark and a space also.

-----Test Case-----------------------------
public class JavadocDemo
{


    /**  First line.

         Second line.

    */
    public boolean correct()
    {

    }

    /**  First line?

         Second line.

    */
    public boolean notCorrect()
    {

    }

}
(Review ID: 93457) 
======================================================================

Comments
WORK AROUND Name: rlT66838 Date: 08/10/99 /** Is the stinkometer turned on? . <p> There is a trailing period that looks dumb and can be confusing to some people, but this does solve the problem. ======================================================================
11-06-2004

PUBLIC COMMENTS .
10-06-2004

EVALUATION We need to discuss on this. atul.dambalkar@eng 1999-08-19
19-08-1999