eliminate markdown generation when unneeded (#1446)

* intermediate stage more or less works, good for performance test

* switch markdown back to normal

* intermediate state: functional, tests pass

* cleanup

* dartfmt

* Implement @devoncarew review comments

* regen docs w/1.24.0-dev.6.5 rather than bleeding edge
diff --git a/lib/src/html/html_generator_instance.dart b/lib/src/html/html_generator_instance.dart
index 7c12540..cbb1e8b 100644
--- a/lib/src/html/html_generator_instance.dart
+++ b/lib/src/html/html_generator_instance.dart
@@ -96,6 +96,7 @@
     generatePackage();
 
     for (var lib in package.libraries) {
+      //if (lib.name != 'flutter_test') continue;
       generateLibrary(package, lib);
 
       for (var clazz in lib.allClasses) {
diff --git a/lib/src/markdown_processor.dart b/lib/src/markdown_processor.dart
index 7addb0b..5636a62 100644
--- a/lib/src/markdown_processor.dart
+++ b/lib/src/markdown_processor.dart
@@ -6,6 +6,7 @@
 library dartdoc.markdown_processor;
 
 import 'dart:convert';
+import 'dart:io';
 import 'dart:math';
 
 import 'package:analyzer/dart/ast/ast.dart';
@@ -13,6 +14,7 @@
 import 'package:analyzer/src/dart/element/member.dart' show Member;
 import 'package:html/parser.dart' show parse;
 import 'package:markdown/markdown.dart' as md;
+import 'package:tuple/tuple.dart';
 
 import 'model.dart';
 
@@ -134,9 +136,6 @@
 // Covers anything with leading digits/symbols, empty string, weird punctuation, spaces.
 final RegExp notARealDocReference = new RegExp(r'''(^[^\w]|^[\d]|[,"'/]|^$)''');
 
-// We don't emit warnings currently: #572.
-const List<String> _oneLinerSkipTags = const ["code", "pre"];
-
 final List<md.InlineSyntax> _markdown_syntaxes = [
   new _InlineCodeSyntax(),
   new _AutolinkWithoutScheme()
@@ -152,6 +151,22 @@
   MatchingLinkResult(this.element, this.label, {this.warn: true});
 }
 
+class IterableBlockParser extends md.BlockParser {
+  IterableBlockParser(lines, document) : super(lines, document);
+
+  Iterable<md.Node> parseLinesGenerator() sync* {
+    while (!isDone) {
+      for (var syntax in blockSyntaxes) {
+        if (syntax.canParse(this)) {
+          md.Node block = syntax.parse(this);
+          if (block != null) yield (block);
+          break;
+        }
+      }
+    }
+  }
+}
+
 // Calculate a class hint for findCanonicalModelElementFor.
 ModelElement _getPreferredClass(ModelElement modelElement) {
   if (modelElement is EnclosedElement &&
@@ -667,23 +682,14 @@
   }
 }
 
-String _renderMarkdownToHtml(Documentable element) {
-  NodeList<CommentReference> commentRefs = _getCommentRefs(element);
-  md.Node _linkResolver(String name) {
-    return new md.Text(_linkDocReference(name, element, commentRefs));
-  }
-
-  String text = element.documentation;
-  _showWarningsForGenericsOutsideSquareBracketsBlocks(text, element);
-  return md.markdownToHtml(text,
-      inlineSyntaxes: _markdown_syntaxes, linkResolver: _linkResolver);
-}
-
 // Maximum number of characters to display before a suspected generic.
 const maxPriorContext = 20;
 // Maximum number of characters to display after the beginning of a suspected generic.
 const maxPostContext = 30;
 
+final RegExp allBeforeFirstNewline = new RegExp(r'^.*\n', multiLine: true);
+final RegExp allAfterLastNewline = new RegExp(r'\n.*$', multiLine: true);
+
 // Generics should be wrapped into `[]` blocks, to avoid handling them as HTML tags
 // (like, [Apple<int>]). @Hixie asked for a warning when there's something, that looks
 // like a non HTML tag (a generic?) outside of a `[]` block.
@@ -697,10 +703,8 @@
           "${text.substring(max(position - maxPriorContext, 0), position)}";
       String postContext =
           "${text.substring(position, min(position + maxPostContext, text.length))}";
-      priorContext =
-          priorContext.replaceAll(new RegExp(r'^.*\n', multiLine: true), '');
-      postContext =
-          postContext.replaceAll(new RegExp(r'\n.*$', multiLine: true), '');
+      priorContext = priorContext.replaceAll(allBeforeFirstNewline, '');
+      postContext = postContext.replaceAll(allAfterLastNewline, '');
       String errorMessage = "$priorContext$postContext";
       // TODO(jcollins-g):  allow for more specific error location inside comments
       element.warn(PackageWarning.typeAsHtml, message: errorMessage);
@@ -740,19 +744,24 @@
   return results;
 }
 
-class Documentation {
-  final String raw;
-  final String asHtml;
-  final String asOneLiner;
+class MarkdownDocument extends md.Document {
+  MarkdownDocument(
+      {Iterable<md.BlockSyntax> blockSyntaxes,
+      Iterable<md.InlineSyntax> inlineSyntaxes,
+      md.ExtensionSet extensionSet,
+      linkResolver,
+      imageLinkResolver})
+      : super(
+            blockSyntaxes: blockSyntaxes,
+            inlineSyntaxes: inlineSyntaxes,
+            extensionSet: extensionSet,
+            linkResolver: linkResolver,
+            imageLinkResolver: imageLinkResolver);
 
-  factory Documentation.forElement(Documentable element) {
-    String tempHtml = _renderMarkdownToHtml(element);
-    return new Documentation._internal(element.documentation, tempHtml);
-  }
-
-  Documentation._(this.raw, this.asHtml, this.asOneLiner);
-
-  factory Documentation._internal(String markdown, String rawHtml) {
+  /// Returns a tuple of longHtml, shortHtml.  longHtml is NULL if [processFullDocs] is true.
+  static Tuple2<String, String> _renderNodesToHtml(
+      List<md.Node> nodes, bool processFullDocs) {
+    var rawHtml = new md.HtmlRenderer().render(nodes);
     var asHtmlDocument = parse(rawHtml);
     for (var s in asHtmlDocument.querySelectorAll('script')) {
       s.remove();
@@ -775,16 +784,139 @@
       // Assume the user intended Dart if there are no other classes present.
       if (!specifiesLanguage) pre.classes.add('language-dart');
     }
+    String asHtml;
+    String asOneLiner;
 
-    // `trim` fixes issue with line ending differences between mac and windows.
-    var asHtml = asHtmlDocument.body.innerHtml?.trim();
-    var asOneLiner = asHtmlDocument.body.children.isEmpty
+    if (processFullDocs) {
+      // `trim` fixes issue with line ending differences between mac and windows.
+      asHtml = asHtmlDocument.body.innerHtml?.trim();
+    }
+    asOneLiner = asHtmlDocument.body.children.isEmpty
         ? ''
         : asHtmlDocument.body.children.first.innerHtml;
-    if (!asOneLiner.startsWith('<p>')) {
-      asOneLiner = '<p>$asOneLiner</p>';
+
+    return new Tuple2(asHtml, asOneLiner);
+  }
+
+  // From package:markdown/src/document.dart
+  // TODO(jcollins-g): consider making this a public method in markdown package
+  void _parseInlineContent(List<md.Node> nodes) {
+    for (int i = 0; i < nodes.length; i++) {
+      var node = nodes[i];
+      if (node is md.UnparsedContent) {
+        List<md.Node> inlineNodes =
+            new md.InlineParser(node.textContent, this).parse();
+        nodes.removeAt(i);
+        nodes.insertAll(i, inlineNodes);
+        i += inlineNodes.length - 1;
+      } else if (node is md.Element && node.children != null) {
+        _parseInlineContent(node.children);
+      }
     }
-    return new Documentation._(markdown, asHtml, asOneLiner);
+  }
+
+  /// Returns a tuple of longHtml, shortHtml (longHtml is NULL if !processFullDocs)
+  Tuple3<String, String, bool> renderLinesToHtml(
+      List<String> lines, bool processFullDocs) {
+    bool hasExtendedDocs = false;
+    md.Node firstNode;
+    List<md.Node> nodes = [];
+    for (md.Node node
+        in new IterableBlockParser(lines, this).parseLinesGenerator()) {
+      if (firstNode != null) {
+        hasExtendedDocs = true;
+        if (!processFullDocs) break;
+      }
+      firstNode ??= node;
+      nodes.add(node);
+    }
+    _parseInlineContent(nodes);
+
+    String shortHtml;
+    String longHtml;
+    if (processFullDocs) {
+      Tuple2 htmls = _renderNodesToHtml(nodes, processFullDocs);
+      longHtml = htmls.item1;
+      shortHtml = htmls.item2;
+    } else {
+      if (firstNode != null) {
+        Tuple2 htmls = _renderNodesToHtml([firstNode], processFullDocs);
+        shortHtml = htmls.item2;
+      } else {
+        shortHtml = '';
+      }
+    }
+    return new Tuple3<String, String, bool>(
+        longHtml, shortHtml, hasExtendedDocs);
+  }
+}
+
+class Documentation {
+  final Documentable _element;
+  Documentation.forElement(this._element) {}
+
+  bool _hasExtendedDocs;
+  bool get hasExtendedDocs {
+    if (_hasExtendedDocs == null) {
+      _renderHtmlForDartdoc(_element.isCanonical && _asHtml == null);
+    }
+    return _hasExtendedDocs;
+  }
+
+  String _asHtml;
+  String get asHtml {
+    if (_asHtml == null) {
+      assert(_asOneLiner == null || _element.isCanonical);
+      _renderHtmlForDartdoc(true);
+    }
+    return _asHtml;
+  }
+
+  String _asOneLiner;
+  String get asOneLiner {
+    if (_asOneLiner == null) {
+      assert(_asHtml == null);
+      _renderHtmlForDartdoc(_element.isCanonical);
+    }
+    return _asOneLiner;
+  }
+
+  NodeList<CommentReference> _commentRefs;
+  NodeList<CommentReference> get commentRefs {
+    if (_commentRefs == null) _commentRefs = _getCommentRefs(_element);
+    return _commentRefs;
+  }
+
+  String get raw => _element.documentation;
+
+  void _renderHtmlForDartdoc(bool processAllDocs) {
+    Tuple3<String, String, bool> renderResults =
+        _renderMarkdownToHtml(processAllDocs);
+    if (processAllDocs) {
+      _asHtml = renderResults.item1;
+    }
+    if (_asOneLiner == null) {
+      _asOneLiner = renderResults.item2;
+    }
+    if (_hasExtendedDocs != null) {
+      assert(_hasExtendedDocs == renderResults.item3);
+    }
+    _hasExtendedDocs = renderResults.item3;
+  }
+
+  /// Returns a tuple of longHtml, shortHtml, hasExtendedDocs
+  /// (longHtml is NULL if !processFullDocs)
+  Tuple3<String, String, bool> _renderMarkdownToHtml(bool processFullDocs) {
+    md.Node _linkResolver(String name) {
+      return new md.Text(_linkDocReference(name, _element, commentRefs));
+    }
+
+    String text = _element.documentation;
+    _showWarningsForGenericsOutsideSquareBracketsBlocks(text, _element);
+    MarkdownDocument document = new MarkdownDocument(
+        inlineSyntaxes: _markdown_syntaxes, linkResolver: _linkResolver);
+    List<String> lines = text.replaceAll('\r\n', '\n').split('\n');
+    return document.renderLinesToHtml(lines, processFullDocs);
   }
 }
 
diff --git a/lib/src/model.dart b/lib/src/model.dart
index 78e364a..69c3b12 100644
--- a/lib/src/model.dart
+++ b/lib/src/model.dart
@@ -179,6 +179,9 @@
   ModelElement get enclosingCombo => _enclosingCombo;
 
   @override
+  bool get isCanonical => enclosingCombo.isCanonical;
+
+  @override
   void warn(PackageWarning kind, {String message, Locatable referredFrom}) {
     if (enclosingCombo != null) {
       enclosingCombo.warn(kind, message: message, referredFrom: referredFrom);
@@ -903,6 +906,7 @@
   String get documentation;
   String get documentationAsHtml;
   bool get hasDocumentation;
+  bool get hasExtendedDocumentation;
   String get oneLineDoc;
   Documentable get overriddenDocumentedElement;
   Package get package;
@@ -2092,6 +2096,10 @@
   bool get hasDocumentation =>
       documentation != null && documentation.isNotEmpty;
 
+  @override
+  bool get hasExtendedDocumentation =>
+      href != null && _documentation.hasExtendedDocs;
+
   bool get hasParameters => parameters.isNotEmpty;
 
   /// If canonicalLibrary (or canonicalEnclosingElement, for Inheritable
@@ -2963,6 +2971,9 @@
   @override
   Documentable get documentationFrom => this;
 
+  @override
+  bool get hasExtendedDocumentation => documentation.isNotEmpty;
+
   final Map<Element, Library> _elementToLibrary = {};
   String _docsAsHtml;
   final Map<String, String> _macros = {};
diff --git a/pubspec.lock b/pubspec.lock
index 6247e91..e929856 100644
--- a/pubspec.lock
+++ b/pubspec.lock
@@ -138,7 +138,7 @@
       name: markdown
       url: "https://pub.dartlang.org"
     source: hosted
-    version: "0.11.2"
+    version: "0.11.3"
   matcher:
     description:
       name: matcher
diff --git a/test/model_test.dart b/test/model_test.dart
index bc7d91c..cd4d5cb 100644
--- a/test/model_test.dart
+++ b/test/model_test.dart
@@ -179,7 +179,7 @@
       expect(
           fakeLibrary.oneLineDoc,
           equals(
-              '<p>WOW FAKE PACKAGE IS <strong>BEST</strong> <a href="http://example.org">PACKAGE</a></p>'));
+              'WOW FAKE PACKAGE IS <strong>BEST</strong> <a href="http://example.org">PACKAGE</a>'));
     });
 
     test('has properties', () {
@@ -427,6 +427,14 @@
           contains("['hello from dart']"));
     });
 
+    test('class without additional docs', () {
+      expect(specialList.hasExtendedDocumentation, equals(false));
+    });
+
+    test('class with additional docs', () {
+      expect(Apple.hasExtendedDocumentation, equals(true));
+    });
+
     test('oneLine doc references in inherited methods should not have brackets',
         () {
       Method add =
@@ -434,7 +442,7 @@
       expect(
           add.oneLineDoc,
           equals(
-              '<p>Adds <code>value</code> to the end of this list,\nextending the length by one.</p>'));
+              'Adds <code>value</code> to the end of this list,\nextending the length by one.'));
     });
 
     test(
@@ -515,7 +523,7 @@
       expect(
           testingCodeSyntaxInOneLiners.oneLineDoc,
           equals(
-              '<p>These are code syntaxes: <code>true</code> and <code>false</code></p>'));
+              'These are code syntaxes: <code>true</code> and <code>false</code>'));
     });
 
     test('doc comments to parameters are marked as code', () {
diff --git a/testing/test_package_docs/anonymous_library/anonymous_library-library.html b/testing/test_package_docs/anonymous_library/anonymous_library-library.html
index f5d6707..7c13597 100644
--- a/testing/test_package_docs/anonymous_library/anonymous_library-library.html
+++ b/testing/test_package_docs/anonymous_library/anonymous_library-library.html
@@ -77,7 +77,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
       </dl>
diff --git a/testing/test_package_docs/another_anonymous_lib/another_anonymous_lib-library.html b/testing/test_package_docs/another_anonymous_lib/another_anonymous_lib-library.html
index 3ef5824..925d902 100644
--- a/testing/test_package_docs/another_anonymous_lib/another_anonymous_lib-library.html
+++ b/testing/test_package_docs/another_anonymous_lib/another_anonymous_lib-library.html
@@ -77,7 +77,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
       </dl>
diff --git a/testing/test_package_docs/css/css-library.html b/testing/test_package_docs/css/css-library.html
index 5dbfb03..e7a9136 100644
--- a/testing/test_package_docs/css/css-library.html
+++ b/testing/test_package_docs/css/css-library.html
@@ -80,7 +80,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/Animal-class.html b/testing/test_package_docs/ex/Animal-class.html
index b677335..771c936 100644
--- a/testing/test_package_docs/ex/Animal-class.html
+++ b/testing/test_package_docs/ex/Animal-class.html
@@ -182,7 +182,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -190,7 +190,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -205,7 +205,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -214,7 +214,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -229,7 +229,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/Apple-class.html b/testing/test_package_docs/ex/Apple-class.html
index e4c4a83..a3590e5 100644
--- a/testing/test_package_docs/ex/Apple-class.html
+++ b/testing/test_package_docs/ex/Apple-class.html
@@ -137,13 +137,13 @@
           <span class="name"><a href="ex/Apple/Apple.html">Apple</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p>Constructor</p>
+          Constructor
         </dd>
         <dt id="Apple.fromString" class="callable">
           <span class="name"><a href="ex/Apple/Apple.fromString.html">Apple.fromString</a></span><span class="signature">(<span class="parameter" id="fromString-param-s"><span class="type-annotation">String</span> <span class="parameter-name">s</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="constructor-modifier features">factory</div>
         </dd>
       </dl>
@@ -158,7 +158,7 @@
           <span class="signature">&#8594; <a href="ex/ParameterizedTypedef.html">ParameterizedTypedef</a>&lt;bool&gt;</span>
         </dt>
         <dd>
-          <p>fieldWithTypedef docs here</p>
+          fieldWithTypedef docs here
           <div class="features">final</div>
 </dd>
         <dt id="m" class="property">
@@ -167,7 +167,7 @@
           </span>
         </dt>
         <dd>
-          <p>The read-write field <code>m</code>.</p>
+          The read-write field <code>m</code>.
           <div class="features">read / write</div>
 </dd>
         <dt id="s" class="property">
@@ -176,7 +176,7 @@
           </span>
         </dt>
         <dd>
-          <p>The getter for <code>s</code></p>
+          The getter for <code>s</code>
           <div class="features">read / write</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -184,7 +184,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -192,7 +192,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -207,7 +207,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="m1" class="callable">
@@ -216,7 +216,7 @@
           </span>
         </dt>
         <dd>
-          <p>This is a method.</p>
+          This is a method.
           
 </dd>
         <dt id="methodWithTypedefParam" class="callable">
@@ -225,7 +225,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="paramFromExportLib" class="callable">
@@ -234,7 +234,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="printMsg" class="callable">
@@ -243,7 +243,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="whataclass" class="callable">
@@ -252,7 +252,7 @@
           </span>
         </dt>
         <dd>
-          <p>Apple docs for whataclass</p>
+          Apple docs for whataclass
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -261,7 +261,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -270,7 +270,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -285,7 +285,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="operator ==" class="callable inherited">
@@ -294,7 +294,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -310,7 +310,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
       </dl>
@@ -326,7 +326,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>5</code></span>
diff --git a/testing/test_package_docs/ex/B-class.html b/testing/test_package_docs/ex/B-class.html
index 39c2f8d..1213936 100644
--- a/testing/test_package_docs/ex/B-class.html
+++ b/testing/test_package_docs/ex/B-class.html
@@ -143,7 +143,7 @@
           <span class="name"><a href="ex/B/B.html">B</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -158,8 +158,8 @@
           </span>
         </dt>
         <dd>
-          <p>The default value is <code>false</code> (compression disabled).
-To enable, set <code>autoCompress</code> to <code>true</code>.</p>
+          The default value is <code>false</code> (compression disabled).
+To enable, set <code>autoCompress</code> to <code>true</code>.
           <div class="features">read / write</div>
 </dd>
         <dt id="isImplemented" class="property">
@@ -167,7 +167,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@override, read-only</div>
 </dd>
         <dt id="list" class="property">
@@ -176,7 +176,7 @@
           </span>
         </dt>
         <dd>
-          <p>A list of Strings</p>
+          A list of Strings
           <div class="features">read / write</div>
 </dd>
         <dt id="s" class="property">
@@ -184,7 +184,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@override, read-only</div>
 </dd>
         <dt id="fieldWithTypedef" class="property inherited">
@@ -192,7 +192,7 @@
           <span class="signature">&#8594; <a href="ex/ParameterizedTypedef.html">ParameterizedTypedef</a>&lt;bool&gt;</span>
         </dt>
         <dd class="inherited">
-          <p>fieldWithTypedef docs here</p>
+          fieldWithTypedef docs here
           <div class="features">final, inherited</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -200,7 +200,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="m" class="property inherited">
@@ -209,7 +209,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The read-write field <code>m</code>.</p>
+          The read-write field <code>m</code>.
           <div class="features">read / write, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -217,7 +217,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -232,7 +232,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="doNothing" class="callable">
@@ -241,7 +241,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="m1" class="callable">
@@ -250,7 +250,7 @@
           </span>
         </dt>
         <dd>
-          <p>This is a method.</p>
+          This is a method.
           
 </dd>
         <dt id="writeMsg" class="callable">
@@ -259,7 +259,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="isGreaterThan" class="callable inherited">
@@ -268,7 +268,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="methodWithTypedefParam" class="callable inherited">
@@ -277,7 +277,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -286,7 +286,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="paramFromExportLib" class="callable inherited">
@@ -295,7 +295,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="printMsg" class="callable inherited">
@@ -304,7 +304,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -313,7 +313,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
         <dt id="whataclass" class="callable inherited">
@@ -322,7 +322,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Apple docs for whataclass</p>
+          Apple docs for whataclass
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -337,7 +337,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="operator ==" class="callable inherited">
@@ -346,7 +346,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/Cat-class.html b/testing/test_package_docs/ex/Cat-class.html
index 204c7c3..573b686 100644
--- a/testing/test_package_docs/ex/Cat-class.html
+++ b/testing/test_package_docs/ex/Cat-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/Cat/Cat.html">Cat</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -148,7 +148,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read-only</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -164,7 +164,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -179,7 +179,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -188,7 +188,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -197,7 +197,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -212,7 +212,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/CatString-class.html b/testing/test_package_docs/ex/CatString-class.html
index d33504f..f0ceeb5 100644
--- a/testing/test_package_docs/ex/CatString-class.html
+++ b/testing/test_package_docs/ex/CatString-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/CatString/CatString.html">CatString</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -148,7 +148,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="isEmpty" class="property inherited">
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd class="inherited">
-          <p>Returns whether the buffer is empty. This is a constant-time operation.</p>
+          Returns whether the buffer is empty. This is a constant-time operation.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="isNotEmpty" class="property inherited">
@@ -164,8 +164,8 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd class="inherited">
-          <p>Returns whether the buffer is not empty. This is a constant-time
-operation.</p>
+          Returns whether the buffer is not empty. This is a constant-time
+operation.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="length" class="property inherited">
@@ -173,8 +173,8 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>Returns the length of the content that has been accumulated so far.
-This is a constant-time operation.</p>
+          Returns the length of the content that has been accumulated so far.
+This is a constant-time operation.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -182,7 +182,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -197,7 +197,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Clears the string buffer.</p>
+          Clears the string buffer.
           <div class="features">inherited</div>
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -206,7 +206,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -215,7 +215,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the contents of buffer as a concatenated string.</p>
+          Returns the contents of buffer as a concatenated string.
           <div class="features">inherited</div>
 </dd>
         <dt id="write" class="callable inherited">
@@ -224,7 +224,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Adds the contents of <code>obj</code>, converted to a string, to the buffer.</p>
+          Adds the contents of <code>obj</code>, converted to a string, to the buffer.
           <div class="features">inherited</div>
 </dd>
         <dt id="writeAll" class="callable inherited">
@@ -233,7 +233,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Iterates over the given <code>objects</code> and <a href="ex/CatString/write.html">write</a>s them in sequence.</p>
+          Iterates over the given <code>objects</code> and <a href="ex/CatString/write.html">write</a>s them in sequence.
           <div class="features">inherited</div>
 </dd>
         <dt id="writeCharCode" class="callable inherited">
@@ -242,7 +242,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Adds the string representation of <code>charCode</code> to the buffer.</p>
+          Adds the string representation of <code>charCode</code> to the buffer.
           <div class="features">inherited</div>
 </dd>
         <dt id="writeln" class="callable inherited">
@@ -251,8 +251,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Converts <code>obj</code> to a String by invoking <code>Object.toString</code> and 
-adds the result to <code>this</code>, followed by a newline.</p>
+          Converts <code>obj</code> to a String by invoking <code>Object.toString</code> and 
+adds the result to <code>this</code>, followed by a newline.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -267,7 +267,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/ConstantCat-class.html b/testing/test_package_docs/ex/ConstantCat-class.html
index c05e91f..655f968 100644
--- a/testing/test_package_docs/ex/ConstantCat-class.html
+++ b/testing/test_package_docs/ex/ConstantCat-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/ConstantCat/ConstantCat.html">ConstantCat</a></span><span class="signature">(<span class="parameter" id="-param-name"><span class="type-annotation">String</span> <span class="parameter-name">name</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="constructor-modifier features">const</div>
         </dd>
       </dl>
@@ -149,7 +149,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@override, read-only</div>
 </dd>
         <dt id="name" class="property">
@@ -157,7 +157,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -165,7 +165,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -173,7 +173,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -188,7 +188,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -197,7 +197,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -206,7 +206,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -221,7 +221,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/Deprecated-class.html b/testing/test_package_docs/ex/Deprecated-class.html
index b784508..4132707 100644
--- a/testing/test_package_docs/ex/Deprecated-class.html
+++ b/testing/test_package_docs/ex/Deprecated-class.html
@@ -147,8 +147,8 @@
           <span class="name"><a href="ex/Deprecated/Deprecated.html">Deprecated</a></span><span class="signature">(<span class="parameter" id="-param-expires"><span class="type-annotation">String</span> <span class="parameter-name">expires</span></span>)</span>
         </dt>
         <dd>
-          <p>Create a deprecation annotation which specifies the expiration of the
-annotated feature.</p>
+          Create a deprecation annotation which specifies the expiration of the
+annotated feature.
           <div class="constructor-modifier features">const</div>
         </dd>
       </dl>
@@ -163,7 +163,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p>A description of when the deprecated feature is expected to be retired.</p>
+          A description of when the deprecated feature is expected to be retired.
           <div class="features">final</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -171,7 +171,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -179,7 +179,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -194,7 +194,7 @@
           </span>
         </dt>
         <dd>
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -203,7 +203,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -218,7 +218,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/Dog-class.html b/testing/test_package_docs/ex/Dog-class.html
index 06a8259..cd4d909 100644
--- a/testing/test_package_docs/ex/Dog-class.html
+++ b/testing/test_package_docs/ex/Dog-class.html
@@ -150,13 +150,13 @@
           <span class="name"><a href="ex/Dog/Dog.html">Dog</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="Dog.deprecatedCreate" class="callable">
           <span class="name"><a class="deprecated" href="ex/Dog/Dog.deprecatedCreate.html">Dog.deprecatedCreate</a></span><span class="signature">(<span class="parameter" id="deprecatedCreate-param-name"><span class="type-annotation">String</span> <span class="parameter-name">name</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -170,7 +170,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="aGetterReturningRandomThings" class="property">
@@ -178,7 +178,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read-only</div>
 </dd>
         <dt id="aProtectedFinalField" class="property">
@@ -186,7 +186,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@protected, final</div>
 </dd>
         <dt id="deprecatedField" class="property">
@@ -195,7 +195,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@deprecated, read / write</div>
 </dd>
         <dt id="deprecatedGetter" class="property">
@@ -203,7 +203,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@deprecated, read-only</div>
 </dd>
         <dt id="deprecatedSetter" class="property">
@@ -212,7 +212,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@deprecated, write-only</div>
 </dd>
         <dt id="isImplemented" class="property">
@@ -220,7 +220,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@override, read-only</div>
 </dd>
         <dt id="name" class="property">
@@ -229,7 +229,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -237,7 +237,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -245,7 +245,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -260,7 +260,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="foo" class="callable">
@@ -269,7 +269,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="getAnotherClassD" class="callable">
@@ -278,7 +278,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@<a href="ex/Deprecated-class.html">Deprecated</a>(&#39;before v27.3&#39;)</div>
 </dd>
         <dt id="getClassA" class="callable">
@@ -287,7 +287,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="testGeneric" class="callable">
@@ -296,7 +296,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="testGenericMethod" class="callable">
@@ -305,7 +305,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="testMethod" class="callable">
@@ -314,7 +314,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="withMacro" class="callable">
@@ -323,7 +323,7 @@
           </span>
         </dt>
         <dd>
-          <p>Macro method</p>
+          Macro method
           
 </dd>
         <dt id="withMacro2" class="callable">
@@ -332,7 +332,7 @@
           </span>
         </dt>
         <dd>
-          <p>Foo macro content</p>
+          Foo macro content
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -341,7 +341,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -350,7 +350,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -365,7 +365,7 @@
           </span>
         </dt>
         <dd>
-          <p>The equality operator.</p>
+          The equality operator.
           
 </dd>
       </dl>
@@ -380,7 +380,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p>A tasty static + final property.</p>
+          A tasty static + final property.
           <div class="features">final</div>
 </dd>
         <dt id="staticGetterSetter" class="property">
@@ -389,7 +389,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
       </dl>
@@ -404,7 +404,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@<a href="ex/Deprecated-class.html">Deprecated</a>(&quot;Internal use&quot;)</div>
 </dd>
       </dl>
@@ -419,7 +419,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>"A Constant Dog"</code></span>
diff --git a/testing/test_package_docs/ex/E-class.html b/testing/test_package_docs/ex/E-class.html
index a20ac95..3190618 100644
--- a/testing/test_package_docs/ex/E-class.html
+++ b/testing/test_package_docs/ex/E-class.html
@@ -132,7 +132,7 @@
           <span class="name"><a href="ex/E/E.html">E</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -146,7 +146,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -154,7 +154,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -169,7 +169,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -178,7 +178,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -193,7 +193,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/F-class.html b/testing/test_package_docs/ex/F-class.html
index cdab7fe..cc2f50d 100644
--- a/testing/test_package_docs/ex/F-class.html
+++ b/testing/test_package_docs/ex/F-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/F/F.html">F</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -148,7 +148,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">final, inherited</div>
 </dd>
         <dt id="aGetterReturningRandomThings" class="property inherited">
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="aProtectedFinalField" class="property inherited">
@@ -164,7 +164,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">@protected, final, inherited</div>
 </dd>
         <dt id="deprecatedField" class="property inherited">
@@ -173,7 +173,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">@deprecated, read / write, inherited</div>
 </dd>
         <dt id="deprecatedGetter" class="property inherited">
@@ -181,7 +181,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">@deprecated, read-only, inherited</div>
 </dd>
         <dt id="deprecatedSetter" class="property inherited">
@@ -190,7 +190,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">@deprecated, write-only, inherited</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -198,7 +198,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="isImplemented" class="property inherited">
@@ -206,7 +206,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">@override, read-only, inherited</div>
 </dd>
         <dt id="name" class="property inherited">
@@ -215,7 +215,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read / write, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -223,7 +223,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -238,7 +238,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="abstractMethod" class="callable inherited">
@@ -247,7 +247,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="foo" class="callable inherited">
@@ -256,7 +256,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="getAnotherClassD" class="callable inherited">
@@ -265,7 +265,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">@<a href="ex/Deprecated-class.html">Deprecated</a>(&#39;before v27.3&#39;), inherited</div>
 </dd>
         <dt id="getClassA" class="callable inherited">
@@ -274,7 +274,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -283,7 +283,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="test" class="callable inherited">
@@ -292,7 +292,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="testGeneric" class="callable inherited">
@@ -301,7 +301,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="testGenericMethod" class="callable inherited">
@@ -310,7 +310,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="testMethod" class="callable inherited">
@@ -319,7 +319,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -328,7 +328,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
         <dt id="withMacro" class="callable inherited">
@@ -337,7 +337,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Macro method</p>
+          Macro method
           <div class="features">inherited</div>
 </dd>
         <dt id="withMacro2" class="callable inherited">
@@ -346,7 +346,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Foo macro content</p>
+          Foo macro content
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -361,7 +361,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/ForAnnotation-class.html b/testing/test_package_docs/ex/ForAnnotation-class.html
index 2c4c76d..523cec5 100644
--- a/testing/test_package_docs/ex/ForAnnotation-class.html
+++ b/testing/test_package_docs/ex/ForAnnotation-class.html
@@ -120,7 +120,7 @@
           <span class="name"><a href="ex/ForAnnotation/ForAnnotation.html">ForAnnotation</a></span><span class="signature">(<span class="parameter" id="-param-value"><span class="type-annotation">String</span> <span class="parameter-name">value</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="constructor-modifier features">const</div>
         </dd>
       </dl>
@@ -135,7 +135,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -143,7 +143,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -151,7 +151,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -166,7 +166,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -175,7 +175,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -190,7 +190,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/HasAnnotation-class.html b/testing/test_package_docs/ex/HasAnnotation-class.html
index bdabc01..ce8fde9 100644
--- a/testing/test_package_docs/ex/HasAnnotation-class.html
+++ b/testing/test_package_docs/ex/HasAnnotation-class.html
@@ -132,7 +132,7 @@
           <span class="name"><a href="ex/HasAnnotation/HasAnnotation.html">HasAnnotation</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -146,7 +146,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -154,7 +154,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -169,7 +169,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -178,7 +178,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -193,7 +193,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/Helper-class.html b/testing/test_package_docs/ex/Helper-class.html
index 18db7ee..0fbc22a 100644
--- a/testing/test_package_docs/ex/Helper-class.html
+++ b/testing/test_package_docs/ex/Helper-class.html
@@ -125,7 +125,7 @@
           <span class="name"><a href="ex/Helper/Helper.html">Helper</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -139,7 +139,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -147,7 +147,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -162,7 +162,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -171,7 +171,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -180,7 +180,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -195,7 +195,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/Klass-class.html b/testing/test_package_docs/ex/Klass-class.html
index 0a34d77..05b7106 100644
--- a/testing/test_package_docs/ex/Klass-class.html
+++ b/testing/test_package_docs/ex/Klass-class.html
@@ -123,7 +123,7 @@
           <span class="name"><a href="ex/Klass/Klass.html">Klass</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -137,7 +137,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -145,7 +145,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -160,7 +160,7 @@
           </span>
         </dt>
         <dd>
-          <p>Another method</p>
+          Another method
           
 </dd>
         <dt id="anotherMethod" class="callable">
@@ -169,7 +169,7 @@
           </span>
         </dt>
         <dd>
-          <p>A method with a custom annotation</p>
+          A method with a custom annotation
           <div class="features">@<a href="ex/aThingToDo-class.html">aThingToDo</a>(&#39;from&#39;, &#39;thing&#39;)</div>
 </dd>
         <dt id="imAFactoryNoReally" class="callable">
@@ -178,7 +178,7 @@
           </span>
         </dt>
         <dd>
-          <p>Not really a factory, but...</p>
+          Not really a factory, but...
           <div class="features">@factory</div>
 </dd>
         <dt id="imProtected" class="callable">
@@ -187,7 +187,7 @@
           </span>
         </dt>
         <dd>
-          <p>A protected method</p>
+          A protected method
           <div class="features">@protected</div>
 </dd>
         <dt id="method" class="callable">
@@ -196,7 +196,7 @@
           </span>
         </dt>
         <dd>
-          <p>A method</p>
+          A method
           
 </dd>
         <dt id="toString" class="callable">
@@ -205,7 +205,7 @@
           </span>
         </dt>
         <dd>
-          <p>A shadowed method</p>
+          A shadowed method
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -214,7 +214,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -229,7 +229,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/MyError-class.html b/testing/test_package_docs/ex/MyError-class.html
index 47bf34a..ce1a92e 100644
--- a/testing/test_package_docs/ex/MyError-class.html
+++ b/testing/test_package_docs/ex/MyError-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/MyError/MyError.html">MyError</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -148,7 +148,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="stackTrace" class="property inherited">
@@ -164,7 +164,7 @@
           <span class="signature">&#8594; StackTrace</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -179,7 +179,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -188,7 +188,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -203,7 +203,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/MyErrorImplements-class.html b/testing/test_package_docs/ex/MyErrorImplements-class.html
index beec65b..066fc84 100644
--- a/testing/test_package_docs/ex/MyErrorImplements-class.html
+++ b/testing/test_package_docs/ex/MyErrorImplements-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/MyErrorImplements/MyErrorImplements.html">MyErrorImplements</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -148,7 +148,7 @@
           <span class="signature">&#8594; StackTrace</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@override, read-only</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -164,7 +164,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -179,7 +179,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -188,7 +188,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -203,7 +203,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/MyException-class.html b/testing/test_package_docs/ex/MyException-class.html
index e0e28f2..d49c5f0 100644
--- a/testing/test_package_docs/ex/MyException-class.html
+++ b/testing/test_package_docs/ex/MyException-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/MyException/MyException.html">MyException</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -148,7 +148,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -171,7 +171,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -180,7 +180,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -195,7 +195,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/MyExceptionImplements-class.html b/testing/test_package_docs/ex/MyExceptionImplements-class.html
index 2875fd4..bd3d1ed 100644
--- a/testing/test_package_docs/ex/MyExceptionImplements-class.html
+++ b/testing/test_package_docs/ex/MyExceptionImplements-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/MyExceptionImplements/MyExceptionImplements.html">MyExceptionImplements</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -148,7 +148,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -171,7 +171,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -180,7 +180,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -195,7 +195,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/PublicClassExtendsPrivateClass-class.html b/testing/test_package_docs/ex/PublicClassExtendsPrivateClass-class.html
index 3a5c679..7c556de 100644
--- a/testing/test_package_docs/ex/PublicClassExtendsPrivateClass-class.html
+++ b/testing/test_package_docs/ex/PublicClassExtendsPrivateClass-class.html
@@ -133,7 +133,7 @@
           <span class="name"><a href="ex/PublicClassExtendsPrivateClass/PublicClassExtendsPrivateClass.html">PublicClassExtendsPrivateClass</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -147,7 +147,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -155,7 +155,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -170,7 +170,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="test" class="callable inherited">
@@ -179,7 +179,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -188,7 +188,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -203,7 +203,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/PublicClassImplementsPrivateInterface-class.html b/testing/test_package_docs/ex/PublicClassImplementsPrivateInterface-class.html
index fb81047..9d6a30e 100644
--- a/testing/test_package_docs/ex/PublicClassImplementsPrivateInterface-class.html
+++ b/testing/test_package_docs/ex/PublicClassImplementsPrivateInterface-class.html
@@ -120,7 +120,7 @@
           <span class="name"><a href="ex/PublicClassImplementsPrivateInterface/PublicClassImplementsPrivateInterface.html">PublicClassImplementsPrivateInterface</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -134,7 +134,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -142,7 +142,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -157,7 +157,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -166,7 +166,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -175,7 +175,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -190,7 +190,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/ShapeType-class.html b/testing/test_package_docs/ex/ShapeType-class.html
index 761a09d..1cce18d 100644
--- a/testing/test_package_docs/ex/ShapeType-class.html
+++ b/testing/test_package_docs/ex/ShapeType-class.html
@@ -141,7 +141,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="name" class="property inherited">
@@ -149,7 +149,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">final, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -157,7 +157,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -172,7 +172,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -181,7 +181,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -196,7 +196,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -213,7 +213,7 @@
           <span class="signature">&#8594; <a href="ex/ShapeType-class.html">ShapeType</a></span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>const <a href="ex/ShapeType-class.html">ShapeType</a>._internal("Ellipse")</code></span>
@@ -224,7 +224,7 @@
           <span class="signature">&#8594; <a href="ex/ShapeType-class.html">ShapeType</a></span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>const <a href="ex/ShapeType-class.html">ShapeType</a>._internal("Rect")</code></span>
diff --git a/testing/test_package_docs/ex/SpecializedDuration-class.html b/testing/test_package_docs/ex/SpecializedDuration-class.html
index 8f85caa..fc5db81 100644
--- a/testing/test_package_docs/ex/SpecializedDuration-class.html
+++ b/testing/test_package_docs/ex/SpecializedDuration-class.html
@@ -138,7 +138,7 @@
           <span class="name"><a href="ex/SpecializedDuration/SpecializedDuration.html">SpecializedDuration</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -152,7 +152,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="inDays" class="property inherited">
@@ -160,7 +160,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>Returns the number of whole days spanned by this Duration.</p>
+          Returns the number of whole days spanned by this Duration.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="inHours" class="property inherited">
@@ -168,7 +168,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>Returns the number of whole hours spanned by this Duration.</p>
+          Returns the number of whole hours spanned by this Duration.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="inMicroseconds" class="property inherited">
@@ -176,7 +176,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>Returns number of whole microseconds spanned by this Duration.</p>
+          Returns number of whole microseconds spanned by this Duration.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="inMilliseconds" class="property inherited">
@@ -184,7 +184,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>Returns number of whole milliseconds spanned by this Duration.</p>
+          Returns number of whole milliseconds spanned by this Duration.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="inMinutes" class="property inherited">
@@ -192,7 +192,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>Returns the number of whole minutes spanned by this Duration.</p>
+          Returns the number of whole minutes spanned by this Duration.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="inSeconds" class="property inherited">
@@ -200,7 +200,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>Returns the number of whole seconds spanned by this Duration.</p>
+          Returns the number of whole seconds spanned by this Duration.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="isNegative" class="property inherited">
@@ -208,7 +208,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd class="inherited">
-          <p>Returns whether this <code>Duration</code> is negative.</p>
+          Returns whether this <code>Duration</code> is negative.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -216,7 +216,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -231,8 +231,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a new <code>Duration</code> representing the absolute value of this
-<code>Duration</code>.</p>
+          Returns a new <code>Duration</code> representing the absolute value of this
+<code>Duration</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="compareTo" class="callable inherited">
@@ -241,7 +241,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Compares this Duration to <code>other</code>, returning zero if the values are equal.</p>
+          Compares this Duration to <code>other</code>, returning zero if the values are equal.
           <div class="features">inherited</div>
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -250,7 +250,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -259,7 +259,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this <code>Duration</code>.</p>
+          Returns a string representation of this <code>Duration</code>.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -274,8 +274,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Multiplies this Duration by the given <code>factor</code> and returns the result
-as a new Duration object.</p>
+          Multiplies this Duration by the given <code>factor</code> and returns the result
+as a new Duration object.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator +" class="callable inherited">
@@ -284,8 +284,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Adds this Duration and <code>other</code> and
-returns the sum as a new Duration object.</p>
+          Adds this Duration and <code>other</code> and
+returns the sum as a new Duration object.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator -" class="callable inherited">
@@ -294,8 +294,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Subtracts <code>other</code> from this Duration and
-returns the difference as a new Duration object.</p>
+          Subtracts <code>other</code> from this Duration and
+returns the difference as a new Duration object.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator &lt;" class="callable inherited">
@@ -304,8 +304,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns <code>true</code> if the value of this Duration
-is less than the value of <code>other</code>.</p>
+          Returns <code>true</code> if the value of this Duration
+is less than the value of <code>other</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator &lt;=" class="callable inherited">
@@ -314,8 +314,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns <code>true</code> if the value of this Duration
-is less than or equal to the value of <code>other</code>.</p>
+          Returns <code>true</code> if the value of this Duration
+is less than or equal to the value of <code>other</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator ==" class="callable inherited">
@@ -324,7 +324,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns <code>true</code> if this Duration is the same object as <code>other</code>.</p>
+          Returns <code>true</code> if this Duration is the same object as <code>other</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator &gt;" class="callable inherited">
@@ -333,8 +333,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns <code>true</code> if the value of this Duration
-is greater than the value of <code>other</code>.</p>
+          Returns <code>true</code> if the value of this Duration
+is greater than the value of <code>other</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator &gt;=" class="callable inherited">
@@ -343,8 +343,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns <code>true</code> if the value of this Duration
-is greater than or equal to the value of <code>other</code>.</p>
+          Returns <code>true</code> if the value of this Duration
+is greater than or equal to the value of <code>other</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator unary-" class="callable inherited">
@@ -353,7 +353,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a new <code>Duration</code> representing this <code>Duration</code> negated.</p>
+          Returns a new <code>Duration</code> representing this <code>Duration</code> negated.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator ~/" class="callable inherited">
@@ -362,8 +362,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Divides this Duration by the given <code>quotient</code> and returns the truncated
-result as a new Duration object.</p>
+          Divides this Duration by the given <code>quotient</code> and returns the truncated
+result as a new Duration object.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/WithGeneric-class.html b/testing/test_package_docs/ex/WithGeneric-class.html
index 4658134..d766c1b 100644
--- a/testing/test_package_docs/ex/WithGeneric-class.html
+++ b/testing/test_package_docs/ex/WithGeneric-class.html
@@ -132,7 +132,7 @@
           <span class="name"><a href="ex/WithGeneric/WithGeneric.html">WithGeneric</a></span><span class="signature">(<span class="parameter" id="-param-prop"><span class="type-annotation">T</span> <span class="parameter-name">prop</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -147,7 +147,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -155,7 +155,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -163,7 +163,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -178,7 +178,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -187,7 +187,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -202,7 +202,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/WithGenericSub-class.html b/testing/test_package_docs/ex/WithGenericSub-class.html
index cdfb5d9..4a79c2a 100644
--- a/testing/test_package_docs/ex/WithGenericSub-class.html
+++ b/testing/test_package_docs/ex/WithGenericSub-class.html
@@ -134,7 +134,7 @@
           <span class="name"><a href="ex/WithGenericSub/WithGenericSub.html">WithGenericSub</a></span><span class="signature">(<span class="parameter" id="-param-prop"><span class="type-annotation"><a href="ex/Apple-class.html">Apple</a></span> <span class="parameter-name">prop</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -148,7 +148,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="prop" class="property inherited">
@@ -157,7 +157,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read / write, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -165,7 +165,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -180,7 +180,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -189,7 +189,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -204,7 +204,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/aThingToDo-class.html b/testing/test_package_docs/ex/aThingToDo-class.html
index aabeb36..adc12f5 100644
--- a/testing/test_package_docs/ex/aThingToDo-class.html
+++ b/testing/test_package_docs/ex/aThingToDo-class.html
@@ -123,7 +123,7 @@
           <span class="name"><a href="ex/aThingToDo/aThingToDo.html">aThingToDo</a></span><span class="signature">(<span class="parameter" id="-param-who"><span class="type-annotation">String</span> <span class="parameter-name">who</span>, </span> <span class="parameter" id="-param-what"><span class="type-annotation">String</span> <span class="parameter-name">what</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="constructor-modifier features">const</div>
         </dd>
       </dl>
@@ -138,7 +138,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="who" class="property">
@@ -146,7 +146,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -154,7 +154,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -162,7 +162,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -177,7 +177,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -186,7 +186,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -201,7 +201,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/ex/ex-library.html b/testing/test_package_docs/ex/ex-library.html
index a70bc71..677c2d1 100644
--- a/testing/test_package_docs/ex/ex-library.html
+++ b/testing/test_package_docs/ex/ex-library.html
@@ -75,130 +75,130 @@
           <span class="name "><a href="ex/Apple-class.html">Apple</a></span>
         </dt>
         <dd>
-          <p>Sample class <code>String</code></p>
+          Sample class <code>String</code>
         </dd>
         <dt id="aThingToDo">
           <span class="name "><a href="ex/aThingToDo-class.html">aThingToDo</a></span>
         </dt>
         <dd>
-          <p>A custom annotation.</p>
+          A custom annotation.
         </dd>
         <dt id="B">
           <span class="name "><a href="ex/B-class.html">B</a></span>
         </dt>
         <dd>
-          <p>Extends class <a href="ex/Apple-class.html">Apple</a>, use <a href="ex/Apple/Apple.html">new Apple</a> or <a href="ex/Apple/Apple.fromString.html">new Apple.fromString</a></p>
+          Extends class <a href="ex/Apple-class.html">Apple</a>, use <a href="ex/Apple/Apple.html">new Apple</a> or <a href="ex/Apple/Apple.fromString.html">new Apple.fromString</a>
         </dd>
         <dt id="Cat">
           <span class="name "><a href="ex/Cat-class.html">Cat</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="CatString">
           <span class="name "><a href="ex/CatString-class.html">CatString</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="ConstantCat">
           <span class="name "><a href="ex/ConstantCat-class.html">ConstantCat</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="Cool">
           <span class="name "><a href="fake/Cool-class.html">Cool</a></span>
         </dt>
         <dd>
-          <p>This class is cool!</p>
+          This class is cool!
         </dd>
         <dt id="Deprecated">
           <span class="name "><a href="ex/Deprecated-class.html">Deprecated</a></span>
         </dt>
         <dd>
-          <p>The annotation <code>@Deprecated('expires when')</code> marks a feature as deprecated.</p>
+          The annotation <code>@Deprecated('expires when')</code> marks a feature as deprecated.
         </dd>
         <dt id="Dog">
           <span class="name "><a href="ex/Dog-class.html">Dog</a></span>
         </dt>
         <dd>
-          <p>implements <a href="ex/Cat-class.html">Cat</a>, <a href="ex/E-class.html">E</a></p>
+          implements <a href="ex/Cat-class.html">Cat</a>, <a href="ex/E-class.html">E</a>
         </dd>
         <dt id="E">
           <span class="name "><a href="ex/E-class.html">E</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="F">
           <span class="name "><a href="ex/F-class.html">F</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="ForAnnotation">
           <span class="name "><a href="ex/ForAnnotation-class.html">ForAnnotation</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="HasAnnotation">
           <span class="name "><a href="ex/HasAnnotation-class.html">HasAnnotation</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="Helper">
           <span class="name "><a href="ex/Helper-class.html">Helper</a></span>
         </dt>
         <dd>
-          <p>Even unresolved references in the same library should be resolved
+          Even unresolved references in the same library should be resolved
 <a href="ex/Apple-class.html">Apple</a>
-<a href="ex/B-class.html">ex.B</a></p>
+<a href="ex/B-class.html">ex.B</a>
         </dd>
         <dt id="Klass">
           <span class="name "><a href="ex/Klass-class.html">Klass</a></span>
         </dt>
         <dd>
-          <p>A class</p>
+          A class
         </dd>
         <dt id="PublicClassExtendsPrivateClass">
           <span class="name "><a href="ex/PublicClassExtendsPrivateClass-class.html">PublicClassExtendsPrivateClass</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="PublicClassImplementsPrivateInterface">
           <span class="name "><a href="ex/PublicClassImplementsPrivateInterface-class.html">PublicClassImplementsPrivateInterface</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="ShapeType">
           <span class="name "><a href="ex/ShapeType-class.html">ShapeType</a></span>
         </dt>
         <dd>
-          <p>Foo bar.</p>
+          Foo bar.
         </dd>
         <dt id="SpecializedDuration">
           <span class="name "><a href="ex/SpecializedDuration-class.html">SpecializedDuration</a></span>
         </dt>
         <dd>
-          <p>For testing a class that extends a class
-that has some operators</p>
+          For testing a class that extends a class
+that has some operators
         </dd>
         <dt id="WithGeneric">
           <span class="name "><a href="ex/WithGeneric-class.html">WithGeneric</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="WithGenericSub">
           <span class="name "><a href="ex/WithGenericSub-class.html">WithGenericSub</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -212,7 +212,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>&#39;red&#39;</code></span>
@@ -223,7 +223,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>&#39;green&#39;</code></span>
@@ -234,7 +234,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>&#39;orange&#39;</code></span>
@@ -245,7 +245,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>&#39;red&#39; + &#39;-&#39; + &#39;green&#39; + &#39;-&#39; + &#39;blue&#39;</code></span>
@@ -256,7 +256,7 @@
           <span class="signature">&#8594; <a href="ex/Deprecated-class.html">Deprecated</a></span>
         </dt>
         <dd>
-          <p>Marks a feature as <a href="ex/Deprecated-class.html">Deprecated</a> until the next release.</p>
+          Marks a feature as <a href="ex/Deprecated-class.html">Deprecated</a> until the next release.
           
   <div>
             <span class="signature"><code>const <a href="ex/Deprecated-class.html">Deprecated</a>(&quot;next release&quot;)</code></span>
@@ -267,7 +267,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>This is the same name as a top-level const from the fake lib.</p>
+          This is the same name as a top-level const from the fake lib.
           
   <div>
             <span class="signature"><code>&#39;same name as const from fake&#39;</code></span>
@@ -278,7 +278,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>This should <code>not work</code>.</p>
+          This should <code>not work</code>.
           
   <div>
             <span class="signature"><code>&#39;doh&#39;</code></span>
@@ -289,7 +289,7 @@
           <span class="signature">&#8594; <a href="ex/ConstantCat-class.html">ConstantCat</a></span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>const <a href="ex/ConstantCat-class.html">ConstantCat</a>(&#39;tabby&#39;)</code></span>
@@ -300,7 +300,7 @@
           <span class="signature">&#8594; List&lt;String&gt;</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>const &lt;String&gt; [COLOR_GREEN, COLOR_ORANGE, &#39;blue&#39;]</code></span>
@@ -319,7 +319,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="deprecatedGetter" class="property">
@@ -327,7 +327,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read-only</div>
 </dd>
         <dt id="deprecatedSetter" class="property">
@@ -336,7 +336,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">write-only</div>
 </dd>
         <dt id="number" class="property">
@@ -345,7 +345,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="y" class="property">
@@ -353,7 +353,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read-only</div>
 </dd>
       </dl>
@@ -369,7 +369,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="genericFunction" class="callable">
@@ -378,7 +378,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
       </dl>
@@ -392,7 +392,7 @@
           <a href="ex/Animal-class.html">Animal</a>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -407,7 +407,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="processMessage" class="callable">
@@ -416,7 +416,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
       </dl>
@@ -430,25 +430,25 @@
           <span class="name "><a href="ex/MyError-class.html">MyError</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="MyErrorImplements">
           <span class="name "><a href="ex/MyErrorImplements-class.html">MyErrorImplements</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="MyException">
           <span class="name "><a href="ex/MyException-class.html">MyException</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="MyExceptionImplements">
           <span class="name "><a href="ex/MyExceptionImplements-class.html">MyExceptionImplements</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
diff --git a/testing/test_package_docs/fake/Annotation-class.html b/testing/test_package_docs/fake/Annotation-class.html
index 3f4360c..ea75512 100644
--- a/testing/test_package_docs/fake/Annotation-class.html
+++ b/testing/test_package_docs/fake/Annotation-class.html
@@ -141,7 +141,7 @@
           <span class="name"><a href="fake/Annotation/Annotation.html">Annotation</a></span><span class="signature">(<span class="parameter" id="-param-value"><span class="type-annotation">String</span> <span class="parameter-name">value</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="constructor-modifier features">const</div>
         </dd>
       </dl>
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -164,7 +164,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -172,7 +172,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -187,7 +187,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -196,7 +196,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -211,7 +211,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/AnotherInterface-class.html b/testing/test_package_docs/fake/AnotherInterface-class.html
index c63c30b..6231e2f 100644
--- a/testing/test_package_docs/fake/AnotherInterface-class.html
+++ b/testing/test_package_docs/fake/AnotherInterface-class.html
@@ -153,7 +153,7 @@
           <span class="name"><a href="fake/AnotherInterface/AnotherInterface.html">AnotherInterface</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -167,7 +167,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -175,7 +175,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -190,7 +190,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -199,7 +199,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -214,7 +214,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/BaseForDocComments-class.html b/testing/test_package_docs/fake/BaseForDocComments-class.html
index 16b44eb..63d4734 100644
--- a/testing/test_package_docs/fake/BaseForDocComments-class.html
+++ b/testing/test_package_docs/fake/BaseForDocComments-class.html
@@ -150,7 +150,7 @@
           <span class="name"><a href="fake/BaseForDocComments/BaseForDocComments.html">BaseForDocComments</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -164,7 +164,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -172,7 +172,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -187,7 +187,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="doAwesomeStuff" class="callable">
@@ -196,7 +196,7 @@
           </span>
         </dt>
         <dd>
-          <p>Takes a <code>value</code> and returns a String.</p>
+          Takes a <code>value</code> and returns a String.
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -205,7 +205,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -214,7 +214,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -229,7 +229,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/ClassWithUnusualProperties-class.html b/testing/test_package_docs/fake/ClassWithUnusualProperties-class.html
index a807b06..b920a0d 100644
--- a/testing/test_package_docs/fake/ClassWithUnusualProperties-class.html
+++ b/testing/test_package_docs/fake/ClassWithUnusualProperties-class.html
@@ -155,7 +155,7 @@
           <span class="name"><a href="fake/ClassWithUnusualProperties/ClassWithUnusualProperties.html">ClassWithUnusualProperties</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -169,7 +169,7 @@
           <span class="signature">&#8594; <a href="fake/myCoolTypedef.html">myCoolTypedef</a></span>
         </dt>
         <dd>
-          <p>This property only has a getter and no setter; no parameters to print.</p>
+          This property only has a getter and no setter; no parameters to print.
           <div class="features">read-only</div>
 </dd>
         <dt id="explicitGetterImplicitSetter" class="property">
@@ -177,7 +177,7 @@
           <span class="signature">&#8594; List&lt;int&gt;</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@override, read-only</div>
 </dd>
         <dt id="explicitGetterSetter" class="property">
@@ -186,7 +186,7 @@
           </span>
         </dt>
         <dd>
-          <p>This property is not synthetic, so it might reference <code>f</code> -- display it.</p>
+          This property is not synthetic, so it might reference <code>f</code> -- display it.
           <div class="features">read / write</div>
 </dd>
         <dt id="explicitSetter" class="property">
@@ -195,7 +195,7 @@
           </span>
         </dt>
         <dd>
-          <p>Set to <code>f</code>, and don't warn about <code>bar</code> or <code>baz</code>.</p>
+          Set to <code>f</code>, and don't warn about <code>bar</code> or <code>baz</code>.
           <div class="features">write-only</div>
 </dd>
         <dt id="finalProperty" class="property">
@@ -203,7 +203,7 @@
           <span class="signature">&#8594; Set</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="implicitGetterExplicitSetter" class="property">
@@ -212,7 +212,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">@override, write-only</div>
 </dd>
         <dt id="implicitReadWrite" class="property">
@@ -221,7 +221,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -229,7 +229,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -237,7 +237,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -252,7 +252,7 @@
           </span>
         </dt>
         <dd>
-          <p>Hey there, more things not to warn about: <code>f</code>, <code>x</code>, or <code>q</code>.</p>
+          Hey there, more things not to warn about: <code>f</code>, <code>x</code>, or <code>q</code>.
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -261,7 +261,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -270,7 +270,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -285,7 +285,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/Color-class.html b/testing/test_package_docs/fake/Color-class.html
index bbe1410..2d05d0d 100644
--- a/testing/test_package_docs/fake/Color-class.html
+++ b/testing/test_package_docs/fake/Color-class.html
@@ -248,7 +248,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -256,7 +256,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -271,7 +271,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -280,7 +280,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -295,7 +295,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/ConstantClass-class.html b/testing/test_package_docs/fake/ConstantClass-class.html
index 9d3a266..9a9fd79 100644
--- a/testing/test_package_docs/fake/ConstantClass-class.html
+++ b/testing/test_package_docs/fake/ConstantClass-class.html
@@ -147,22 +147,22 @@
           <span class="name"><a href="fake/ConstantClass/ConstantClass.html">ConstantClass</a></span><span class="signature">(<span class="parameter" id="-param-value"><span class="type-annotation">String</span> <span class="parameter-name">value</span></span>)</span>
         </dt>
         <dd>
-          <p>Make compile-time constants with this constructor!
-Go ahead, it's fun.</p>
+          Make compile-time constants with this constructor!
+Go ahead, it's fun.
           <div class="constructor-modifier features">const</div>
         </dd>
         <dt id="ConstantClass.isVeryConstant" class="callable">
           <span class="name"><a href="fake/ConstantClass/ConstantClass.isVeryConstant.html">ConstantClass.isVeryConstant</a></span><span class="signature">(<span class="parameter" id="isVeryConstant-param-value"><span class="type-annotation">String</span> <span class="parameter-name">value</span></span>)</span>
         </dt>
         <dd>
-          <p>A named compile-time constant constructor.</p>
+          A named compile-time constant constructor.
           <div class="constructor-modifier features">const</div>
         </dd>
         <dt id="ConstantClass.notConstant" class="callable">
           <span class="name"><a href="fake/ConstantClass/ConstantClass.notConstant.html">ConstantClass.notConstant</a></span><span class="signature">(<span class="parameter" id="notConstant-param-value"><span class="type-annotation">String</span> <span class="parameter-name">value</span></span>)</span>
         </dt>
         <dd>
-          <p>Not actually constant.</p>
+          Not actually constant.
         </dd>
       </dl>
     </section>
@@ -176,7 +176,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -184,7 +184,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -192,7 +192,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -207,7 +207,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -216,7 +216,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -231,7 +231,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/Cool-class.html b/testing/test_package_docs/fake/Cool-class.html
index b0f743e..f3b37df 100644
--- a/testing/test_package_docs/fake/Cool-class.html
+++ b/testing/test_package_docs/fake/Cool-class.html
@@ -141,7 +141,7 @@
           <span class="name"><a href="fake/Cool/Cool.html">Cool</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -155,7 +155,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -163,7 +163,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -178,7 +178,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -187,7 +187,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -196,7 +196,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -211,7 +211,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/Doh-class.html b/testing/test_package_docs/fake/Doh-class.html
index 89597fa..bd03bfa 100644
--- a/testing/test_package_docs/fake/Doh-class.html
+++ b/testing/test_package_docs/fake/Doh-class.html
@@ -159,7 +159,7 @@
           <span class="name"><a href="fake/Doh/Doh.html">Doh</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -173,7 +173,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -181,7 +181,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="stackTrace" class="property inherited">
@@ -189,7 +189,7 @@
           <span class="signature">&#8594; StackTrace</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -204,7 +204,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -213,7 +213,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -228,7 +228,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/ExtraSpecialList-class.html b/testing/test_package_docs/fake/ExtraSpecialList-class.html
index e3de9fa..f253b88 100644
--- a/testing/test_package_docs/fake/ExtraSpecialList-class.html
+++ b/testing/test_package_docs/fake/ExtraSpecialList-class.html
@@ -156,7 +156,7 @@
           <span class="name"><a href="fake/ExtraSpecialList/ExtraSpecialList.html">ExtraSpecialList</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -170,7 +170,7 @@
           <span class="signature">&#8594; E</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -178,7 +178,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="isEmpty" class="property inherited">
@@ -186,7 +186,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="isNotEmpty" class="property inherited">
@@ -194,7 +194,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="iterator" class="property inherited">
@@ -202,7 +202,7 @@
           <span class="signature">&#8594; Iterator&lt;E&gt;</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="last" class="property inherited">
@@ -210,7 +210,7 @@
           <span class="signature">&#8594; E</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="length" class="property inherited">
@@ -219,7 +219,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read / write, inherited</div>
 </dd>
         <dt id="reversed" class="property inherited">
@@ -227,7 +227,7 @@
           <span class="signature">&#8594; Iterable&lt;E&gt;</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -235,7 +235,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="single" class="property inherited">
@@ -243,7 +243,7 @@
           <span class="signature">&#8594; E</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -258,8 +258,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Adds <code>value</code> to the end of this list,
-extending the length by one.</p>
+          Adds <code>value</code> to the end of this list,
+extending the length by one.
           <div class="features">inherited</div>
 </dd>
         <dt id="addAll" class="callable inherited">
@@ -268,7 +268,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Appends all objects of <code>iterable</code> to the end of this list.</p>
+          Appends all objects of <code>iterable</code> to the end of this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="any" class="callable inherited">
@@ -277,7 +277,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Checks whether any element of this iterable satisfies <code>test</code>.</p>
+          Checks whether any element of this iterable satisfies <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="asMap" class="callable inherited">
@@ -286,7 +286,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns an unmodifiable <code>Map</code> view of <code>this</code>.</p>
+          Returns an unmodifiable <code>Map</code> view of <code>this</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="clear" class="callable inherited">
@@ -295,8 +295,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes all objects from this list;
-the length of the list becomes zero.</p>
+          Removes all objects from this list;
+the length of the list becomes zero.
           <div class="features">inherited</div>
 </dd>
         <dt id="contains" class="callable inherited">
@@ -305,7 +305,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns true if the collection contains an element equal to <code>element</code>.</p>
+          Returns true if the collection contains an element equal to <code>element</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="elementAt" class="callable inherited">
@@ -314,7 +314,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the <code>index</code>th element.</p>
+          Returns the <code>index</code>th element.
           <div class="features">inherited</div>
 </dd>
         <dt id="every" class="callable inherited">
@@ -323,7 +323,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Checks whether every element of this iterable satisfies <code>test</code>.</p>
+          Checks whether every element of this iterable satisfies <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="expand" class="callable inherited">
@@ -332,7 +332,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Expands each element of this <code>Iterable</code> into zero or more elements.</p>
+          Expands each element of this <code>Iterable</code> into zero or more elements.
           <div class="features">inherited</div>
 </dd>
         <dt id="fillRange" class="callable inherited">
@@ -341,8 +341,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Sets the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
-to the given <code>fillValue</code>.</p>
+          Sets the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
+to the given <code>fillValue</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="firstWhere" class="callable inherited">
@@ -351,7 +351,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the first element that satisfies the given predicate <code>test</code>.</p>
+          Returns the first element that satisfies the given predicate <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="fold" class="callable inherited">
@@ -360,8 +360,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Reduces a collection to a single value by iteratively combining each
-element of the collection with an existing value</p>
+          Reduces a collection to a single value by iteratively combining each
+element of the collection with an existing value
           <div class="features">inherited</div>
 </dd>
         <dt id="forEach" class="callable inherited">
@@ -370,8 +370,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Applies the function <code>f</code> to each element of this collection in iteration
-order.</p>
+          Applies the function <code>f</code> to each element of this collection in iteration
+order.
           <div class="features">inherited</div>
 </dd>
         <dt id="getRange" class="callable inherited">
@@ -380,8 +380,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns an <code>Iterable</code> that iterates over the objects in the range
-<code>start</code> inclusive to <code>end</code> exclusive.</p>
+          Returns an <code>Iterable</code> that iterates over the objects in the range
+<code>start</code> inclusive to <code>end</code> exclusive.
           <div class="features">inherited</div>
 </dd>
         <dt id="indexOf" class="callable inherited">
@@ -390,7 +390,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the first index of <code>element</code> in this list.</p>
+          Returns the first index of <code>element</code> in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="insert" class="callable inherited">
@@ -399,7 +399,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Inserts the object at position <code>index</code> in this list.</p>
+          Inserts the object at position <code>index</code> in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="insertAll" class="callable inherited">
@@ -408,7 +408,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Inserts all objects of <code>iterable</code> at position <code>index</code> in this list.</p>
+          Inserts all objects of <code>iterable</code> at position <code>index</code> in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="join" class="callable inherited">
@@ -417,7 +417,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Converts each element to a <code>String</code> and concatenates the strings.</p>
+          Converts each element to a <code>String</code> and concatenates the strings.
           <div class="features">inherited</div>
 </dd>
         <dt id="lastIndexOf" class="callable inherited">
@@ -426,9 +426,9 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the last index in the list <code>a</code> of the given <code>element</code>, starting
+          Returns the last index in the list <code>a</code> of the given <code>element</code>, starting
 the search at index <code>startIndex</code> to 0.
-Returns -1 if <code>element</code> is not found.</p>
+Returns -1 if <code>element</code> is not found.
           <div class="features">inherited</div>
 </dd>
         <dt id="lastWhere" class="callable inherited">
@@ -437,7 +437,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the last element that satisfies the given predicate <code>test</code>.</p>
+          Returns the last element that satisfies the given predicate <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="map" class="callable inherited">
@@ -446,8 +446,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a new lazy <code>Iterable</code> with elements that are created by
-calling <code>f</code> on each element of this <code>Iterable</code> in iteration order.</p>
+          Returns a new lazy <code>Iterable</code> with elements that are created by
+calling <code>f</code> on each element of this <code>Iterable</code> in iteration order.
           <div class="features">inherited</div>
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -456,7 +456,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="reduce" class="callable inherited">
@@ -465,8 +465,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Reduces a collection to a single value by iteratively combining elements
-of the collection using the provided function.</p>
+          Reduces a collection to a single value by iteratively combining elements
+of the collection using the provided function.
           <div class="features">inherited</div>
 </dd>
         <dt id="remove" class="callable inherited">
@@ -475,7 +475,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes the first occurrence of <code>value</code> from this list.</p>
+          Removes the first occurrence of <code>value</code> from this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="removeAt" class="callable inherited">
@@ -484,7 +484,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes the object at position <code>index</code> from this list.</p>
+          Removes the object at position <code>index</code> from this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="removeLast" class="callable inherited">
@@ -493,7 +493,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Pops and returns the last object in this list.</p>
+          Pops and returns the last object in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="removeRange" class="callable inherited">
@@ -502,7 +502,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive.</p>
+          Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive.
           <div class="features">inherited</div>
 </dd>
         <dt id="removeWhere" class="callable inherited">
@@ -511,7 +511,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes all objects from this list that satisfy <code>test</code>.</p>
+          Removes all objects from this list that satisfy <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="replaceRange" class="callable inherited">
@@ -520,8 +520,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
-and inserts the contents of <code>replacement</code> in its place.</p>
+          Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
+and inserts the contents of <code>replacement</code> in its place.
           <div class="features">inherited</div>
 </dd>
         <dt id="retainWhere" class="callable inherited">
@@ -530,7 +530,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes all objects from this list that fail to satisfy <code>test</code>.</p>
+          Removes all objects from this list that fail to satisfy <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="setAll" class="callable inherited">
@@ -539,8 +539,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Overwrites objects of <code>this</code> with the objects of <code>iterable</code>, starting
-at position <code>index</code> in this list.</p>
+          Overwrites objects of <code>this</code> with the objects of <code>iterable</code>, starting
+at position <code>index</code> in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="setRange" class="callable inherited">
@@ -549,8 +549,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Copies the objects of <code>iterable</code>, skipping <code>skipCount</code> objects first,
-into the range <code>start</code>, inclusive, to <code>end</code>, exclusive, of the list.</p>
+          Copies the objects of <code>iterable</code>, skipping <code>skipCount</code> objects first,
+into the range <code>start</code>, inclusive, to <code>end</code>, exclusive, of the list.
           <div class="features">inherited</div>
 </dd>
         <dt id="shuffle" class="callable inherited">
@@ -559,7 +559,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Shuffles the elements of this list randomly.</p>
+          Shuffles the elements of this list randomly.
           <div class="features">inherited</div>
 </dd>
         <dt id="singleWhere" class="callable inherited">
@@ -568,7 +568,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the single element that satisfies <code>test</code>.</p>
+          Returns the single element that satisfies <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="skip" class="callable inherited">
@@ -577,7 +577,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns an <code>Iterable</code> that provides all but the first <code>count</code> elements.</p>
+          Returns an <code>Iterable</code> that provides all but the first <code>count</code> elements.
           <div class="features">inherited</div>
 </dd>
         <dt id="skipWhile" class="callable inherited">
@@ -586,7 +586,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns an <code>Iterable</code> that skips leading elements while <code>test</code> is satisfied.</p>
+          Returns an <code>Iterable</code> that skips leading elements while <code>test</code> is satisfied.
           <div class="features">inherited</div>
 </dd>
         <dt id="sort" class="callable inherited">
@@ -595,7 +595,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Sorts this list according to the order specified by the <code>compare</code> function.</p>
+          Sorts this list according to the order specified by the <code>compare</code> function.
           <div class="features">inherited</div>
 </dd>
         <dt id="sublist" class="callable inherited">
@@ -604,8 +604,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a new list containing the objects from <code>start</code> inclusive to <code>end</code>
-exclusive.</p>
+          Returns a new list containing the objects from <code>start</code> inclusive to <code>end</code>
+exclusive.
           <div class="features">inherited</div>
 </dd>
         <dt id="take" class="callable inherited">
@@ -614,7 +614,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a lazy iterable of the <code>count</code> first elements of this iterable.</p>
+          Returns a lazy iterable of the <code>count</code> first elements of this iterable.
           <div class="features">inherited</div>
 </dd>
         <dt id="takeWhile" class="callable inherited">
@@ -623,7 +623,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a lazy iterable of the leading elements satisfying <code>test</code>.</p>
+          Returns a lazy iterable of the leading elements satisfying <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="toList" class="callable inherited">
@@ -632,7 +632,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Creates a <code>List</code> containing the elements of this <code>Iterable</code>.</p>
+          Creates a <code>List</code> containing the elements of this <code>Iterable</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="toSet" class="callable inherited">
@@ -641,7 +641,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Creates a <code>Set</code> containing the same elements as this iterable.</p>
+          Creates a <code>Set</code> containing the same elements as this iterable.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -650,7 +650,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
         <dt id="where" class="callable inherited">
@@ -659,8 +659,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a new lazy <code>Iterable</code> with all elements that satisfy the
-predicate <code>test</code>.</p>
+          Returns a new lazy <code>Iterable</code> with all elements that satisfy the
+predicate <code>test</code>.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -675,7 +675,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
         <dt id="operator []" class="callable inherited">
@@ -684,7 +684,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="operator []=" class="callable inherited">
@@ -693,7 +693,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/Foo2-class.html b/testing/test_package_docs/fake/Foo2-class.html
index e34b14c..bb7f40c 100644
--- a/testing/test_package_docs/fake/Foo2-class.html
+++ b/testing/test_package_docs/fake/Foo2-class.html
@@ -141,7 +141,7 @@
           <span class="name"><a href="fake/Foo2/Foo2.html">Foo2</a></span><span class="signature">(<span class="parameter" id="-param-index"><span class="type-annotation">int</span> <span class="parameter-name">index</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="constructor-modifier features">const</div>
         </dd>
       </dl>
@@ -156,7 +156,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -164,7 +164,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -172,7 +172,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -187,7 +187,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -196,7 +196,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -211,7 +211,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -228,7 +228,7 @@
           <span class="signature">&#8594; <a href="fake/Foo2-class.html">Foo2</a></span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>const <a href="fake/Foo2-class.html">Foo2</a>(0)</code></span>
@@ -239,7 +239,7 @@
           <span class="signature">&#8594; <a href="fake/Foo2-class.html">Foo2</a></span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>const <a href="fake/Foo2-class.html">Foo2</a>(1)</code></span>
diff --git a/testing/test_package_docs/fake/HasGenericWithExtends-class.html b/testing/test_package_docs/fake/HasGenericWithExtends-class.html
index 5dcfe73..13add6a 100644
--- a/testing/test_package_docs/fake/HasGenericWithExtends-class.html
+++ b/testing/test_package_docs/fake/HasGenericWithExtends-class.html
@@ -141,7 +141,7 @@
           <span class="name"><a href="fake/HasGenericWithExtends/HasGenericWithExtends.html">HasGenericWithExtends</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -155,7 +155,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -163,7 +163,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -178,7 +178,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -187,7 +187,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -202,7 +202,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/HasGenerics-class.html b/testing/test_package_docs/fake/HasGenerics-class.html
index 4ba626b..9973991 100644
--- a/testing/test_package_docs/fake/HasGenerics-class.html
+++ b/testing/test_package_docs/fake/HasGenerics-class.html
@@ -138,7 +138,7 @@
           <span class="name"><a href="fake/HasGenerics/HasGenerics.html">HasGenerics</a></span><span class="signature">(<span class="parameter" id="-param-x"><span class="type-annotation">X</span> <span class="parameter-name">x</span>, </span> <span class="parameter" id="-param-y"><span class="type-annotation">Y</span> <span class="parameter-name">y</span>, </span> <span class="parameter" id="-param-z"><span class="type-annotation">Z</span> <span class="parameter-name">z</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -152,7 +152,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -160,7 +160,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -175,7 +175,7 @@
           </span>
         </dt>
         <dd>
-          <p>Converts itself to a map.</p>
+          Converts itself to a map.
           
 </dd>
         <dt id="doStuff" class="callable">
@@ -184,7 +184,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="returnX" class="callable">
@@ -193,7 +193,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="returnZ" class="callable">
@@ -202,7 +202,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -211,7 +211,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -220,7 +220,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -235,7 +235,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/ImplicitProperties-class.html b/testing/test_package_docs/fake/ImplicitProperties-class.html
index f2fe49b..892cf12 100644
--- a/testing/test_package_docs/fake/ImplicitProperties-class.html
+++ b/testing/test_package_docs/fake/ImplicitProperties-class.html
@@ -154,7 +154,7 @@
           <span class="name"><a href="fake/ImplicitProperties/ImplicitProperties.html">ImplicitProperties</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -169,7 +169,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="implicitGetterExplicitSetter" class="property">
@@ -178,7 +178,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -186,7 +186,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -194,7 +194,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -209,7 +209,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -218,7 +218,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -233,7 +233,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/Interface-class.html b/testing/test_package_docs/fake/Interface-class.html
index 4788cf9..1319bc9 100644
--- a/testing/test_package_docs/fake/Interface-class.html
+++ b/testing/test_package_docs/fake/Interface-class.html
@@ -153,7 +153,7 @@
           <span class="name"><a href="fake/Interface/Interface.html">Interface</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -167,7 +167,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -175,7 +175,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -190,7 +190,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -199,7 +199,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -214,7 +214,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/LongFirstLine-class.html b/testing/test_package_docs/fake/LongFirstLine-class.html
index 492e347..b1fab32 100644
--- a/testing/test_package_docs/fake/LongFirstLine-class.html
+++ b/testing/test_package_docs/fake/LongFirstLine-class.html
@@ -172,19 +172,19 @@
           <span class="name"><a class="deprecated" href="fake/LongFirstLine/LongFirstLine.html">LongFirstLine</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p>The default constructor.</p>
+          The default constructor.
         </dd>
         <dt id="LongFirstLine.fromHasGenerics" class="callable">
           <span class="name"><a href="fake/LongFirstLine/LongFirstLine.fromHasGenerics.html">LongFirstLine.fromHasGenerics</a></span><span class="signature">(<span class="parameter" id="fromHasGenerics-param-hg"><span class="type-annotation"><a href="fake/HasGenerics-class.html">HasGenerics</a></span> <span class="parameter-name">hg</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="LongFirstLine.fromMap" class="callable">
           <span class="name"><a href="fake/LongFirstLine/LongFirstLine.fromMap.html">LongFirstLine.fromMap</a></span><span class="signature">(<span class="parameter" id="fromMap-param-data"><span class="type-annotation">Map</span> <span class="parameter-name">data</span></span>)</span>
         </dt>
         <dd>
-          <p>Named constructors are awesome.</p>
+          Named constructors are awesome.
         </dd>
       </dl>
     </section>
@@ -199,7 +199,7 @@
           </span>
         </dt>
         <dd>
-          <p>An instance string property. Readable and writable.</p>
+          An instance string property. Readable and writable.
           <div class="features">read / write</div>
 </dd>
         <dt id="dynamicGetter" class="property">
@@ -207,7 +207,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>Dynamic getter. Readable only.</p>
+          Dynamic getter. Readable only.
           <div class="features">read-only</div>
 </dd>
         <dt id="onlySetter" class="property">
@@ -216,7 +216,7 @@
           </span>
         </dt>
         <dd>
-          <p>Only a setter, with a single param, of type double.</p>
+          Only a setter, with a single param, of type double.
           <div class="features">write-only</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -224,7 +224,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="powers" class="property inherited">
@@ -233,7 +233,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>In the super class.</p>
+          In the super class.
           <div class="features">read / write, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -241,7 +241,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -256,7 +256,7 @@
           </span>
         </dt>
         <dd>
-          <p>No params.</p>
+          No params.
           
 </dd>
         <dt id="optionalParams" class="callable">
@@ -265,7 +265,7 @@
           </span>
         </dt>
         <dd>
-          <p>One dynamic param, two named optionals.</p>
+          One dynamic param, two named optionals.
           
 </dd>
         <dt id="returnString" class="callable">
@@ -274,7 +274,7 @@
           </span>
         </dt>
         <dd>
-          <p>Returns a single string.</p>
+          Returns a single string.
           
 </dd>
         <dt id="twoParams" class="callable">
@@ -283,7 +283,7 @@
           </span>
         </dt>
         <dd>
-          <p>Two params, the first has a type annotation, the second does not.</p>
+          Two params, the first has a type annotation, the second does not.
           
 </dd>
         <dt id="fly" class="callable inherited">
@@ -292,7 +292,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>In the super class.</p>
+          In the super class.
           <div class="features">inherited</div>
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -301,7 +301,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -310,7 +310,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -325,7 +325,7 @@
           </span>
         </dt>
         <dd>
-          <p>Multiplies a thingies to this thingie and then returns a new thingie.</p>
+          Multiplies a thingies to this thingie and then returns a new thingie.
           
 </dd>
         <dt id="operator +" class="callable">
@@ -334,7 +334,7 @@
           </span>
         </dt>
         <dd>
-          <p>Adds another one of these thingies.</p>
+          Adds another one of these thingies.
           
 </dd>
         <dt id="operator -" class="callable inherited">
@@ -343,7 +343,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="operator ==" class="callable inherited">
@@ -352,7 +352,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -368,7 +368,7 @@
           </span>
         </dt>
         <dd>
-          <p>A static int property.</p>
+          A static int property.
           <div class="features">read / write</div>
 </dd>
         <dt id="staticGetter" class="property">
@@ -376,7 +376,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read-only</div>
 </dd>
         <dt id="staticOnlySetter" class="property">
@@ -385,7 +385,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">write-only</div>
 </dd>
       </dl>
@@ -400,7 +400,7 @@
           </span>
         </dt>
         <dd>
-          <p>Just a static method with no parameters.</p>
+          Just a static method with no parameters.
           
 </dd>
         <dt id="staticMethodReturnsVoid" class="callable">
@@ -409,7 +409,7 @@
           </span>
         </dt>
         <dd>
-          <p>A static method that takes a single dynamic thing, and returns void.</p>
+          A static method that takes a single dynamic thing, and returns void.
           
 </dd>
       </dl>
@@ -424,7 +424,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>42</code></span>
@@ -435,7 +435,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>'yup'</code></span>
diff --git a/testing/test_package_docs/fake/MixMeIn-class.html b/testing/test_package_docs/fake/MixMeIn-class.html
index 958a142..9d42dee 100644
--- a/testing/test_package_docs/fake/MixMeIn-class.html
+++ b/testing/test_package_docs/fake/MixMeIn-class.html
@@ -153,7 +153,7 @@
           <span class="name"><a href="fake/MixMeIn/MixMeIn.html">MixMeIn</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -167,7 +167,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -175,7 +175,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -190,7 +190,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -199,7 +199,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -214,7 +214,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/Oops-class.html b/testing/test_package_docs/fake/Oops-class.html
index 68bc14b..ac4e86d 100644
--- a/testing/test_package_docs/fake/Oops-class.html
+++ b/testing/test_package_docs/fake/Oops-class.html
@@ -155,7 +155,7 @@
           <span class="name"><a href="fake/Oops/Oops.html">Oops</a></span><span class="signature">(<span class="parameter" id="-param-message"><span class="type-annotation">String</span> <span class="parameter-name">message</span></span>)</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -169,7 +169,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">final</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -177,7 +177,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -185,7 +185,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -200,7 +200,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -209,7 +209,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -224,7 +224,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/OperatorReferenceClass-class.html b/testing/test_package_docs/fake/OperatorReferenceClass-class.html
index 04ebe87..dd66d88 100644
--- a/testing/test_package_docs/fake/OperatorReferenceClass-class.html
+++ b/testing/test_package_docs/fake/OperatorReferenceClass-class.html
@@ -141,7 +141,7 @@
           <span class="name"><a href="fake/OperatorReferenceClass/OperatorReferenceClass.html">OperatorReferenceClass</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -155,7 +155,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -163,7 +163,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -178,7 +178,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -187,7 +187,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -202,7 +202,7 @@
           </span>
         </dt>
         <dd>
-          <p>The equality operator.</p>
+          The equality operator.
           
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/OtherGenericsThing-class.html b/testing/test_package_docs/fake/OtherGenericsThing-class.html
index 768bfb2..77b0636 100644
--- a/testing/test_package_docs/fake/OtherGenericsThing-class.html
+++ b/testing/test_package_docs/fake/OtherGenericsThing-class.html
@@ -138,7 +138,7 @@
           <span class="name"><a href="fake/OtherGenericsThing/OtherGenericsThing.html">OtherGenericsThing</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -152,7 +152,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -160,7 +160,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -175,7 +175,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -184,7 +184,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -193,7 +193,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -208,7 +208,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/SpecialList-class.html b/testing/test_package_docs/fake/SpecialList-class.html
index 8151070..2f00156 100644
--- a/testing/test_package_docs/fake/SpecialList-class.html
+++ b/testing/test_package_docs/fake/SpecialList-class.html
@@ -159,7 +159,7 @@
           <span class="name"><a href="fake/SpecialList/SpecialList.html">SpecialList</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -174,7 +174,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="first" class="property inherited">
@@ -182,7 +182,7 @@
           <span class="signature">&#8594; E</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -190,7 +190,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="isEmpty" class="property inherited">
@@ -198,7 +198,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="isNotEmpty" class="property inherited">
@@ -206,7 +206,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="iterator" class="property inherited">
@@ -214,7 +214,7 @@
           <span class="signature">&#8594; Iterator&lt;E&gt;</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="last" class="property inherited">
@@ -222,7 +222,7 @@
           <span class="signature">&#8594; E</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="reversed" class="property inherited">
@@ -230,7 +230,7 @@
           <span class="signature">&#8594; Iterable&lt;E&gt;</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -238,7 +238,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="single" class="property inherited">
@@ -246,7 +246,7 @@
           <span class="signature">&#8594; E</span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -261,8 +261,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Adds <code>value</code> to the end of this list,
-extending the length by one.</p>
+          Adds <code>value</code> to the end of this list,
+extending the length by one.
           <div class="features">inherited</div>
 </dd>
         <dt id="addAll" class="callable inherited">
@@ -271,7 +271,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Appends all objects of <code>iterable</code> to the end of this list.</p>
+          Appends all objects of <code>iterable</code> to the end of this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="any" class="callable inherited">
@@ -280,7 +280,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Checks whether any element of this iterable satisfies <code>test</code>.</p>
+          Checks whether any element of this iterable satisfies <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="asMap" class="callable inherited">
@@ -289,7 +289,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns an unmodifiable <code>Map</code> view of <code>this</code>.</p>
+          Returns an unmodifiable <code>Map</code> view of <code>this</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="clear" class="callable inherited">
@@ -298,8 +298,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes all objects from this list;
-the length of the list becomes zero.</p>
+          Removes all objects from this list;
+the length of the list becomes zero.
           <div class="features">inherited</div>
 </dd>
         <dt id="contains" class="callable inherited">
@@ -308,7 +308,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns true if the collection contains an element equal to <code>element</code>.</p>
+          Returns true if the collection contains an element equal to <code>element</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="elementAt" class="callable inherited">
@@ -317,7 +317,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the <code>index</code>th element.</p>
+          Returns the <code>index</code>th element.
           <div class="features">inherited</div>
 </dd>
         <dt id="every" class="callable inherited">
@@ -326,7 +326,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Checks whether every element of this iterable satisfies <code>test</code>.</p>
+          Checks whether every element of this iterable satisfies <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="expand" class="callable inherited">
@@ -335,7 +335,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Expands each element of this <code>Iterable</code> into zero or more elements.</p>
+          Expands each element of this <code>Iterable</code> into zero or more elements.
           <div class="features">inherited</div>
 </dd>
         <dt id="fillRange" class="callable inherited">
@@ -344,8 +344,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Sets the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
-to the given <code>fillValue</code>.</p>
+          Sets the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
+to the given <code>fillValue</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="firstWhere" class="callable inherited">
@@ -354,7 +354,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the first element that satisfies the given predicate <code>test</code>.</p>
+          Returns the first element that satisfies the given predicate <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="fold" class="callable inherited">
@@ -363,8 +363,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Reduces a collection to a single value by iteratively combining each
-element of the collection with an existing value</p>
+          Reduces a collection to a single value by iteratively combining each
+element of the collection with an existing value
           <div class="features">inherited</div>
 </dd>
         <dt id="forEach" class="callable inherited">
@@ -373,8 +373,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Applies the function <code>f</code> to each element of this collection in iteration
-order.</p>
+          Applies the function <code>f</code> to each element of this collection in iteration
+order.
           <div class="features">inherited</div>
 </dd>
         <dt id="getRange" class="callable inherited">
@@ -383,8 +383,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns an <code>Iterable</code> that iterates over the objects in the range
-<code>start</code> inclusive to <code>end</code> exclusive.</p>
+          Returns an <code>Iterable</code> that iterates over the objects in the range
+<code>start</code> inclusive to <code>end</code> exclusive.
           <div class="features">inherited</div>
 </dd>
         <dt id="indexOf" class="callable inherited">
@@ -393,7 +393,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the first index of <code>element</code> in this list.</p>
+          Returns the first index of <code>element</code> in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="insert" class="callable inherited">
@@ -402,7 +402,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Inserts the object at position <code>index</code> in this list.</p>
+          Inserts the object at position <code>index</code> in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="insertAll" class="callable inherited">
@@ -411,7 +411,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Inserts all objects of <code>iterable</code> at position <code>index</code> in this list.</p>
+          Inserts all objects of <code>iterable</code> at position <code>index</code> in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="join" class="callable inherited">
@@ -420,7 +420,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Converts each element to a <code>String</code> and concatenates the strings.</p>
+          Converts each element to a <code>String</code> and concatenates the strings.
           <div class="features">inherited</div>
 </dd>
         <dt id="lastIndexOf" class="callable inherited">
@@ -429,9 +429,9 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the last index in the list <code>a</code> of the given <code>element</code>, starting
+          Returns the last index in the list <code>a</code> of the given <code>element</code>, starting
 the search at index <code>startIndex</code> to 0.
-Returns -1 if <code>element</code> is not found.</p>
+Returns -1 if <code>element</code> is not found.
           <div class="features">inherited</div>
 </dd>
         <dt id="lastWhere" class="callable inherited">
@@ -440,7 +440,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the last element that satisfies the given predicate <code>test</code>.</p>
+          Returns the last element that satisfies the given predicate <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="map" class="callable inherited">
@@ -449,8 +449,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a new lazy <code>Iterable</code> with elements that are created by
-calling <code>f</code> on each element of this <code>Iterable</code> in iteration order.</p>
+          Returns a new lazy <code>Iterable</code> with elements that are created by
+calling <code>f</code> on each element of this <code>Iterable</code> in iteration order.
           <div class="features">inherited</div>
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -459,7 +459,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="reduce" class="callable inherited">
@@ -468,8 +468,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Reduces a collection to a single value by iteratively combining elements
-of the collection using the provided function.</p>
+          Reduces a collection to a single value by iteratively combining elements
+of the collection using the provided function.
           <div class="features">inherited</div>
 </dd>
         <dt id="remove" class="callable inherited">
@@ -478,7 +478,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes the first occurrence of <code>value</code> from this list.</p>
+          Removes the first occurrence of <code>value</code> from this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="removeAt" class="callable inherited">
@@ -487,7 +487,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes the object at position <code>index</code> from this list.</p>
+          Removes the object at position <code>index</code> from this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="removeLast" class="callable inherited">
@@ -496,7 +496,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Pops and returns the last object in this list.</p>
+          Pops and returns the last object in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="removeRange" class="callable inherited">
@@ -505,7 +505,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive.</p>
+          Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive.
           <div class="features">inherited</div>
 </dd>
         <dt id="removeWhere" class="callable inherited">
@@ -514,7 +514,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes all objects from this list that satisfy <code>test</code>.</p>
+          Removes all objects from this list that satisfy <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="replaceRange" class="callable inherited">
@@ -523,8 +523,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
-and inserts the contents of <code>replacement</code> in its place.</p>
+          Removes the objects in the range <code>start</code> inclusive to <code>end</code> exclusive
+and inserts the contents of <code>replacement</code> in its place.
           <div class="features">inherited</div>
 </dd>
         <dt id="retainWhere" class="callable inherited">
@@ -533,7 +533,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Removes all objects from this list that fail to satisfy <code>test</code>.</p>
+          Removes all objects from this list that fail to satisfy <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="setAll" class="callable inherited">
@@ -542,8 +542,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Overwrites objects of <code>this</code> with the objects of <code>iterable</code>, starting
-at position <code>index</code> in this list.</p>
+          Overwrites objects of <code>this</code> with the objects of <code>iterable</code>, starting
+at position <code>index</code> in this list.
           <div class="features">inherited</div>
 </dd>
         <dt id="setRange" class="callable inherited">
@@ -552,8 +552,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Copies the objects of <code>iterable</code>, skipping <code>skipCount</code> objects first,
-into the range <code>start</code>, inclusive, to <code>end</code>, exclusive, of the list.</p>
+          Copies the objects of <code>iterable</code>, skipping <code>skipCount</code> objects first,
+into the range <code>start</code>, inclusive, to <code>end</code>, exclusive, of the list.
           <div class="features">inherited</div>
 </dd>
         <dt id="shuffle" class="callable inherited">
@@ -562,7 +562,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Shuffles the elements of this list randomly.</p>
+          Shuffles the elements of this list randomly.
           <div class="features">inherited</div>
 </dd>
         <dt id="singleWhere" class="callable inherited">
@@ -571,7 +571,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns the single element that satisfies <code>test</code>.</p>
+          Returns the single element that satisfies <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="skip" class="callable inherited">
@@ -580,7 +580,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns an <code>Iterable</code> that provides all but the first <code>count</code> elements.</p>
+          Returns an <code>Iterable</code> that provides all but the first <code>count</code> elements.
           <div class="features">inherited</div>
 </dd>
         <dt id="skipWhile" class="callable inherited">
@@ -589,7 +589,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns an <code>Iterable</code> that skips leading elements while <code>test</code> is satisfied.</p>
+          Returns an <code>Iterable</code> that skips leading elements while <code>test</code> is satisfied.
           <div class="features">inherited</div>
 </dd>
         <dt id="sort" class="callable inherited">
@@ -598,7 +598,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Sorts this list according to the order specified by the <code>compare</code> function.</p>
+          Sorts this list according to the order specified by the <code>compare</code> function.
           <div class="features">inherited</div>
 </dd>
         <dt id="sublist" class="callable inherited">
@@ -607,8 +607,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a new list containing the objects from <code>start</code> inclusive to <code>end</code>
-exclusive.</p>
+          Returns a new list containing the objects from <code>start</code> inclusive to <code>end</code>
+exclusive.
           <div class="features">inherited</div>
 </dd>
         <dt id="take" class="callable inherited">
@@ -617,7 +617,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a lazy iterable of the <code>count</code> first elements of this iterable.</p>
+          Returns a lazy iterable of the <code>count</code> first elements of this iterable.
           <div class="features">inherited</div>
 </dd>
         <dt id="takeWhile" class="callable inherited">
@@ -626,7 +626,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a lazy iterable of the leading elements satisfying <code>test</code>.</p>
+          Returns a lazy iterable of the leading elements satisfying <code>test</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="toList" class="callable inherited">
@@ -635,7 +635,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Creates a <code>List</code> containing the elements of this <code>Iterable</code>.</p>
+          Creates a <code>List</code> containing the elements of this <code>Iterable</code>.
           <div class="features">inherited</div>
 </dd>
         <dt id="toSet" class="callable inherited">
@@ -644,7 +644,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Creates a <code>Set</code> containing the same elements as this iterable.</p>
+          Creates a <code>Set</code> containing the same elements as this iterable.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -653,7 +653,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
         <dt id="where" class="callable inherited">
@@ -662,8 +662,8 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a new lazy <code>Iterable</code> with all elements that satisfy the
-predicate <code>test</code>.</p>
+          Returns a new lazy <code>Iterable</code> with all elements that satisfy the
+predicate <code>test</code>.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -678,7 +678,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="operator []=" class="callable">
@@ -687,7 +687,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="operator ==" class="callable inherited">
@@ -696,7 +696,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/SubForDocComments-class.html b/testing/test_package_docs/fake/SubForDocComments-class.html
index 654677c..4a83db3 100644
--- a/testing/test_package_docs/fake/SubForDocComments-class.html
+++ b/testing/test_package_docs/fake/SubForDocComments-class.html
@@ -155,7 +155,7 @@
           <span class="name"><a href="fake/SubForDocComments/SubForDocComments.html">SubForDocComments</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -169,7 +169,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -177,7 +177,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -192,7 +192,7 @@
           </span>
         </dt>
         <dd>
-          <p>Reference to <code>foo</code> and <code>bar</code></p>
+          Reference to <code>foo</code> and <code>bar</code>
           
 </dd>
         <dt id="anotherMethod" class="callable inherited">
@@ -201,7 +201,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p></p>
+          
           <div class="features">inherited</div>
 </dd>
         <dt id="doAwesomeStuff" class="callable inherited">
@@ -210,7 +210,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Takes a <code>value</code> and returns a String.</p>
+          Takes a <code>value</code> and returns a String.
           <div class="features">inherited</div>
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -219,7 +219,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -228,7 +228,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -243,7 +243,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/SuperAwesomeClass-class.html b/testing/test_package_docs/fake/SuperAwesomeClass-class.html
index 7689290..e277ad2 100644
--- a/testing/test_package_docs/fake/SuperAwesomeClass-class.html
+++ b/testing/test_package_docs/fake/SuperAwesomeClass-class.html
@@ -157,7 +157,7 @@
           <span class="name"><a href="fake/SuperAwesomeClass/SuperAwesomeClass.html">SuperAwesomeClass</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -172,7 +172,7 @@
           </span>
         </dt>
         <dd>
-          <p>In the super class.</p>
+          In the super class.
           <div class="features">read / write</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -180,7 +180,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -188,7 +188,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -203,7 +203,7 @@
           </span>
         </dt>
         <dd>
-          <p>In the super class.</p>
+          In the super class.
           
 </dd>
         <dt id="noSuchMethod" class="callable inherited">
@@ -212,7 +212,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -221,7 +221,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -236,7 +236,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="operator ==" class="callable inherited">
@@ -245,7 +245,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/WithGetterAndSetter-class.html b/testing/test_package_docs/fake/WithGetterAndSetter-class.html
index 8096a2b..2916774 100644
--- a/testing/test_package_docs/fake/WithGetterAndSetter-class.html
+++ b/testing/test_package_docs/fake/WithGetterAndSetter-class.html
@@ -153,7 +153,7 @@
           <span class="name"><a href="fake/WithGetterAndSetter/WithGetterAndSetter.html">WithGetterAndSetter</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -168,7 +168,7 @@
           </span>
         </dt>
         <dd>
-          <p>Returns a length.</p>
+          Returns a length.
           <div class="features">read / write</div>
 </dd>
         <dt id="hashCode" class="property inherited">
@@ -176,7 +176,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -184,7 +184,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -199,7 +199,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -208,7 +208,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -223,7 +223,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/fake/fake-library.html b/testing/test_package_docs/fake/fake-library.html
index db5c934..61e2a2f 100644
--- a/testing/test_package_docs/fake/fake-library.html
+++ b/testing/test_package_docs/fake/fake-library.html
@@ -94,123 +94,123 @@
           <span class="name "><a href="fake/Annotation-class.html">Annotation</a></span>
         </dt>
         <dd>
-          <p>Useful for annotations.</p>
+          Useful for annotations.
         </dd>
         <dt id="AnotherInterface">
           <span class="name "><a href="fake/AnotherInterface-class.html">AnotherInterface</a></span>
         </dt>
         <dd>
-          <p>Yet another interface that can be implemented.</p>
+          Yet another interface that can be implemented.
         </dd>
         <dt id="BaseForDocComments">
           <span class="name "><a href="fake/BaseForDocComments-class.html">BaseForDocComments</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="ClassWithUnusualProperties">
           <span class="name "><a href="fake/ClassWithUnusualProperties-class.html">ClassWithUnusualProperties</a></span>
         </dt>
         <dd>
-          <p>Classes with unusual properties?  I don't think they exist.</p>
+          Classes with unusual properties?  I don't think they exist.
         </dd>
         <dt id="ConstantClass">
           <span class="name "><a href="fake/ConstantClass-class.html">ConstantClass</a></span>
         </dt>
         <dd>
-          <p>For make-better testing of constants.</p>
+          For make-better testing of constants.
         </dd>
         <dt id="Cool">
           <span class="name "><a href="fake/Cool-class.html">Cool</a></span>
         </dt>
         <dd>
-          <p>This class is cool!</p>
+          This class is cool!
         </dd>
         <dt id="ExtraSpecialList">
           <span class="name "><a href="fake/ExtraSpecialList-class.html">ExtraSpecialList</a></span>
         </dt>
         <dd>
-          <p>This inherits operators.</p>
+          This inherits operators.
         </dd>
         <dt id="Foo2">
           <span class="name "><a href="fake/Foo2-class.html">Foo2</a></span>
         </dt>
         <dd>
-          <p>link to method from class <a href="ex/Apple/m.html">Apple.m</a></p>
+          link to method from class <a href="ex/Apple/m.html">Apple.m</a>
         </dd>
         <dt id="HasGenerics">
           <span class="name "><a href="fake/HasGenerics-class.html">HasGenerics</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="HasGenericWithExtends">
           <span class="name "><a href="fake/HasGenericWithExtends-class.html">HasGenericWithExtends</a></span>
         </dt>
         <dd>
-          <p>I have a generic and it extends <a href="fake/Foo2-class.html">Foo2</a></p>
+          I have a generic and it extends <a href="fake/Foo2-class.html">Foo2</a>
         </dd>
         <dt id="ImplicitProperties">
           <span class="name "><a href="fake/ImplicitProperties-class.html">ImplicitProperties</a></span>
         </dt>
         <dd>
-          <p>Names are actually wrong in this class, but when we extend it,
-they are correct.</p>
+          Names are actually wrong in this class, but when we extend it,
+they are correct.
         </dd>
         <dt id="Interface">
           <span class="name "><a href="fake/Interface-class.html">Interface</a></span>
         </dt>
         <dd>
-          <p>An interface that can be implemented.</p>
+          An interface that can be implemented.
         </dd>
         <dt id="LongFirstLine">
           <span class="name "><a href="fake/LongFirstLine-class.html">LongFirstLine</a></span>
         </dt>
         <dd>
-          <p>This is a very long line spread
-across... wait for it... two physical lines.</p>
+          This is a very long line spread
+across... wait for it... two physical lines.
         </dd>
         <dt id="MixMeIn">
           <span class="name "><a href="fake/MixMeIn-class.html">MixMeIn</a></span>
         </dt>
         <dd>
-          <p>Perfect for mix-ins.</p>
+          Perfect for mix-ins.
         </dd>
         <dt id="OperatorReferenceClass">
           <span class="name "><a href="fake/OperatorReferenceClass-class.html">OperatorReferenceClass</a></span>
         </dt>
         <dd>
-          <p>Test operator references: <a href="fake/OperatorReferenceClass/operator_equals.html">OperatorReferenceClass.==</a>.</p>
+          Test operator references: <a href="fake/OperatorReferenceClass/operator_equals.html">OperatorReferenceClass.==</a>.
         </dd>
         <dt id="OtherGenericsThing">
           <span class="name "><a href="fake/OtherGenericsThing-class.html">OtherGenericsThing</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="SpecialList">
           <span class="name "><a href="fake/SpecialList-class.html">SpecialList</a></span>
         </dt>
         <dd>
-          <p>Extends <code>ListBase</code></p>
+          Extends <code>ListBase</code>
         </dd>
         <dt id="SubForDocComments">
           <span class="name "><a href="fake/SubForDocComments-class.html">SubForDocComments</a></span>
         </dt>
         <dd>
-          <p>Testing if docs for inherited method are correct.</p>
+          Testing if docs for inherited method are correct.
         </dd>
         <dt id="SuperAwesomeClass">
           <span class="name deprecated"><a class="deprecated" href="fake/SuperAwesomeClass-class.html">SuperAwesomeClass</a></span>
         </dt>
         <dd>
-          <p>A super class, with many powers. Link to <a href="ex/Apple-class.html">Apple</a> from another library.</p>
+          A super class, with many powers. Link to <a href="ex/Apple-class.html">Apple</a> from another library.
         </dd>
         <dt id="WithGetterAndSetter">
           <span class="name "><a href="fake/WithGetterAndSetter-class.html">WithGetterAndSetter</a></span>
         </dt>
         <dd>
-          <p>Tests a single field with explict getter and setter.</p>
+          Tests a single field with explict getter and setter.
         </dd>
       </dl>
     </section>
@@ -224,7 +224,7 @@
           <span class="signature">&#8594; <a href="fake/ConstantClass-class.html">ConstantClass</a></span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>const <a href="fake/ConstantClass-class.html">ConstantClass</a>(&#39;custom&#39;)</code></span>
@@ -235,7 +235,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>Dynamic-typed down.</p>
+          Dynamic-typed down.
           
   <div>
             <span class="signature"><code>&#39;down&#39;</code></span>
@@ -246,7 +246,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>This is a great thing.</p>
+          This is a great thing.
           
   <div>
             <span class="signature"><code>&#39;great&#39;</code></span>
@@ -257,7 +257,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>This is the greatest thing.</p>
+          This is the greatest thing.
           
   <div>
             <span class="signature"><code>&#39;greatest&#39;</code></span>
@@ -268,7 +268,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>Referencing something that <code>doesn't exist</code>.</p>
+          Referencing something that <code>doesn't exist</code>.
           
   <div>
             <span class="signature"><code>&#39;doh&#39;</code></span>
@@ -279,7 +279,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>&#39;yay bug hunting&#39;</code></span>
@@ -290,7 +290,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>&#39;episode seven better be good; episode seven better be good; episode seven better be good; episode seven better be good&#39;</code></span>
@@ -301,7 +301,7 @@
           <span class="signature">&#8594; double</span>
         </dt>
         <dd>
-          <p>Constant property.</p>
+          Constant property.
           
   <div>
             <span class="signature"><code>3.14159</code></span>
@@ -312,7 +312,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p></p>
+          
           
   <div>
             <span class="signature"><code>&#39;required&#39;</code></span>
@@ -323,7 +323,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>These are code syntaxes: <code>true</code> and <code>false</code></p>
+          These are code syntaxes: <code>true</code> and <code>false</code>
           
   <div>
             <span class="signature"><code>&#39;fantastic&#39;</code></span>
@@ -334,7 +334,7 @@
           <span class="signature">&#8594; String</span>
         </dt>
         <dd>
-          <p>Up is a direction.</p>
+          Up is a direction.
           
   <div>
             <span class="signature"><code>&#39;up&#39;</code></span>
@@ -345,8 +345,8 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p>A constant integer value,
-which is a bit redundant.</p>
+          A constant integer value,
+which is a bit redundant.
           
   <div>
             <span class="signature"><code>0</code></span>
@@ -364,7 +364,7 @@
           <span class="signature">&#8594; dynamic</span>
         </dt>
         <dd>
-          <p>A dynamic getter.</p>
+          A dynamic getter.
           <div class="features">read-only</div>
 </dd>
         <dt id="justGetter" class="property">
@@ -372,7 +372,7 @@
           <span class="signature">&#8594; bool</span>
         </dt>
         <dd>
-          <p>Just a getter. No partner setter.</p>
+          Just a getter. No partner setter.
           <div class="features">read-only</div>
 </dd>
         <dt id="justSetter" class="property">
@@ -381,7 +381,7 @@
           </span>
         </dt>
         <dd>
-          <p>Just a setter. No partner getter.</p>
+          Just a setter. No partner getter.
           <div class="features">write-only</div>
 </dd>
         <dt id="mapWithDynamicKeys" class="property">
@@ -390,7 +390,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
         <dt id="meaningOfLife" class="property">
@@ -398,7 +398,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd>
-          <p>Final property.</p>
+          Final property.
           <div class="features">final</div>
 </dd>
         <dt id="setAndGet" class="property">
@@ -407,7 +407,7 @@
           </span>
         </dt>
         <dd>
-          <p>The getter for setAndGet.</p>
+          The getter for setAndGet.
           <div class="features">read / write</div>
 </dd>
         <dt id="simpleProperty" class="property">
@@ -416,7 +416,7 @@
           </span>
         </dt>
         <dd>
-          <p>Simple property</p>
+          Simple property
           <div class="features">read / write</div>
 </dd>
       </dl>
@@ -432,7 +432,7 @@
           </span>
         </dt>
         <dd>
-          <p>Adds a callback.</p>
+          Adds a callback.
           
 </dd>
         <dt id="addCallback2" class="callable">
@@ -441,7 +441,7 @@
           </span>
         </dt>
         <dd>
-          <p>Adds another callback.</p>
+          Adds another callback.
           
 </dd>
         <dt id="functionWithFunctionParameters" class="callable">
@@ -450,7 +450,7 @@
           </span>
         </dt>
         <dd>
-          <p>This function has two parameters that are functions.</p>
+          This function has two parameters that are functions.
           
 </dd>
         <dt id="myGenericFunction" class="callable">
@@ -459,7 +459,7 @@
           </span>
         </dt>
         <dd>
-          <p>A generic function with a type parameter.</p>
+          A generic function with a type parameter.
           
 </dd>
         <dt id="onlyPositionalWithNoDefaultNoType" class="callable">
@@ -468,7 +468,7 @@
           </span>
         </dt>
         <dd>
-          <p>A single optional positional param, no type annotation, no default value.</p>
+          A single optional positional param, no type annotation, no default value.
           <div class="features">@greatAnnotation</div>
 </dd>
         <dt id="paintImage1" class="callable">
@@ -477,7 +477,7 @@
           </span>
         </dt>
         <dd>
-          <p>Paints an image into the given rectangle in the canvas.</p>
+          Paints an image into the given rectangle in the canvas.
           
 </dd>
         <dt id="paintImage2" class="callable">
@@ -486,7 +486,7 @@
           </span>
         </dt>
         <dd>
-          <p>Paints an image into the given rectangle in the canvas.</p>
+          Paints an image into the given rectangle in the canvas.
           
 </dd>
         <dt id="paramFromAnotherLib" class="callable">
@@ -495,7 +495,7 @@
           </span>
         </dt>
         <dd>
-          <p><code>FooBar</code> comes from another library.</p>
+          <code>FooBar</code> comes from another library.
           
 </dd>
         <dt id="short" class="callable">
@@ -504,7 +504,7 @@
           </span>
         </dt>
         <dd>
-          <p>Testing <a href="fake/NAME_WITH_TWO_UNDERSCORES-constant.html">NAME_WITH_TWO_UNDERSCORES</a> should not be italicized.</p>
+          Testing <a href="fake/NAME_WITH_TWO_UNDERSCORES-constant.html">NAME_WITH_TWO_UNDERSCORES</a> should not be italicized.
           
 </dd>
         <dt id="soIntense" class="callable">
@@ -513,8 +513,8 @@
           </span>
         </dt>
         <dd>
-          <p>Top-level function with 1 param and 2 optional named params, 1 with a
-default value.</p>
+          Top-level function with 1 param and 2 optional named params, 1 with a
+default value.
           
 </dd>
         <dt id="thisIsAlsoAsync" class="callable">
@@ -523,7 +523,7 @@
           </span>
         </dt>
         <dd>
-          <p>Explicitly returns a Future and is marked async.</p>
+          Explicitly returns a Future and is marked async.
           
 </dd>
         <dt id="thisIsAsync" class="callable">
@@ -532,7 +532,7 @@
           </span>
         </dt>
         <dd>
-          <p>An async function. It should look like I return a <code>Future</code>.</p>
+          An async function. It should look like I return a <code>Future</code>.
           
 </dd>
         <dt id="topLevelFunction" class="callable">
@@ -541,7 +541,7 @@
           </span>
         </dt>
         <dd>
-          <p>Top-level function 3 params and 1 optional positional param.</p>
+          Top-level function 3 params and 1 optional positional param.
           
 </dd>
       </dl>
@@ -555,7 +555,7 @@
           <a href="fake/Color-class.html">Color</a>
         </dt>
         <dd>
-          <p>An <code>enum</code> for ROYGBIV constants.</p>
+          An <code>enum</code> for ROYGBIV constants.
         </dd>
       </dl>
     </section>
@@ -570,7 +570,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="FakeProcesses" class="callable">
@@ -579,7 +579,7 @@
           </span>
         </dt>
         <dd>
-          <p>Takes input, returns output.</p>
+          Takes input, returns output.
           
 </dd>
         <dt id="GenericTypedef" class="callable">
@@ -588,7 +588,7 @@
           </span>
         </dt>
         <dd>
-          <p>A typedef with a type parameter.</p>
+          A typedef with a type parameter.
           
 </dd>
         <dt id="LotsAndLotsOfParameters" class="callable">
@@ -597,7 +597,7 @@
           </span>
         </dt>
         <dd>
-          <p>Lots and lots of parameters.</p>
+          Lots and lots of parameters.
           
 </dd>
         <dt id="myCoolTypedef" class="callable">
@@ -606,7 +606,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
         <dt id="NewGenericTypedef" class="callable">
@@ -615,7 +615,7 @@
           </span>
         </dt>
         <dd>
-          <p>A typedef with the new style generic function syntax.</p>
+          A typedef with the new style generic function syntax.
           
 </dd>
         <dt id="VoidCallback" class="callable">
@@ -624,7 +624,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           
 </dd>
       </dl>
@@ -638,13 +638,13 @@
           <span class="name deprecated"><a class="deprecated" href="fake/Doh-class.html">Doh</a></span>
         </dt>
         <dd>
-          <p>Also, my bad.</p>
+          Also, my bad.
         </dd>
         <dt id="Oops">
           <span class="name "><a href="fake/Oops-class.html">Oops</a></span>
         </dt>
         <dd>
-          <p>My bad!</p>
+          My bad!
         </dd>
       </dl>
     </section>
diff --git a/testing/test_package_docs/index.html b/testing/test_package_docs/index.html
index 9abfda6..1800eab 100644
--- a/testing/test_package_docs/index.html
+++ b/testing/test_package_docs/index.html
@@ -86,59 +86,59 @@
               <span class="name"><a href="anonymous_library/anonymous_library-library.html">anonymous_library</a></span>
             </dt>
             <dd>
-              <p></p>
+              
             </dd>
             <dt id="another_anonymous_lib">
               <span class="name"><a href="another_anonymous_lib/another_anonymous_lib-library.html">another_anonymous_lib</a></span>
             </dt>
             <dd>
-              <p></p>
+              
             </dd>
             <dt id="code_in_comments">
               <span class="name"><a href="code_in_comments/code_in_comments-library.html">code_in_comments</a></span>
             </dt>
             <dd>
-              <p><code class="language-dart">void main() {
+              <code class="language-dart">void main() {
   // in Dart!
 }
-</code></p>
+</code>
             </dd>
             <dt id="css">
               <span class="name"><a href="css/css-library.html">css</a></span>
             </dt>
             <dd>
-              <p>Testing that a library name doesn't conflict
-with directories created by dartdoc.</p>
+              Testing that a library name doesn't conflict
+with directories created by dartdoc.
             </dd>
             <dt id="ex">
               <span class="name"><a href="ex/ex-library.html">ex</a></span>
             </dt>
             <dd>
-              <p>a library. testing string escaping: <code>var s = 'a string'</code> <cool></cool></p>
+              a library. testing string escaping: <code>var s = 'a string'</code> <cool></cool>
             </dd>
             <dt id="fake">
               <span class="name"><a href="fake/fake-library.html">fake</a></span>
             </dt>
             <dd>
-              <p>WOW FAKE PACKAGE IS <strong>BEST</strong> <a href="http://example.org">PACKAGE</a></p>
+              WOW FAKE PACKAGE IS <strong>BEST</strong> <a href="http://example.org">PACKAGE</a>
             </dd>
             <dt id="is_deprecated">
               <span class="name"><a class="deprecated" href="is_deprecated/is_deprecated-library.html">is_deprecated</a></span>
             </dt>
             <dd>
-              <p>This lib is deprecated. It never had a chance</p>
+              This lib is deprecated. It never had a chance
             </dd>
             <dt id="test_package_imported.main">
               <span class="name"><a href="test_package_imported.main/test_package_imported.main-library.html">test_package_imported.main</a></span>
             </dt>
             <dd>
-              <p></p>
+              
             </dd>
             <dt id="two_exports">
               <span class="name"><a href="two_exports/two_exports-library.html">two_exports</a></span>
             </dt>
             <dd>
-              <p></p>
+              
             </dd>
         </dl>
       </section>
diff --git a/testing/test_package_docs/test_package_imported.main/Whataclass-class.html b/testing/test_package_docs/test_package_imported.main/Whataclass-class.html
index 8e379c9..71c75b8 100644
--- a/testing/test_package_docs/test_package_imported.main/Whataclass-class.html
+++ b/testing/test_package_docs/test_package_imported.main/Whataclass-class.html
@@ -75,7 +75,7 @@
           <span class="name"><a href="test_package_imported.main/Whataclass/Whataclass.html">Whataclass</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -89,7 +89,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -97,7 +97,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -112,7 +112,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -121,7 +121,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -136,7 +136,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/test_package_imported.main/Whataclass2-class.html b/testing/test_package_docs/test_package_imported.main/Whataclass2-class.html
index b7c0baf..6dfc74b 100644
--- a/testing/test_package_docs/test_package_imported.main/Whataclass2-class.html
+++ b/testing/test_package_docs/test_package_imported.main/Whataclass2-class.html
@@ -75,7 +75,7 @@
           <span class="name"><a href="test_package_imported.main/Whataclass2/Whataclass2.html">Whataclass2</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -89,7 +89,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -97,7 +97,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -112,7 +112,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -121,7 +121,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -136,7 +136,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/test_package_imported.main/test_package_imported.main-library.html b/testing/test_package_docs/test_package_imported.main/test_package_imported.main-library.html
index 35725b1..66f65a1 100644
--- a/testing/test_package_docs/test_package_imported.main/test_package_imported.main-library.html
+++ b/testing/test_package_docs/test_package_imported.main/test_package_imported.main-library.html
@@ -72,13 +72,13 @@
           <span class="name "><a href="test_package_imported.main/Whataclass-class.html">Whataclass</a></span>
         </dt>
         <dd>
-          <p>Some docs for whataclass</p>
+          Some docs for whataclass
         </dd>
         <dt id="Whataclass2">
           <span class="name "><a href="test_package_imported.main/Whataclass2-class.html">Whataclass2</a></span>
         </dt>
         <dd>
-          <p>Some docs for whataclass 2</p>
+          Some docs for whataclass 2
         </dd>
       </dl>
     </section>
diff --git a/testing/test_package_docs/two_exports/BaseClass-class.html b/testing/test_package_docs/two_exports/BaseClass-class.html
index 215ea86..480eaf6 100644
--- a/testing/test_package_docs/two_exports/BaseClass-class.html
+++ b/testing/test_package_docs/two_exports/BaseClass-class.html
@@ -92,7 +92,7 @@
           <span class="name"><a href="two_exports/BaseClass/BaseClass.html">BaseClass</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -106,7 +106,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="lengthX" class="property inherited">
@@ -115,7 +115,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a length.</p>
+          Returns a length.
           <div class="features">read / write, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -123,7 +123,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -138,7 +138,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -147,7 +147,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -162,7 +162,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/two_exports/ExtendingClass-class.html b/testing/test_package_docs/two_exports/ExtendingClass-class.html
index 5ecf1da..685bcba 100644
--- a/testing/test_package_docs/two_exports/ExtendingClass-class.html
+++ b/testing/test_package_docs/two_exports/ExtendingClass-class.html
@@ -94,7 +94,7 @@
           <span class="name"><a href="two_exports/ExtendingClass/ExtendingClass.html">ExtendingClass</a></span><span class="signature">()</span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
       </dl>
     </section>
@@ -108,7 +108,7 @@
           <span class="signature">&#8594; int</span>
         </dt>
         <dd class="inherited">
-          <p>The hash code for this object.</p>
+          The hash code for this object.
           <div class="features">read-only, inherited</div>
 </dd>
         <dt id="lengthX" class="property inherited">
@@ -117,7 +117,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a length.</p>
+          Returns a length.
           <div class="features">read / write, inherited</div>
 </dd>
         <dt id="runtimeType" class="property inherited">
@@ -125,7 +125,7 @@
           <span class="signature">&#8594; Type</span>
         </dt>
         <dd class="inherited">
-          <p>A representation of the runtime type of the object.</p>
+          A representation of the runtime type of the object.
           <div class="features">read-only, inherited</div>
 </dd>
       </dl>
@@ -140,7 +140,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Invoked when a non-existent method or property is accessed.</p>
+          Invoked when a non-existent method or property is accessed.
           <div class="features">inherited</div>
 </dd>
         <dt id="toString" class="callable inherited">
@@ -149,7 +149,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>Returns a string representation of this object.</p>
+          Returns a string representation of this object.
           <div class="features">inherited</div>
 </dd>
       </dl>
@@ -164,7 +164,7 @@
           </span>
         </dt>
         <dd class="inherited">
-          <p>The equality operator.</p>
+          The equality operator.
           <div class="features">inherited</div>
 </dd>
       </dl>
diff --git a/testing/test_package_docs/two_exports/two_exports-library.html b/testing/test_package_docs/two_exports/two_exports-library.html
index dba361a..e9a9b4a 100644
--- a/testing/test_package_docs/two_exports/two_exports-library.html
+++ b/testing/test_package_docs/two_exports/two_exports-library.html
@@ -72,13 +72,13 @@
           <span class="name "><a href="two_exports/BaseClass-class.html">BaseClass</a></span>
         </dt>
         <dd>
-          <p></p>
+          
         </dd>
         <dt id="ExtendingClass">
           <span class="name "><a href="two_exports/ExtendingClass-class.html">ExtendingClass</a></span>
         </dt>
         <dd>
-          <p>Extending class extends <a href="two_exports/BaseClass-class.html">BaseClass</a>.</p>
+          Extending class extends <a href="two_exports/BaseClass-class.html">BaseClass</a>.
         </dd>
       </dl>
     </section>
@@ -94,7 +94,7 @@
           </span>
         </dt>
         <dd>
-          <p></p>
+          
           <div class="features">read / write</div>
 </dd>
       </dl>