parse problem in doctool regarding function parameters

[dante]

in _base/fx.js this code exists:

   fire: function(/*Event*/ evt, /*Array?*/ args){
                // summary: Convenience function.  Fire event "evt" and pass it
                //                      the arguments specified in "args".
                // evt: The event to fire.
                // args: The arguments to pass to the event.
                if(this[evt]){
                        this[evt].apply(this, args||[]);
                }
                return this; // dojo._Animation
        },

the doc parser is picking up this [valid?] documenting syntax and striping the first word in leui of a param type:

eg, the above translates to:

function fire(/* The */evt, /* The */args); and the summaries for each param are missing the word "the"

adding:

evt: Event The event to fire

fixes, though is unreadable to humans, so marking as bug.

note this is unrelated to #4635 because [although] this is inside a dojo.declare (dojo._Animation), it is inside a specific method of the declared class.

[Neil Roberts]

(In [10765]) Fixes #4636. Don't just check for spaces, newlines are valid separators

[dante]

see _base/json.js

{{

function toJson(/*string*/foo){

foo: a string of something

} }}

comes up parameter foo typeof "a" with summary = "string of something"

reopening as per your request.

[Neil Roberts]

(In [10769]) Refs #4636. Update formatting before I check in changes

[Neil Roberts]

(In [10770]) Refs #4636. Only set the parameter type if it hasn't already been set AND it's different from the new type