Comment attachment fails after an inline block comment on a function parameter

[hegemonic]

When JSDoc parses the following code, it fails to attach the comments for module.myFunc and privateFunc:

define("MyModule", function(/** @exports MyModule */module) {

   /** My module function. */
   module.myFunc = function() {

   };

   /** My private function. */
   var privateFunc = function() {
   };
});

If you remove the inline block comment on the function parameter, everything works fine.

We should fix this before #473, which will mask the underlying problem.

[hegemonic]

Actually, I think fixing #473 will allow us to rip out all of the @lends hackery, along with the searchDescendants stuff in the comment-attachment code. I'll use this ticket to make those changes.

[hegemonic]

The @lends hackery is now gone. Still looking at searchDescendants.

[hegemonic]

It appears that this issue also causes us to lose the second comment in the following example, taken from #343 (note that the @lends tag is in the wrong place):

var MyClass = Class.define({
    /** @lends MyClass# */

    /**
     * Create an instance of MyClass.
     * @constructs
     */
    initialize: function() {}
});

[hegemonic]

This behavior has changed significantly, although the current behavior is even stranger.

I'll close this issue and file two new ones.