From: Vladimír Vondruš <mosra@centrum.cz>
Date: Thu, 14 Dec 2017 19:44:49 +0000 (+0100)
Subject: doc++
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=a3af9828f6bbe78da037ffd2ef2b7653172f83c5;p=blog.git

doc++
---

diff --git a/doc/doxygen.rst b/doc/doxygen.rst
index b3914771..61877557 100644
--- a/doc/doxygen.rst
+++ b/doc/doxygen.rst
@@ -518,7 +518,9 @@ aliases in the original ``Doxyfile``:
 
     It's not possible to use inline code highlighting in ``@brief``
     description. Code placed there is moved by Doxygen to the detailed
-    description.
+    description. Similarly, it's not possible to use it in an ``@xrefitem``
+    (``@todo``, ``@bug``...) paragraph --- code placed there is moved to a
+    paragraph after (but it works as expected for ``@note`` and similar).
 
     It's not possible to put a ``@code`` block (delimited by blank lines) to a
     Markdown list. A workaround is to use explicit HTML markup instead. See