Document 'listens' tag

[hegemonic]

Just merged into master; available in JSDoc 3.2 and later.

[hegemonic]

Need to move part of an example from the @event tag as part of this issue.

[octatone]

Is anyone actively working on this? I am actively consuming this tag, I'd be glad to start documenting it if this isn't progressing.

[hegemonic]

There are a ton of very old, very small doc tasks laying around, including this one. I'm hoping to mop up all of these minor tasks within the next month or so.

I appreciate your offer to help, but in this case there's hardly anything to document. The tag syntax is @listens <eventName>. An example appears in the @event tag docs under "Documenting events in AMD modules."

[octatone]

Yeah, it's not listed in the index so it's really hard to stumble upon.

[hegemonic]

I know, I know...

[dotnetchris]

If i was to submit a PR for this, would i just copy any file, say tags-function.html and make relevant edits to replace "function" usages with "listens" usages? Or is there some more elaborate scheme to this?

[hegemonic]

You'll need to start with a Markdown file in content/en. Run gulp to generate updated HTML files.