jsdoc3/jsdoc — pull request #485 by mbd (2013-09-03 14:29:11+00:00)
Title: Plugin to automatically extract a summary, if missing, from the first se...

...ntence in the description

This plugin (tries to) extract a summary, if missing, from the first sentence in the description.

It does this by splitting at the first . that is followed by a whitespace or an HTML tag. Afterwards, it appends a ., balances any HTML tags and removes a begin-end pair of P tags.

The result is pretty useful, if the documenter has not "bothered" to write a summary and description tag.

I started a discussion about this a few months back:

https://groups.google.com/forum/?hl=en#!searchin/jsdoc-users/brief/jsdoc-users/00W9j4y_pj4/lOpHkXa3tQ0J

I am sorry to say, that I did not manage to create a change branch, or anything. Apologies. I hope that this pull can go into the source code anyway, as it is quite isolated from the rest of the code.

There are no tests - I can only say that it works for me.