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 241959 - [netbeans CAT_80]@ in JSDoc <code> section is not converted to &#64;
Summary: [netbeans CAT_80]@ in JSDoc <code> section is not converted to &#64;
Status: RESOLVED FIXED
Alias: None
Product: qa
Classification: Unclassified
Component: Synergy (show other bugs)
Version: 8.0
Hardware: PC Windows 7
: P4 normal (vote)
Assignee: Vladimir Riha
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-02-16 19:49 UTC by c69
Modified: 2014-02-16 21:15 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 c69 2014-02-16 19:49:19 UTC
This is more a bug of test desription, but still:

/**
 * Create a new Hexagon instance.
 * @extends Shape
 * @class Hexagon is a class that is a <i>logical</i> sublcass of
 * {@link Shape} (thanks to the <code>@extends</code> tag), but in
 * reality it is completely unrelated to Shape.
 * @param {int} sideLength The length of one side for the new Hexagon
 * @example
 * var h = new Hexagon(2);
 * @return {Hexagon} description
 */
function Hexagon(sideLength) {
 
}


This will NOT display correctly in CC, because of @extend being parsed as JSDoct tag.

To fix it you need to replace @ with &#64;, and this is done in the screenshot: http://services.netbeans.org/synergy/images/1380615026_Ts73_jseditor_doc.png

but not in the test description, and test descrition is not editable.

p.s.: but if the @ char can be automatically replaced with entity in JSDoc during formatting - that would be a nice enhancement.
Comment 1 Vladimir Riha 2014-02-16 21:15:27 UTC
I think this is a mistake in the test specification created when importing specifications from wiki to Synergy and browser interpreted it as @ (or sanitization on server). Either way, specification is fixed [1]. (btw it is editable in limited way - see the link, Edit button is enabled). 

As for the automatic replacement of @, if you think it would be useful, please file enhancement against javascript/documentation.

Thank you for reporting.


[1] http://services.netbeans.org/synergy/client/app/#/case/3673/suite/1334/v/1