From eded8006fd7ae58d51dcc05f56978c31a7a4f139 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Vladim=C3=ADr=20Vondru=C5=A1?= <mosra@centrum.cz>
Date: Thu, 14 Dec 2017 22:40:50 +0100
Subject: [PATCH] doxygen: link text can contain nested elements.

---
 doxygen/dox2html5.py                        | 2 +-
 doxygen/test/contents_typography/index.html | 2 +-
 doxygen/test/contents_typography/input.dox  | 4 +++-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/doxygen/dox2html5.py b/doxygen/dox2html5.py
index 378d7dff..261a2442 100755
--- a/doxygen/dox2html5.py
+++ b/doxygen/dox2html5.py
@@ -105,7 +105,7 @@ def parse_ref(state: State, element: ET.Element) -> str:
     else:
         class_ = 'm-dox'
 
-    return '<a href="{}" class="{}">{}</a>'.format(url, class_, add_wbr(html.escape(element.text)))
+    return '<a href="{}" class="{}">{}</a>'.format(url, class_, add_wbr(parse_inline_desc(state, element).strip()))
 
 def extract_id(element: ET.Element) -> str:
     id = element.attrib['id']
diff --git a/doxygen/test/contents_typography/index.html b/doxygen/test/contents_typography/index.html
index 960cf0a2..c9fcfe7a 100644
--- a/doxygen/test/contents_typography/index.html
+++ b/doxygen/test/contents_typography/index.html
@@ -38,7 +38,7 @@
           My Project
         </h1>
 <section id="section"><h2><a href="#section">Page section</a></h2><blockquote><p>A blockquote.</p></blockquote><pre class="m-code">Preformatted text.
-</pre><p>Paragraph<br />with<br />explicit<br />line<br />breaks.</p><section id="subsection"><h3><a href="#subsection">Page subsection</a></h3><ul><li>Unordered</li><li>list</li><li>of<ul><li>nested</li><li>items</li></ul></li><li>and back</li></ul><section id="subsubsection"><h4><a href="#subsubsection">Sub-sub section</a></h4><ol><li>Ordered</li><li>list</li><li>of<ol><li>nested</li><li>items</li></ol></li><li>and back</li></ol><p><a name="an-anchor"></a> This is a <code>typewriter text</code>, <em>emphasis</em> and <strong>bold</strong>. <em>Emphasis with <code>typewriter</code> and <strong>bold</strong> nested.</em> <a href="http://google.com">http:/<wbr />/<wbr />google.com</a> and <a href="http://google.com">URL</a>. En-dash &ndash; and em-dash &mdash;. Reference to a <a href="index.html#subsection" class="m-dox">Page subsection</a>.</p></section></section></section>
+</pre><p>Paragraph<br />with<br />explicit<br />line<br />breaks.</p><section id="subsection"><h3><a href="#subsection">Page subsection</a></h3><ul><li>Unordered</li><li>list</li><li>of<ul><li>nested</li><li>items</li></ul></li><li>and back</li></ul><section id="subsubsection"><h4><a href="#subsubsection">Sub-sub section</a></h4><ol><li>Ordered</li><li>list</li><li>of<ol><li>nested</li><li>items</li></ol></li><li>and back</li></ol><p><a name="an-anchor"></a> This is a <code>typewriter text</code>, <em>emphasis</em> and <strong>bold</strong>. <em>Emphasis with <code>typewriter</code> and <strong>bold</strong> nested.</em> <a href="http://google.com">http:/<wbr />/<wbr />google.com</a> and <a href="http://google.com">URL</a>. En-dash &ndash; and em-dash &mdash;. Reference to a <a href="index.html#subsection" class="m-dox">Page subsection</a>. Named reference with special characters in title: <a href="warnings.html" class="m-dox">&raquo; Warnings &laquo;</a>. Reference with escaped characters in title: <a href="index.html#an-anchor" class="m-dox">&lt;anchor&gt;</a>.</p></section></section></section>
       </div>
     </div>
   </div>
diff --git a/doxygen/test/contents_typography/input.dox b/doxygen/test/contents_typography/input.dox
index 8d8e6c4e..32035291 100644
--- a/doxygen/test/contents_typography/input.dox
+++ b/doxygen/test/contents_typography/input.dox
@@ -31,7 +31,9 @@ Paragraph \n with \n explicit \n line \n breaks.
 This is a `typewriter text`, *emphasis* and **bold**. <em>Emphasis with
 <tt>typewriter</tt> and <strong>bold</strong> nested.</em> http://google.com
 and [URL](http://google.com). En-dash -- and em-dash ---. Reference to a
-@ref subsection.
+@ref subsection. Named reference with special characters in title:
+@ref warnings "&raquo; Warnings &laquo;". Reference with escaped characters in
+title: @ref an-anchor "<anchor>".
 
 */
 
-- 
2.30.2