This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 249471

Summary: Javadoc
Product: platform Reporter: henri127 <henri127>
Component: JDK ProblemsAssignee: Antonin Nebuzelsky <anebuzelsky>
Status: NEW ---    
Severity: normal CC: ralphbenjamin
Priority: P3    
Version: 8.0.2   
Hardware: PC   
OS: Windows 7   
Issue Type: DEFECT Exception Reporter:
Attachments: var/log/messages.log
source file

Description henri127 2014-12-20 17:37:44 UTC
Product Version = NetBeans IDE 8.0.2 (Build 201411181905)
Operating System = Windows 7 version 6.1 running on amd64
Java; VM; Vendor = 1.8.0_20
Runtime = Java HotSpot(TM) 64-Bit Server VM 25.20-b23

When a function contains a parameter say x which is included in the Javadoc, it is not shown in the interactive popup when directly after the parameter a , is placed

p.e. following does not show @param x line for function functionWithComma, but does for functionWithOutComma, while no error warning is given that the Javadoc is wrongly formatted

public class test{
	public void test() {
		new JavaDocTest(). (after typing the dot a popup appears)
	}
}

public class JavaDocTest {
/**
*
* @param x, my integer
**/
public void functionWithComma(int x) {
    
}

whereas the following does,

/**
*
* @param x my integer
**/
public void functionWithOutComma(int x) {

}
}
Comment 1 henri127 2015-01-09 22:40:52 UTC
Created attachment 151433 [details]
var/log/messages.log

messages.log, file already replaced by a warning file, contains SEVERE error report
Comment 2 henri127 2015-01-09 22:42:07 UTC
Created attachment 151434 [details]
source file

from ffmpeg conversion to java
Comment 3 henri127 2015-01-09 22:44:06 UTC
sorry should have made a separate error for this has nothing to do with JavaDoc error
Comment 4 Ralph Ruijs 2015-01-28 16:09:20 UTC
Problem occurs because of an inconsistency in the JDK. The DocTree Api uses the method [1]Character.isJavaIdentifierPart(ch) to separate the name from the text, but the javadoc tools use [2]divideAtWhite(). This results in javadoc creating a parameter with the name "x," and DocLint not warning about the problem as it sees the parameter as "x".


[1] - com.sun.tools.javac.parser.DocCommentParser:1029
[2] - com.sun.tools.javadoc.ParamTagImpl:59