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 - Javadoc
Summary: Javadoc
Status: NEW
Alias: None
Product: platform
Classification: Unclassified
Component: JDK Problems (show other bugs)
Version: 8.0.2
Hardware: PC Windows 7
: P3 normal (vote)
Assignee: Antonin Nebuzelsky
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-12-20 17:37 UTC by henri127
Modified: 2015-01-28 16:09 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
var/log/messages.log (1.00 MB, application/octet-stream)
2015-01-09 22:40 UTC, henri127
Details
source file (66.16 KB, application/octet-stream)
2015-01-09 22:42 UTC, henri127
Details

Note You need to log in before you can comment on or make changes to this bug.
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