summaries inside dojo.declare not being parsed by doctool

[dante]

eg: line 300~ dijit/Dialog.js

{{{ dojo.declare(

... { title: String Description of tooltip dialog (required for a11Y) title: "",

...

}}}

​http://redesign.dojotoolkit.org/?q=jsdoc/dijit/HEAD/object/dijit.Dialog/dijit.TooltipDialog

shows the summary and type of the "title" attribute to be null

(as does _browse.php for Dialog.js)

affects all inline docs about parameters inside of dojo.declare()'s, maybe others.

[Neil Roberts]

This is the proper behavior. A while back, it was decided that a comment block with a completely blank line discontinues the comment block. This allowed people to have both the comment block, and comments preceeding the code below it without conflict. Either add a "" to the blank line, or remove the blank line.

[dante]

regarding the above example, it is _supposed_ to be two separate comment blocks. one for the summary, one for the title. it currently has no known info about the title attribute. see ~line 300, dijit/Dialog.js

// summary:
// 	 I am text that is being understood

 {this newline separates the "header" from the "attributes" blocks}
// title: String
// 	 I am supposed to be the summary for the title attribute with typeof string
title: "fooBar"

[Neil Roberts]

(In [10767]) Refs #4635. Remove erroneous linebreak so that doc parsing works

[Neil Roberts]

dante: A new comment block is started when a line begins with a keyword, nothing more. A completely blank line discontinues all parsing.

[Neil Roberts]

(In [10772]) Refs #4635. Update formatting before checking in fix

[Neil Roberts]

(In [10773]) Refs #4635. Use trim instead of empty, and start block on false