Info parent is not always namespace

#refactor

Author: alandefreitas

docs/modules/ROOT/pages/generators.adoc

@@ -161,13 +161,13 @@ The `Symbol` object represents a symbol extracted from the source code.The symbo
 | `string`
 | Whether the symbol was implicitly extracted as a dependency.
 
-| `namespace`
+| `parents`
 | `<<symbol-fields,Symbol Object[]>>`
-| The namespaces of the symbol.
+| The parent contexts (namespaces or records) of the symbol.
 
 | `parent`
 | `<<symbol-fields,Symbol Object>>`
-| The parent namespace of the symbol.
+| The parent context (namespace or record) of the symbol.
 
 | `doc`
 | `Any`

include/mrdocs/Corpus.hpp

@@ -247,9 +247,9 @@ traverseOverloads(
     for(const SymbolID& id : S.Members)
     {
         const Info& member = get(id);
-        const auto& lookup = S.Lookups.at(member.Name);
+        const auto& members = S.Lookups.at(member.Name);
         auto first_func = std::ranges::find_if(
-            lookup, [this](const SymbolID& elem)
+            members, [this](const SymbolID& elem)
             {
             #if 0
                 const Info& I = get(elem);
@@ -258,19 +258,20 @@ traverseOverloads(
                 return get(elem).isFunction();
             #endif
             });
-        bool const nonOverloadedFunction = lookup.size() == 1;
-        bool const notFunction = first_func == lookup.end();
-        if(nonOverloadedFunction ||
-           notFunction)
+        bool const nonOverloadedFunction = members.size() == 1;
+        bool const notFunction = first_func == members.end();
+        if (nonOverloadedFunction ||
+            notFunction)
         {
             visit(member, std::forward<F>(f),
                 std::forward<Args>(args)...);
         }
-        else if(*first_func == id)
+        else if (*first_func == id)
         {
-            OverloadSet overloads(member.Name,
-                member.Namespace.front(),
-                member.Namespace, lookup);
+            OverloadSet overloads(
+                member.Name,
+                member.Parent,
+                members);
             visit(overloads, std::forward<F>(f),
                 std::forward<Args>(args)...);
         }
@@ -344,6 +345,12 @@ class Corpus::iterator
     }
 };
 
+/** Return a list of the parent symbols of the specified Info.
+ */
+MRDOCS_DECL
+std::vector<SymbolID>
+getParents(Corpus const& C, Info const& I);
+
 } // mrdocs
 } // clang
 

include/mrdocs/Metadata/Info.hpp

@@ -100,9 +100,12 @@ struct MRDOCS_VISIBLE
     */
     bool Implicit = false;
 
-    /** Ordered list of parent namespaces.
+    /** The parent symbol, if any.
+
+        This is the parent namespace or record
+        where the symbol is defined.
      */
-    std::vector<SymbolID> Namespace;
+    SymbolID Parent;
 
     /** The extracted javadoc for this declaration.
      */
@@ -225,7 +228,6 @@ tag_invoke(
     Info const& I,
     DomCorpus const* domCorpus);
 
-
 } // mrdocs
 } // clang
 

include/mrdocs/Metadata/Overloads.hpp

@@ -45,9 +45,6 @@ struct OverloadSet
     /// The parent symbol ID.
     SymbolID Parent;
 
-    /// The namespace of the overload set.
-    std::span<const SymbolID> Namespace;
-
     /// The members of the overload set.
     std::span<const SymbolID> Members;
 
@@ -62,11 +59,9 @@ struct OverloadSet
     OverloadSet(
         std::string_view name,
         const SymbolID& parent,
-        std::span<const SymbolID> ns,
         std::span<const SymbolID> members)
         : Name(name)
         , Parent(parent)
-        , Namespace(ns)
         , Members(members)
     {
     }

share/mrdocs/addons/generator/common/partials/symbol/qualified-name.hbs

@@ -20,8 +20,8 @@
 {{! We remove whitespace between all tag so the result is in a single line ~}}
 {{~#if (ne kind "friend")~}}
     {{~#if name~}}
-        {{! General case: linked namespaces followed by the symbol name ~}}
-        {{#each (reverse namespace)~}}
+        {{! General case: linked parent symbols followed by the symbol name ~}}
+        {{#each parents~}}
             {{#if name~}}
                 {{>symbol/name . link=. nolink=../nolink}}::
             {{~/if}}