diff --git a/share/mrdocs/addons/generator/adoc/partials/symbol.adoc.hbs b/share/mrdocs/addons/generator/adoc/partials/symbol.adoc.hbs
index 1f96b7516c..01181cfcb3 100644
--- a/share/mrdocs/addons/generator/adoc/partials/symbol.adoc.hbs
+++ b/share/mrdocs/addons/generator/adoc/partials/symbol.adoc.hbs
@@ -134,14 +134,25 @@
{{! Using symbols }}
{{#if symbol.shadows}}
{{#> markup/dynamic-level-h }}Introduced Symbols{{/markup/dynamic-level-h}}
+{{#if (any_of_by symbol.shadows "doc")}}
+[cols=2]
+|===
+| Name
+| Description
+{{#each symbol.shadows}}
+| {{> symbol/qualified-name . }}
+| {{> javadoc/inline-brief doc.brief }}
+{{/each}}
+|===
+{{else}}
[cols=1]
|===
| Name
{{#each symbol.shadows}}
-| {{name}}
+| {{> symbol/qualified-name . }}
{{/each}}
|===
-
+{{/if}}
{{/if}}
{{! Exceptions }}
{{#if symbol.doc.exceptions}}
diff --git a/share/mrdocs/addons/generator/html/partials/symbol.html.hbs b/share/mrdocs/addons/generator/html/partials/symbol.html.hbs
index 77b1dcc780..190dab3ae0 100644
--- a/share/mrdocs/addons/generator/html/partials/symbol.html.hbs
+++ b/share/mrdocs/addons/generator/html/partials/symbol.html.hbs
@@ -183,20 +183,39 @@
{{#if symbol.shadows}}
{{#> markup/dynamic-level-h level=2 }}Introduced Symbols{{/markup/dynamic-level-h}}
+{{#if (any_of_by symbol.shadows "doc")}}
| Name |
+Description |
{{#each symbol.shadows}}
-| {{name}} |
+{{> symbol/qualified-name . }} |
+{{> javadoc/inline-brief doc.brief }} |
{{/each}}
+{{else}}
+
+
+
+| Name |
+
+
+
+{{#each symbol.shadows}}
+
+| {{> symbol/qualified-name . }} |
+
+{{/each}}
+
+
+{{/if}}
{{/if}}
diff --git a/test-files/golden-tests/symbols/using/using-function-after.adoc b/test-files/golden-tests/symbols/using/using-function-after.adoc
index df57096c99..a99be5c38a 100644
--- a/test-files/golden-tests/symbols/using/using-function-after.adoc
+++ b/test-files/golden-tests/symbols/using/using-function-after.adoc
@@ -101,8 +101,7 @@ using A::f;
[cols=1]
|===
| Name
-| f
+| link:#A-f-01[A::f]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-function-after.html b/test-files/golden-tests/symbols/using/using-function-after.html
index 7dddf77c53..5faf5c4c7f 100644
--- a/test-files/golden-tests/symbols/using/using-function-after.html
+++ b/test-files/golden-tests/symbols/using/using-function-after.html
@@ -138,7 +138,7 @@ Introduced Symbols
-| f |
+A::f |
diff --git a/test-files/golden-tests/symbols/using/using-function-and-type.adoc b/test-files/golden-tests/symbols/using/using-function-and-type.adoc
index d9eb0be33a..5fc3e53a7f 100644
--- a/test-files/golden-tests/symbols/using/using-function-and-type.adoc
+++ b/test-files/golden-tests/symbols/using/using-function-and-type.adoc
@@ -122,9 +122,8 @@ using A::f;
[cols=1]
|===
| Name
-| f
-| f
+| link:#A-f-05[A::f]
+| link:#A-f-01[A::f]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-function-and-type.html b/test-files/golden-tests/symbols/using/using-function-and-type.html
index c967033ba9..2053fbee11 100644
--- a/test-files/golden-tests/symbols/using/using-function-and-type.html
+++ b/test-files/golden-tests/symbols/using/using-function-and-type.html
@@ -181,10 +181,10 @@ Introduced Symbols
-| f |
+A::f |
-| f |
+A::f |
diff --git a/test-files/golden-tests/symbols/using/using-function-excluded.adoc b/test-files/golden-tests/symbols/using/using-function-excluded.adoc
index 328778abc3..e7a2cf461b 100644
--- a/test-files/golden-tests/symbols/using/using-function-excluded.adoc
+++ b/test-files/golden-tests/symbols/using/using-function-excluded.adoc
@@ -61,8 +61,7 @@ using A::f;
[cols=1]
|===
| Name
-| f
+| link:#A-f[A::f]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-function-excluded.html b/test-files/golden-tests/symbols/using/using-function-excluded.html
index c348163f43..e213ffaef0 100644
--- a/test-files/golden-tests/symbols/using/using-function-excluded.html
+++ b/test-files/golden-tests/symbols/using/using-function-excluded.html
@@ -94,7 +94,7 @@ Introduced Symbols
-| f |
+A::f |
diff --git a/test-files/golden-tests/symbols/using/using-function-local-overloads.adoc b/test-files/golden-tests/symbols/using/using-function-local-overloads.adoc
index 3d13676a24..51e7c4b73c 100644
--- a/test-files/golden-tests/symbols/using/using-function-local-overloads.adoc
+++ b/test-files/golden-tests/symbols/using/using-function-local-overloads.adoc
@@ -148,10 +148,9 @@ using A::f;
[cols=1]
|===
| Name
-| f
-| f
-| f
+| link:#A-f-037[A::f]
+| link:#A-f-039[A::f]
+| link:#A-f-01[A::f]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-function-local-overloads.html b/test-files/golden-tests/symbols/using/using-function-local-overloads.html
index 55fdcc0a40..b4a76e57d2 100644
--- a/test-files/golden-tests/symbols/using/using-function-local-overloads.html
+++ b/test-files/golden-tests/symbols/using/using-function-local-overloads.html
@@ -195,13 +195,13 @@ Introduced Symbols
-| f |
+A::f |
-| f |
+A::f |
-| f |
+A::f |
diff --git a/test-files/golden-tests/symbols/using/using-function-overloads.adoc b/test-files/golden-tests/symbols/using/using-function-overloads.adoc
index 0f834b5836..91b1c4c966 100644
--- a/test-files/golden-tests/symbols/using/using-function-overloads.adoc
+++ b/test-files/golden-tests/symbols/using/using-function-overloads.adoc
@@ -127,10 +127,9 @@ using A::f;
[cols=1]
|===
| Name
-| f
-| f
-| f
+| link:#A-f-037[A::f]
+| link:#A-f-039[A::f]
+| link:#A-f-01[A::f]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-function-overloads.html b/test-files/golden-tests/symbols/using/using-function-overloads.html
index 06745aeddc..5bc89e394d 100644
--- a/test-files/golden-tests/symbols/using/using-function-overloads.html
+++ b/test-files/golden-tests/symbols/using/using-function-overloads.html
@@ -166,13 +166,13 @@ Introduced Symbols
-| f |
+A::f |
-| f |
+A::f |
-| f |
+A::f |
diff --git a/test-files/golden-tests/symbols/using/using-function.adoc b/test-files/golden-tests/symbols/using/using-function.adoc
index 8ebafde4f1..21040ec46c 100644
--- a/test-files/golden-tests/symbols/using/using-function.adoc
+++ b/test-files/golden-tests/symbols/using/using-function.adoc
@@ -27,15 +27,19 @@
=== Functions
-[cols=1]
+[cols=2]
|===
| Name
+| Description
| link:#A-f[`f`]
+| Function being used
|===
[#A-f]
== link:#A[A]::f
+Function being used
+
=== Synopsis
Declared in `<using‐function.cpp>`
@@ -62,11 +66,12 @@ using A::f;
=== Introduced Symbols
-[cols=1]
+[cols=2]
|===
| Name
-| f
+| Description
+| link:#A-f[A::f]
+| Function being used
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-function.cpp b/test-files/golden-tests/symbols/using/using-function.cpp
index 814c452b60..460a5616ca 100644
--- a/test-files/golden-tests/symbols/using/using-function.cpp
+++ b/test-files/golden-tests/symbols/using/using-function.cpp
@@ -1,5 +1,6 @@
namespace A
{
+ /// Function being used
void f(int);
}
diff --git a/test-files/golden-tests/symbols/using/using-function.html b/test-files/golden-tests/symbols/using/using-function.html
index 269c4555bf..01189d815d 100644
--- a/test-files/golden-tests/symbols/using/using-function.html
+++ b/test-files/golden-tests/symbols/using/using-function.html
@@ -46,11 +46,12 @@ Functions
| Name |
+Description |
-f |
+f | Function being used |
@@ -58,6 +59,10 @@ Functions
+
+Function being used
+
+
Synopsis
@@ -95,11 +100,13 @@
Introduced Symbols
| Name |
+Description |
-| f |
+A::f |
+Function being used |
diff --git a/test-files/golden-tests/symbols/using/using-function.xml b/test-files/golden-tests/symbols/using/using-function.xml
index 979bfa71a1..5c6347696c 100644
--- a/test-files/golden-tests/symbols/using/using-function.xml
+++ b/test-files/golden-tests/symbols/using/using-function.xml
@@ -4,14 +4,19 @@
-
+
+
+
+ Function being used
+
+
-
+
f is also available in the global namespace
diff --git a/test-files/golden-tests/symbols/using/using-member-function.adoc b/test-files/golden-tests/symbols/using/using-member-function.adoc
index f4765e791c..716f31477c 100644
--- a/test-files/golden-tests/symbols/using/using-member-function.adoc
+++ b/test-files/golden-tests/symbols/using/using-member-function.adoc
@@ -213,9 +213,8 @@ using A::f;
[cols=1]
|===
| Name
-| f
+| link:#A-f[A::f]
|===
-
[#C-f-03]
== link:#C[C]::f
@@ -233,8 +232,7 @@ using B::f;
[cols=1]
|===
| Name
-| f
+| link:#B-f[B::f]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-member-function.html b/test-files/golden-tests/symbols/using/using-member-function.html
index d6da52301c..73e77c1f97 100644
--- a/test-files/golden-tests/symbols/using/using-member-function.html
+++ b/test-files/golden-tests/symbols/using/using-member-function.html
@@ -292,7 +292,7 @@ Introduced Symbols
-| f |
+A::f |
@@ -323,7 +323,7 @@ Introduced Symbols
-| f |
+B::f |
diff --git a/test-files/golden-tests/symbols/using/using-multi.adoc b/test-files/golden-tests/symbols/using/using-multi.adoc
index b21855b692..0f321ab75c 100644
--- a/test-files/golden-tests/symbols/using/using-multi.adoc
+++ b/test-files/golden-tests/symbols/using/using-multi.adoc
@@ -76,9 +76,8 @@ using A::f;
[cols=1]
|===
| Name
-| f
+| link:#A-f[A::f]
|===
-
[#g]
== g
@@ -96,8 +95,7 @@ using A::g;
[cols=1]
|===
| Name
-| g
+| link:#A-g[A::g]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-multi.html b/test-files/golden-tests/symbols/using/using-multi.html
index 6a70615f0a..a5ca2ebd73 100644
--- a/test-files/golden-tests/symbols/using/using-multi.html
+++ b/test-files/golden-tests/symbols/using/using-multi.html
@@ -112,7 +112,7 @@ Introduced Symbols
-| f |
+A::f |
@@ -143,7 +143,7 @@ Introduced Symbols
-| g |
+A::g |
diff --git a/test-files/golden-tests/symbols/using/using-struct-template.adoc b/test-files/golden-tests/symbols/using/using-struct-template.adoc
index 436e850849..7756b326f6 100644
--- a/test-files/golden-tests/symbols/using/using-struct-template.adoc
+++ b/test-files/golden-tests/symbols/using/using-struct-template.adoc
@@ -74,9 +74,8 @@ using LongName::S1;
[cols=1]
|===
| Name
-| S1
+| link:#LongName-S1[LongName::S1]
|===
-
[#S2]
== S2
@@ -94,8 +93,7 @@ using LongName::S2;
[cols=1]
|===
| Name
-| S2
+| link:#LongName-S2[LongName::S2]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-struct-template.html b/test-files/golden-tests/symbols/using/using-struct-template.html
index 9ddd3b04e6..078502a6a8 100644
--- a/test-files/golden-tests/symbols/using/using-struct-template.html
+++ b/test-files/golden-tests/symbols/using/using-struct-template.html
@@ -114,7 +114,7 @@ Introduced Symbols
-| S1 |
+LongName::S1 |
@@ -145,7 +145,7 @@ Introduced Symbols
-| S2 |
+LongName::S2 |
diff --git a/test-files/golden-tests/symbols/using/using-struct.adoc b/test-files/golden-tests/symbols/using/using-struct.adoc
index da12a3bcab..e124a31c95 100644
--- a/test-files/golden-tests/symbols/using/using-struct.adoc
+++ b/test-files/golden-tests/symbols/using/using-struct.adoc
@@ -74,9 +74,8 @@ using LongName::S1;
[cols=1]
|===
| Name
-| S1
+| link:#LongName-S1[LongName::S1]
|===
-
[#S2]
== S2
@@ -94,8 +93,7 @@ using LongName::S2;
[cols=1]
|===
| Name
-| S2
+| link:#LongName-S2[LongName::S2]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-struct.html b/test-files/golden-tests/symbols/using/using-struct.html
index 83e4f278b6..8db40d6fe5 100644
--- a/test-files/golden-tests/symbols/using/using-struct.html
+++ b/test-files/golden-tests/symbols/using/using-struct.html
@@ -114,7 +114,7 @@ Introduced Symbols
-| S1 |
+LongName::S1 |
@@ -145,7 +145,7 @@ Introduced Symbols
-| S2 |
+LongName::S2 |
diff --git a/test-files/golden-tests/symbols/using/using-template-function.adoc b/test-files/golden-tests/symbols/using/using-template-function.adoc
index c97d3cde3d..3397258f59 100644
--- a/test-files/golden-tests/symbols/using/using-template-function.adoc
+++ b/test-files/golden-tests/symbols/using/using-template-function.adoc
@@ -61,8 +61,7 @@ using A::f;
[cols=1]
|===
| Name
-| f
+| link:#A-f[A::f]
|===
-
[.small]#Created with https://www.mrdocs.com[MrDocs]#
diff --git a/test-files/golden-tests/symbols/using/using-template-function.html b/test-files/golden-tests/symbols/using/using-template-function.html
index 47df000972..e62d4e0184 100644
--- a/test-files/golden-tests/symbols/using/using-template-function.html
+++ b/test-files/golden-tests/symbols/using/using-template-function.html
@@ -94,7 +94,7 @@ Introduced Symbols
-| f |
+A::f |