feat: AsciiDoc and HTML outputs don't show the final specifier in a comment

This makes `final` appear in normal code (rather than a comment), but
omits the semicolon to avoid showing an incorrect code fragment.

Author: Gennaro Prota

share/mrdocs/addons/generator/common/partials/symbol/signature/record.hbs

@@ -17,4 +17,7 @@
     {{#unless (eq access ../defaultAccess)}} {{access}}{{/unless~}}
     {{#if isVirtual}} virtual{{/if}} {{>type/declarator type~}}
 {{/each~}}
-{{/unless}}{{#isSeeBelow}} { /* see-below */ }{{/isSeeBelow}};{{#if isFinal}} /* final */{{/if}}
+{{!-- Don't show a semicolon if the record is final, because something
+      like `class A final;` is ill-formed (`final` can't be used on a
+      non-defining declaration). --}}
+{{/unless}}{{#isSeeBelow}} { /* see-below */ }{{/isSeeBelow}}{{#if isFinal}} final{{else}};{{/if}}

test-files/golden-tests/symbols/record/final_class.adoc

@@ -22,7 +22,7 @@ Declared in `<final_class.cpp>`
 
 [source,cpp,subs="verbatim,replacements,macros,-callouts"]
 ----
-class A; /* final */
+class A final
 ----
 
 [#B]
@@ -35,7 +35,7 @@ Declared in `<final_class.cpp>`
 [source,cpp,subs="verbatim,replacements,macros,-callouts"]
 ----
 template<typename T>
-class B; /* final */
+class B final
 ----
 
 

test-files/golden-tests/symbols/record/final_class.html

@@ -34,7 +34,7 @@ <h3>Synopsis</h3>
 Declared in <code>&lt;final_class.cpp&gt;</code></div>
 <pre>
 <code class="source-code cpp">
-class A; /* final */
+class A final
 </code>
 </pre>
 </div>
@@ -52,7 +52,7 @@ <h3>Synopsis</h3>
 <pre>
 <code class="source-code cpp">
 template&lt;typename T&gt;
-class B; /* final */
+class B final
 </code>
 </pre>
 </div>