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 206728 - PHPDoc - missing @param name
Summary: PHPDoc - missing @param name
Status: RESOLVED FIXED
Alias: None
Product: php
Classification: Unclassified
Component: Editor (show other bugs)
Version: 7.0.1
Hardware: All All
: P3 normal (vote)
Assignee: Ondrej Brejla
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-12-27 09:51 UTC by Ondrej Brejla
Modified: 2012-01-03 15:44 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Ondrej Brejla 2011-12-27 09:51:39 UTC 
/**
 * Inserts row in a table.
 * @param mixed Param desc.
 */
public function insert($data) {}

Try CC. Table with params is not parsed correctly (third part doesn't start with dollar sign...). Param name could be taken from fnc/method signature...if it's possible...not sure right now...
Comment 1 Ondrej Brejla 2012-01-02 10:22:18 UTC 
It will not be easy to fix it. PHPDoc parser doesn't have its corresponding method node so I can't extract method parameters from method signature. Fix should be more complex. But now it's P4 for me.
Comment 2 Ondrej Brejla 2012-01-02 13:43:55 UTC 
The basic "usability" problem is, that no param description is shown, when param name is missing. It could be fixed easily, but no param name will be shown in CC window, which is not a problem I think - names are visible under caret.

So fixed in web-main: http://hg.netbeans.org/web-main/rev/cc3260bd98c4
Comment 3 Quality Engineering 2012-01-03 15:44:02 UTC 
Integrated into 'main-golden'
Changeset: http://hg.netbeans.org/main-golden/rev/cc3260bd98c4
User: Ondrej Brejla <obrejla@netbeans.org>
Log: #206728 - PHPDoc - missing @param name