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 :  

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) 

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. ======================================================================


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