docs: add a Doxygen compatibility page

.github/workflows/ci-utility-tests.yml

@@ -79,6 +79,9 @@ jobs:
       - name: Check bootstrap options partial is up to date
         run: python3 ./utils/docs/generate_bootstrap_options.py --check
 
+      - name: Check the commands registry and the Doxygen page against the parser
+        run: python3 ./utils/docs/check_commands_registry.py
+
       # When the Coverage matrix entry was skipped because the develop cache is
       # warm, fetch develop's LCOV report and re-upload it tagged with the PR's
       # commit SHA. Codecov sees zero patch lines and unchanged project totals,

docs/modules/ROOT/attachments/schemas/config/mrdocs.schema.json

@@ -19,12 +19,12 @@
     },
     "auto-brief": {
       "default": true,
-      "description": "When set to `true`, Mr.Docs uses the first line (until the first dot, question mark, or exclamation mark) of the comment as the brief of the symbol. When set to `false`, a explicit @brief command is required.",
+      "description": "When set to `true`, Mr.Docs uses the first paragraph of the comment as the brief of the symbol. When set to `false`, only the `@brief`, `@short`, `@copybrief`, and `@copydoc` commands set a brief.",
       "enum": [
         true,
         false
       ],
-      "title": "Use the first line of the comment as the brief",
+      "title": "Use the first paragraph of the comment as the brief",
       "type": "boolean"
     },
     "auto-function-metadata": {

docs/modules/ROOT/nav.adoc

@@ -9,6 +9,7 @@
 ** xref:commands/metadata.adoc[Metadata Commands]
 ** xref:commands/inlines.adoc[Inline Commands]
 ** xref:commands/reference.adoc[Reference]
+** xref:commands/doxygen.adoc[Doxygen Compatibility]
 * Configuration
 ** xref:configuration/index.adoc[Overview]
 ** xref:configuration/inputs.adoc[Inputs]