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 - Improve rendering of some common annotations
Summary: Improve rendering of some common annotations
Status: NEW
Alias: None
Product: php
Classification: Unclassified
Component: Editor (show other bugs)
Version: 7.4
Hardware: All All
: P3 normal (vote)
Assignee: Ondrej Brejla
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-08-24 17:31 UTC by Fleshgrinder
Modified: 2013-08-24 17:59 UTC (History)
0 users

See Also:
Issue Type: ENHANCEMENT
Exception Reporter:

Attachments
PHP to test the annotation rendering in the popover (788 bytes, application/octet-stream)
2013-08-24 17:31 UTC, Fleshgrinder 		Details
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 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!