API doc generator -- permit 'exceptions' as well as 'summary' and 'description'

[skinner]

I've been reading the Code Documentation wiki page:

​http://dojo.jot.com/Code%20Documentation

That page says that in the comment block for a function, the API doc generator will look for a 'summary' section and a 'description' section.

It'd be great if the doc generator also recognized something like 'throws' or 'exceptions' as a keyword in the example block. For example:

dojo.foo.squareRoot = function(/* int */ value) {
    // Summary: Returns the square root of a value
    // Throws: Throws a RangeError if value is negative
}

[bill]

Apparently you got confused between the two Neils.

[dante]

fix attached to #1473

parser is picking out examples: and exceptions: now, but generate.php dies when I try to run it (did before patch though, too), so that still needs to be addressed.

[dante]

(In [10650]) fixes #1474 - you can put exceptions: (comment) inline doc, and the tool picks it up fixes #1473 - allows examples: (comment) to be picked up by parser refs #4591 - lots of style cleanups to parser php files