Parse literal functions & properties (including @lends)

[genehallman]

Implemented literal function and property parsing, including the @Lends tag.

Specifically useful for documenting literals, .extends and similar kinds of object construction techniques.

Tests included.

[tj]

what is @Lends ?

[genehallman]

From http://code.google.com/p/jsdoc-toolkit/wiki/TagLends:

The @Lends tag allows you to document all the members of an anonymous object literal as if they were members of an object with the given name.

var TemplateView = Backbone.View.extend(
/* @lends TemplateView.prototype */
{
  /*
   * Draws stuff
   */ 
  render: function() {
    ...
  }
});

/*
 * Does stuff
 */
TemplateView.prototype.anotherMethod = function() {
...
};

I found this to be a useful way of documenting anonymous literals, particularly with .extends() style constructors.

Feel free to merge or not, or critique, we here at @Livefyre just needed the functionality and we thought we'd share it.

[shannonmoeller]

👍

[jlnslv]

+1

[shellscape]

👍

[Twipped]

Closing this PR, since it has long since become un-mergable. @genehallman if this is still something you think dox needs, could you please create a new PR based on the current master?