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 247825 - PHP code completion misinterprets multi-line description of @return tag
Summary: PHP code completion misinterprets multi-line description of @return tag
Status: NEW
Alias: None
Product: php
Classification: Unclassified
Component: Editor (show other bugs)
Version: 8.0.1
Hardware: PC Windows 8
: P3 normal (vote)
Assignee: Ondrej Brejla
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-10-09 09:29 UTC by rednael
Modified: 2016-08-29 06:06 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
IDE log (36.33 KB, text/plain)
2014-10-09 09:30 UTC, rednael
Details

Note You need to log in before you can comment on or make changes to this bug.
Description rednael 2014-10-09 09:29:57 UTC
Product Version = NetBeans IDE 8.0.1 (Build 201408251540)
Operating System = Windows 8 version 6.2 running on amd64
Java; VM; Vendor = 1.8.0_20
Runtime = Java HotSpot(TM) 64-Bit Server VM 25.20-b23

The PHP code-completion misinterprets the first word of the a multi-line description parameter of the @return tag.

In the following code:
[code]
/**
  * @return integer
  *    Indicates the number of items.
  */
 function count()
 {
     <...>
 }
[/code]

The type-hinting for count() shows:
  type: integer Indicates
  description: the number of items

Note that the first word of the description is in the "type" field instead of in the "description" field.

This bug only seems to arise for multi-line descriptions and not for single-line descriptions.
Thus, in the following code:
[code]
/**
  * @return integer Indicates the number of items.
  */
 function count()
 {
     <...>
 }
[/code]

The type-hinting for count() shows:
  type: integer
  description: Indicates the number of items

According to phpDocumentor (http://www.phpdoc.org/docs/latest/references/phpdoc/tags/return.html): "The @return tag MAY have a multi-line description and does not need explicit delimiting."

With regards,
Martijn
Comment 1 rednael 2014-10-09 09:30:01 UTC
Created attachment 149806 [details]
IDE log
Comment 2 Vladimir Riha 2014-10-21 06:28:18 UTC
reproducible

Product Version: NetBeans IDE Dev (Build 201410190001)
Updates: Updates available
Java: 1.8.0_20; Java HotSpot(TM) Client VM 25.20-b23
Runtime: Java(TM) SE Runtime Environment 1.8.0_20-b26
System: Linux version 3.13.0-35-generic running on i386; UTF-8; en_US (nb)