United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-4261388 javadoc first line cannot end with question mark?
JDK-4261388 : javadoc first line cannot end with question mark?

Details
Type:
Enhancement
Submit Date:
1999-08-10
Status:
Closed
Updated Date:
2002-06-27
Project Name:
JDK
Resolved Date:
2001-03-06
Component:
tools
OS:
generic
Sub-Component:
javadoc(tool)
CPU:
generic
Priority:
P4
Resolution:
Duplicate
Affected Versions:
1.2.2
Fixed Versions:

Related Reports
Duplicate:

Sub Tasks

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
EVALUATION

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

.
                                     
2004-06-10
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.
======================================================================
                                     
2004-06-11



Hardware and Software, Engineered to Work Together