Fix doxygen parser converting Ford admonitions

Fixes #717

Author: ZedThree

ford/sourceform.py

@@ -170,6 +170,9 @@ def translate_doxy_meta(doc_list: list[str]) -> list[str]:
     for line, comment in enumerate(doc_list):
         if match := DOXY_META_RE.match(comment):
             meta_type = match["key"]
+            # Don't convert our admonitions
+            if meta_type in {"note", "warning", "todo", "bug", "history"}:
+                continue
             meta_content = match["value"].strip()
             meta_type = DOXYGEN_TRANSLATION.get(meta_type, meta_type)
             if meta_type != "param":

test/test_sourceform.py

@@ -2399,3 +2399,22 @@ def test_doxygen_see_link(parse_fortran_file):
     fortran_file = parse_fortran_file(data)
     assert fortran_file.modules[1].doc_list[0].strip() == "[[a]] with a description"
     assert fortran_file.modules[0].doc_list[0].strip() == "[[b]]"
+
+
+def test_doxygen_eating_admonitions_bug717(parse_fortran_file):
+    """Ensure the doxygen parser doesn't convert our admonitions"""
+
+    data = """\
+    !> @note this should remain
+    module test
+    end module test
+    """
+
+    fortran_file = parse_fortran_file(data)
+    md = MetaMarkdown()
+
+    module = fortran_file.modules[0]
+    module.markdown(md)
+
+    # This is tied to the format of the admonitions class
+    assert 'div class="alert alert-info"' in module.doc