[FOLD] add generator support

Author: sdkrystian

share/mrdocs/addons/generator/adoc/partials/symbol.adoc.hbs

@@ -68,6 +68,11 @@
 {{#if symbol.usingDirectives}}
 {{>symbol/members-table members=symbol.usingDirectives title="Using Directives"}}
 
+{{/if}}
+{{! Related symbols }}
+{{#if symbol.doc.related}}
+{{>symbol/members-table members=symbol.doc.related title="Related functions"}}
+
 {{/if}}
 {{! Description }}
 {{#if symbol.doc.description}}
@@ -174,13 +179,3 @@
 {{/each}}
 
 {{/if}}
-{{! Related }}
-{{#if symbol.doc.related}}
-{{#> markup/dynamic-level-h }}Related{{/markup/dynamic-level-h}}
-
-{{#each symbol.doc.related}}
-{{{.}}}
-
-{{/each}}
-
-{{/if}}

src/lib/Gen/adoc/DocVisitor.cpp

@@ -287,6 +287,9 @@ void
 DocVisitor::
 operator()(doc::Reference const& I) const
 {
+    if (I.Kind == doc::NodeKind::related)
+        return;
+
     if (I.id == SymbolID::invalid)
     {
         return (*this)(static_cast<doc::Text const&>(I));

src/lib/Gen/html/DocVisitor.cpp

@@ -285,6 +285,9 @@ void
 DocVisitor::
 operator()(doc::Reference const& I) const
 {
+    if (I.Kind == doc::NodeKind::related)
+        return;
+
     if (I.id == SymbolID::invalid)
     {
         return (*this)(static_cast<doc::Text const&>(I));

src/lib/Gen/xml/XMLWriter.cpp

@@ -785,6 +785,9 @@ writeNode(doc::Node const& node)
     case doc::NodeKind::copied:
         writeCopied(dynamic_cast<doc::Copied const&>(node));
         break;
+    case doc::NodeKind::related:
+        writeRelated(dynamic_cast<doc::Related const&>(node));
+        break;
     case doc::NodeKind::throws:
         writeThrows(dynamic_cast<doc::Throws const&>(node));
         break;
@@ -841,6 +844,16 @@ writeCopied(
         });
 }
 
+void
+XMLWriter::
+writeRelated(
+    doc::Related const& node)
+{
+    tags_.write("relates", node.string, {
+        { node.id }
+        });
+}
+
 void
 XMLWriter::
 writeLink(

src/lib/Gen/xml/XMLWriter.hpp

@@ -89,6 +89,7 @@ class XMLWriter
     void writeTParam(doc::TParam const& node);
     void writeReference(doc::Reference const& node);
     void writeCopied(doc::Copied const& node);
+    void writeRelated(doc::Related const& node);
     void writeThrows(doc::Throws const& node);
     void writeDetails(doc::Details const& node, llvm::StringRef tag = "");
     void writeSee(doc::See const& node, llvm::StringRef tag = "");

test-files/golden-tests/javadoc/relates/relates.cpp

@@ -0,0 +1,13 @@
+/** A brief for A.
+*/
+struct A { };
+
+/** A brief for B
+*/
+struct B { };
+
+/** A brief for f.
+
+    @relates A
+*/
+void f();