From: Vladimír Vondruš <mosra@centrum.cz>
Date: Sat, 14 Sep 2024 23:46:59 +0000 (+0200)
Subject: documentation/doxygen: properly escape HTML <>s in a test.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=b56cad3b4b50da5968b9462e4b9d128c57cd4fdb;p=blog.git

documentation/doxygen: properly escape HTML <>s in a test.

This was making Doxygen 1.10 + 1.11 fail parsing the link title,
substituting for an empty text. Funnily enough 1.12 doesn't suffer from
that anymore, which is what made me think that was a Doxygen bug and not
mine. Well it still *is* a Doxygen bug, but at least now I can have
consistent output everywhere.
---

diff --git a/documentation/test_doxygen/contents_typography/input.dox b/documentation/test_doxygen/contents_typography/input.dox
index 29c0cb80..bfc2bee3 100644
--- a/documentation/test_doxygen/contents_typography/input.dox
+++ b/documentation/test_doxygen/contents_typography/input.dox
@@ -33,7 +33,7 @@ This is a `typewriter text`, *emphasis*, **bold**. <em>Emphasis with
 and [URL](http://google.com). <small>Small *text*.</small> En-dash -- and
 em-dash ---. Reference to a @ref section. Named reference with special
 characters in title: @ref section "&raquo; Warnings &laquo;". Reference with
-escaped characters in&nbsp;title: @ref an-anchor "<anchor>".
+escaped characters in&nbsp;title: @ref an-anchor "&lt;anchor&gt;".
 
 2<sup>nd</sup> is L<sub>&infin;</sub> &forall; &nabla; &pi; &real; &image;
 This costs no $, &euro;, &pound;, &yen; or &curren;.