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.
Documenting a property argument should allow for documenting of known property values that function may use. Consider the following: /** * @param {Object} opts * Object containing properties to create widget for. * @param {String} opts.keyField * Key field for property * @param {String} [opts.label] * Label to add to select widget * @param {(String|function|Array.<String>)} opts.dataSource * Source for option elements, may be: ... * ... */ function makeSelectWidget(opts) { } In the above the IDE hints about incorrect documentation for opts.keyField and opts.dataSource while these are correct documentation conventions as per [1] [1]: http://usejsdoc.org/tags-type.html
If I understand correctly, you expect that code completion after opts. should offer keyField, label and dataSource according the documentation. I'm correct? Thanks.
Created attachment 150840 [details] IDE reports "Incorrect Documentation" That would be brilliant, but what I'm primarilly reporting is that the IDE reports this as an error in the documentation when it is not.
Just thinking about your code completion comment that it could be handled better via a new feature request to add support for @typedef. I've created this request -> https://netbeans.org/bugzilla/show_bug.cgi?id=249068
Thanks for the clarification. Now it's clear.