From: Vladimír Vondruš <mosra@centrum.cz>
Date: Thu, 7 Dec 2017 10:21:14 +0000 (+0100)
Subject: doxygen: no need for the .h.nostrip language.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=b15f14df7d2b9ef40e491d245dd4b29dc27a9714;p=blog.git

doxygen: no need for the .h.nostrip language.

Doxygen actually has a STRIP_CODE_COMMENTS option, which does exactly
what's needed.
---

diff --git a/doc/doxygen.rst b/doc/doxygen.rst
index 6bbc7d24..254bbf85 100644
--- a/doc/doxygen.rst
+++ b/doc/doxygen.rst
@@ -449,9 +449,6 @@ Filename suffix     Detected language
 ``.h``              C++ (instead of C)
 ``.h.cmake``        C++ (instead of CMake), as this extension is often used for
                     C++ headers that are preprocessed with CMake
-``.h.nostrip``      C++. Useful for embedding code snippets with Doxygen
-                    comment block, as Doxygen would strip them with plain
-                    ``.h``.
 ``.glsl``           GLSL. For some reason, stock Pygments detect only
                     ``.vert``, ``.frag`` and ``.geo`` extensions as GLSL.
 ``.conf``           INI (key-value configuration files)
diff --git a/doxygen/dox2html5.py b/doxygen/dox2html5.py
index 58999de7..5a43d708 100755
--- a/doxygen/dox2html5.py
+++ b/doxygen/dox2html5.py
@@ -500,7 +500,6 @@ def parse_desc_internal(state: State, element: ET.Element, immediate_parent: ET.
             # Custom mapping of filenames to languages
             mapping = [('.h', 'c++'),
                        ('.h.cmake', 'c++'),
-                       ('.h.nostrip', 'c++'),
                        # Pygments knows only .vert, .frag, .geo
                        ('.glsl', 'glsl'),
                        ('.conf', 'ini'),