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 151064 - @link PHPDoc Option
Summary: @link PHPDoc Option
Status: CLOSED WORKSFORME
Alias: None
Product: php
Classification: Unclassified
Component: Editor (show other bugs)
Version: 6.x
Hardware: All All
: P3 blocker (vote)
Assignee: Tomasz Slota
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-10-22 19:29 UTC by compucoder
Modified: 2009-02-19 22:52 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description compucoder 2008-10-22 19:29:03 UTC
I found a problem with the @link phpdoc parameter.

The link it creates in the help popup will only be clickable if you have a certain number of lines.. I think. This is a
tough one to narrow down. if I put @link on the first line or even all alone in the phpdoc the link doesn't work. If I
have 3 line items in the PHPDoc block, the @link will only work if it is the second line; If I put it first or third it
doesn't work. It also has issues with placement. If I use @link with a phpdoc around a variable the online doc shows
right after the title line. If it is around a function the @link section shows at the bottom where it probably should as
it looks best. I think the @var variable may be part of the issue as well in relation to the formatting. @var's seem to
get placed at the bottom no matter what.

I hope I made some sense of this issue.

Btw, here is the code segment I used to test this with: (try taking stuff away around the @link to reproduce)

class User {

/**
 * mysqli Resource
 * @var mysqli $db
 * @link http://www.coresolutions.ca/index.php
 * @return void
 */
  public $db;
}

Thanks.
Comment 1 compucoder 2008-10-22 19:35:24 UTC
It looks like other phpdoc tags throw the @link placement of whack too. I tried @name, @author and @version and jst like
@var they get shown after the Online Documenation section. So you now have the Online Doc section severing the help output.

I am sure there are more @ tags that mess this up too.

Thanks.
Comment 2 Tomasz Slota 2008-11-25 10:31:18 UTC
It works for me in the current dev build, pls verify
Comment 3 compucoder 2008-11-25 14:20:41 UTC
I tested this and it now works properly.