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 234946

Summary: Improve rendering of some common annotations
Product: php Reporter: Fleshgrinder
Component: EditorAssignee: Ondrej Brejla <obrejla>
Status: NEW ---    
Severity: normal    
Priority: P3    
Version: 7.4   
Hardware: All   
OS: All   
Issue Type: ENHANCEMENT Exception Reporter:
Attachments: PHP to test the annotation rendering in the popover

Description Fleshgrinder 2013-08-24 17:31:32 UTC
Created attachment 139181 [details]
PHP to test the annotation rendering in the popover

The popover that shows the documentation is not showing some of the most common annotations correctly. The attached PHP file contains a very simple PHP file to test it.

Summary of not correctly rendered annotations:

- @global is missing everything
- @return is broken if the description starts on the next line
- @link and {@link} do not honor any link description text
- @see is not linked anywhere, even if linked to a PHP internal function or class

All of this is working just fine with ApiGen.
Comment 1 Ondrej Brejla 2013-08-24 17:36:43 UTC
Multiline annotation descriptions, @see and @link was never supported. It's and enhancement, I'll look at it for next version.
Comment 2 Fleshgrinder 2013-08-24 17:59:05 UTC
Filed it as DEFECT because it's working great with @param.

Many thanks for your effort!