[clang-tools-extra] [Clang-doc] Display enum comments in HTML (PR #183085)

[Erick Velez via cfe-commits]

================
@@ -152,27 +186,44 @@ enum Size : uint8_t {
 // HTML-INDEX-NEXT:             <tr>
 // HTML-INDEX-NEXT:                 <th>Name</th>
 // HTML-INDEX-NEXT:                 <th>Value</th>
+// HTML-INDEX-NEXT:                 <th>Comments</th>
 // HTML-INDEX-NEXT:             </tr>
 // HTML-INDEX-NEXT:             <tr>
 // HTML-INDEX-NEXT:                 <td>Small</td>
 // HTML-INDEX-NEXT:                 <td>0</td>
+// HTML-INDEX-NEXT:                 <td><div class="nested-delimiter-container">
----------------
evelez7 wrote:

The same effect on a webpage should be able to be achieved via the first two sentences wrapped in their own paragraph tag i.e. `<p>A pearl. Pearls are quite small</p>`. Then, the sentence separated by a blank comment line its own paragraph tag. Right now we are putting multiple divs in a single table cell just to have the margin spacing given by the `nested-delimiter-container` class, which seems like a waste and adds unnecessary HTML tags. The separation of paragraphs seems like it can be solved with only paragraph tags or `<br>`.

https://github.com/llvm/llvm-project/pull/183085