From: Vladimír Vondruš Date: Sun, 15 Sep 2024 21:50:36 +0000 (+0200) Subject: doc: fix broken links and links that aren't links at all. X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=da23ed3e05920146f02bb26e6b213a478263e9b0;p=blog.git doc: fix broken links and links that aren't links at all. --- diff --git a/doc/documentation/doxygen.rst b/doc/documentation/doxygen.rst index 4c14d5c3..3e53d501 100644 --- a/doc/documentation/doxygen.rst +++ b/doc/documentation/doxygen.rst @@ -210,7 +210,7 @@ In addition to features `shared by all doc generators <{filename}/documentation. This list presents my opinions. Not everybody likes my opinions. -The theme is deliberately *only* for C and C++. See the `Python documentation generator <{filename}/python.rst>`__ +The theme is deliberately *only* for C and C++. See the `Python documentation generator <{filename}python.rst>`__ for a dedicated tool handling Python. Other languages such as C# or Java would be also better handled using dedicated tools that can make use of reflection features built into the language itself instead of attempting to (badly) parse @@ -454,19 +454,19 @@ Variable Description not set, ``m.math.cache`` file in the output directory is used. Equivalent to an option of the same name in the - `m.math plugin <{filename}/plugins/math-and-code.rst#math>`. + `m.math plugin <{filename}/plugins/math-and-code.rst#math>`_. :py:`M_MATH_RENDER_AS_CODE` Don't invoke LaTex and render math as inline code and code blocks. Equivalent to an option of the same name in the - `m.math plugin <{filename}/plugins/math-and-code.rst#math>`. + `m.math plugin <{filename}/plugins/math-and-code.rst#math>`_. :py:`M_CODE_FILTERS_PRE: Dict` Filters to apply before a code snippet is rendered. Equivalent to an option of the - same name in the `m.code plugin <{filename}/plugins/math-and-code.rst#filters>`. + same name in the `m.code plugin <{filename}/plugins/math-and-code.rst#filters>`_. Note that due to the limitations of Doxygen markup, named filters are not supported. :py:`M_CODE_FILTERS_POST: Dict` Filters to apply after a code snippet is rendered. Equivalent to an option of the - same name in the `m.code plugin <{filename}/plugins/math-and-code.rst#filters>`. + same name in the `m.code plugin <{filename}/plugins/math-and-code.rst#filters>`_. Note that due to the limitations of Doxygen markup, named filters are not supported. =================================== ===========================================