test: using declaration shadows only include previous declarations

Author: alandefreitas

test-files/golden-tests/symbols/using/using-function-after.adoc

@@ -14,10 +14,12 @@
 
 === Using Declarations
 
-[cols=1]
+[cols=2]
 |===
 | Name
+| Description
 | link:#f[`f`] 
+| f overloads are also available in the global namespace
 |===
 
 [#A]
@@ -30,16 +32,20 @@
 | Name
 | Description
 | link:#A-f-08[`f`] 
-| 
+| `f` overloads
 |===
 
 [#A-f-08]
 == link:#A[A]::f
 
+`f` overloads
+
 === Synopses
 
 Declared in `<using‐function‐after.cpp>`
 
+A non‐shadowing declaration
+
 
 [source,cpp,subs="verbatim,replacements,macros,-callouts"]
 ----
@@ -49,6 +55,8 @@ link:#A-f-00[f](char);
 
 [.small]#link:#A-f-00[_» more..._]#
 
+A shadow declaration
+
 
 [source,cpp,subs="verbatim,replacements,macros,-callouts"]
 ----
@@ -61,6 +69,8 @@ link:#A-f-01[f](int);
 [#A-f-00]
 == link:#A[A]::f
 
+A non‐shadowing declaration
+
 === Synopsis
 
 Declared in `<using‐function‐after.cpp>`
@@ -71,9 +81,17 @@ void
 f(char);
 ----
 
+=== Description
+
+This declaration is not part of the shadow declarations of the using directive because it comes after it.
+
+Only the declarations at the point of the using directive are considered for shadowing in the documentation.
+
 [#A-f-01]
 == link:#A[A]::f
 
+A shadow declaration
+
 === Synopsis
 
 Declared in `<using‐function‐after.cpp>`
@@ -87,6 +105,8 @@ f(int);
 [#f]
 == f
 
+f overloads are also available in the global namespace
+
 === Synopsis
 
 Declared in `<using‐function‐after.cpp>`
@@ -98,10 +118,12 @@ using A::f;
 
 === Introduced Symbols
 
-[cols=1]
+[cols=2]
 |===
 | Name
+| Description
 | link:#A-f-01[A::f]
+| A shadow declaration
 |===
 
 [.small]#Created with https://www.mrdocs.com[MrDocs]#

test-files/golden-tests/symbols/using/using-function-after.cpp

@@ -1,11 +1,25 @@
 namespace A
 {
+    /// A shadow declaration
     void f(int);
 }
 
+/// f overloads are also available in the global namespace
 using A::f;
 
 namespace A
 {
+    /** A non-shadowing declaration
+
+        This declaration is not part
+        of the shadow declarations
+        of the using directive because
+        it comes after it.
+
+        Only the declarations at
+        the point of the using directive
+        are considered for shadowing in the
+        documentation.
+     */
     void f(char);
 }

test-files/golden-tests/symbols/using/using-function-after.html

@@ -27,11 +27,12 @@ <h2>Using Declarations</h2>
 <thead>
 <tr>
 <th>Name</th>
+<th>Description</th>
 </tr>
 </thead>
 <tbody>
 <tr>
-<td><a href="#f"><code>f</code></a> </td></tr>
+<td><a href="#f"><code>f</code></a> </td><td><span>f overloads are also available in the global namespace</span></td></tr>
 </tbody>
 </table>
 
@@ -50,28 +51,32 @@ <h2>Functions</h2>
 </thead>
 <tbody>
 <tr>
-<td><a href="#A-f-08"><code>f</code></a> </td><td><span></span></td></tr>
+<td><a href="#A-f-08"><code>f</code></a> </td><td><span><code>f</code> overloads</span></td></tr>
 </tbody>
 </table>
 
 </div>
 <div>
 <div>
 <h2 id="A-f-08"><a href="#A-f-08">A::f</a></h2>
+<div>
+<span><code>f</code> overloads</span>
+
+</div>
 </div>
 <div>
 <h3>Synopses</h3>
 <div>
 Declared in <code>&lt;using-function-after.cpp&gt;</code></div>
-
+<span>A non-shadowing declaration</span>
 <pre>
 <code class="source-code cpp">
 void
 <a href="#A-f-00">f</a>(char);
 </code>
 </pre><span class="small"><a href="#A-f-00"><em>» more...</em></a></span>
 
-
+<span>A shadow declaration</span>
 <pre>
 <code class="source-code cpp">
 void
@@ -85,6 +90,10 @@ <h3>Synopses</h3>
 <div>
 <div>
 <h2 id="A-f-00"><a href="#A-f-00">A::f</a></h2>
+<div>
+<span>A non-shadowing declaration</span>
+
+</div>
 </div>
 <div>
 <h3>Synopsis</h3>
@@ -97,10 +106,19 @@ <h3>Synopsis</h3>
 </code>
 </pre>
 </div>
+<div>
+<h3>Description</h3>
+<p>This declaration is not part of the shadow declarations of the using directive because it comes after it.</p>
+<p>Only the declarations at the point of the using directive are considered for shadowing in the documentation.</p>
+</div>
 </div>
 <div>
 <div>
 <h2 id="A-f-01"><a href="#A-f-01">A::f</a></h2>
+<div>
+<span>A shadow declaration</span>
+
+</div>
 </div>
 <div>
 <h3>Synopsis</h3>
@@ -117,6 +135,10 @@ <h3>Synopsis</h3>
 <div>
 <div>
 <h2 id="f"><a href="#f">f</a></h2>
+<div>
+<span>f overloads are also available in the global namespace</span>
+
+</div>
 </div>
 <div>
 <h3>Synopsis</h3>
@@ -134,11 +156,13 @@ <h3>Introduced Symbols</h3>
 <thead>
 <tr>
 <th>Name</th>
+<th>Description</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td><a href="#A-f-01">A::f</a></td>
+<td><span>A shadow declaration</span></td>
 </tr>
 </tbody>
 </table>

test-files/golden-tests/symbols/using/using-function-after.xml

@@ -4,20 +4,41 @@
 <namespace id="//////////////////////////8=">
   <namespace name="A" id="jQQu/8mLNzRQvGtbkKMwwloVDpw=">
     <function name="f" id="Bt/dVoQvE7M4sJbKQH+g/hiv0Os=">
-      <file short-path="using-function-after.cpp" source-path="using-function-after.cpp" line="10"/>
+      <file short-path="using-function-after.cpp" source-path="using-function-after.cpp" line="24"/>
       <param>
         <type name="char"/>
       </param>
+      <doc>
+        <brief>
+          <text>A non-shadowing declaration</text>
+        </brief>
+        <para>
+          <text>This declaration is not part of the shadow declarations of the using directive because it comes after it.</text>
+        </para>
+        <para>
+          <text>Only the declarations at the point of the using directive are considered for shadowing in the documentation.</text>
+        </para>
+      </doc>
     </function>
     <function name="f" id="FuaTgMW0VtO+b4uzr/DCmx9vlb0=">
-      <file short-path="using-function-after.cpp" source-path="using-function-after.cpp" line="3"/>
+      <file short-path="using-function-after.cpp" source-path="using-function-after.cpp" line="4"/>
       <param>
         <type name="int"/>
       </param>
+      <doc>
+        <brief>
+          <text>A shadow declaration</text>
+        </brief>
+      </doc>
     </function>
   </namespace>
   <using id="FhSdC4kR2+KOxLCiCUQ9mu1WNoY=" class="using" qualifier="A::f">
-    <file short-path="using-function-after.cpp" source-path="using-function-after.cpp" line="6"/>
+    <file short-path="using-function-after.cpp" source-path="using-function-after.cpp" line="8"/>
+    <doc>
+      <brief>
+        <text>f overloads are also available in the global namespace</text>
+      </brief>
+    </doc>
     <named id="FuaTgMW0VtO+b4uzr/DCmx9vlb0="/>
   </using>
 </namespace>