Jsdoc improvements

A new 'jsdoc-improvement' pull-request which this time doesn't include the full commit history of 'jsdoc3' and which therefore supersedes #926.