vmware-archive / scripted

The Scripted code editor
Eclipse Public License 1.0
1.56k stars 166 forks source link

JSDoc hovers not properly showing array types #228

Open aeisenberg opened 11 years ago

aeisenberg commented 11 years ago

Consider the following function and comment:

/**
 * Extracts all doccomments that fall inside the given range
 * @param {Array.<range:Array.<Number>>} doccomments
 * @param {Array.<Number>} range
 * @return {{value:String,range:Array.<Number>}}
 */
function extractDocComments(doccomments, range) {

}

Inside of the array tags, the contents are missing. This is because we directly translate the lines into HTML. The browser considers what's inside the array tags to be HTML tags, not JSDoc tags.

It's not safe to directly turn text into HTML (potential cross-site scripting problems), so this needs to change anway.