Ensure that there is margin before the first paragraph, since the
one-liner at the top of each class and method annotation is not usually
placed wihtin a <p/> tag.
Added <p/> tag after initial line.
fixed typo.
Remove the 'module:' prefix from jsdoc URLs, plus stop attempting to
create as short names as possible based on detecting ambiguity, since
this means that external links to documentation may break in the future
as new classes are introduced having the same name as an existing class
in some other package.
Started updating all classes to:

  * Use a @module annotation, since all classes are now exported as
modules
  * Use an @alias annotation if the module merely contains a single
class.
  * Use a @classdesc annotation to explicitly delimit a classes textual
description, since not doing so leads to inconsistencies depending on
whether a @module annotation is being used or not, and having to have
the class description text ahead of the annotations that describe the
class make it harder to read.
  * Refer to all other classes as <module>:<require-path>.
  * Place the constructor annotations at the very bottom, as close to
the method arguments as possible.

This work is being paused since I've noticed that some of the classes
I'm trying to update have since been deleted, so it would be worth
merging 'develop' before continuing.
Merge branch 'develop' into minor-jsdoc-improvements
Continue updating all the jsdoc for all classes to use modules --
parking again to fix the bug that currently prevents @classdesc from
being used within modules.
Added missing coverage around modules that contain a default CommonJs
class being exported within the module -- this has actually shown that
the doclets produced are probably correct, and that the bug is likely to
be within the template.
Updated templates to display the class description documentation for
classes defined within modules.
Switched from @description to @classdesc now that this works for classes
defined within modules as using @description meant that we were losing
the constructor documentation.
Changed config so that @link tags to classes, methods or properties
render as monospace text, so they look a bit more like code.
Finished updating the jsdoc for all classes to use modules.
Ensure the navigation links on the left-hand side can only be clicked by
hovering directly over the link text, and not by clicking on the
whitespace.
Fixed two classes that weren't previously wrapped as modules correctly.
@interface must appear after @class.
Removed @static from class as it has no effect.
Removed the @singleton annotation from all of formatters and parsers
within BladeRunnerJS, since they aren't -- only the caplin namespaced
versions of these classes are singleton instances since that's how the
renderer framework was designed to work.
Removed @singleton annotation from XmlParser since it's actually a
static class (a class having no prototypical methods) rather than a true
singleton instance.
Changed the last class within BRJS that had a @singleton annotation, and
that was a genuine singleton instance, to use a new pattern where one
module defines a class, while another module provides access to a
singleton instance.
Updated AliasRegistry to use the same singleton pattern employed by
ControlAdaptorFactory.