From 6940ba13fce3da58c9af6c5b44190a2cf0181aa4 Mon Sep 17 00:00:00 2001
From: Tim Cottin <timcottin@gmx.de>
Date: Tue, 12 Aug 2025 21:57:17 +0200
Subject: [PATCH 1/2] Add documentation for the config option "Documentation"

---
 config.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/config.md b/config.md
index 04499a8..02c5184 100644
--- a/config.md
+++ b/config.md
@@ -535,3 +535,23 @@ Available kinds could be found [here](features#kinds) in the Kind column.
 Specify semantic token modifiers that clangd should not send to client.
 
 Available modifiers could be found [here](features#modifiers) in the Modifier column.
+
+## Documentation
+{:.v21}
+
+Specify server side documentation code comment interpretation.
+Affects the format of the documentation string sent to the client for hover and code completions.
+Sample block (default):
+
+```yaml
+Documentation:
+  CommentFormat: PlainText
+```
+
+### CommentFormat
+
+Determines the comment format of code documentation.
+
+- `PlainText`: interpret code documentation as plain text. Markdown specific syntax will be escaped. On clients supporting markdown, this will result in showing markdown syntax without rendering. E.g. using \*\*bold text\*\* in the documentation comment will be shown as \*\*bold text\*\* and not as **bold text** in the hover/code completion.
+- `Markdown`: interpret documentation comments as markdown. Markdown syntax will not be escaped, except for HTML tags. On clients supporting markdown, this will result in rendering all markdown syntax.
+- `Doxygen`: interpret code documentation as [doxygen](https://www.doxygen.nl/) comments. In addition to treating the documentation as markdown, this will parse the documentation with Clangs doxygen parser. It will highlight used doxygen commands, convert doxygen commands to markdown syntax and extend hover content with e.g. function parameter or return documentation.

From 1339ec72f64ddae5048a4881a00d1b35eafcf7f3 Mon Sep 17 00:00:00 2001
From: Tim Cottin <timcottin@gmx.de>
Date: Thu, 14 Aug 2025 10:57:51 +0200
Subject: [PATCH 2/2] fix review findings

---
 config.md  | 4 ++--
 styles.css | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/config.md b/config.md
index 02c5184..69a7d8d 100644
--- a/config.md
+++ b/config.md
@@ -537,7 +537,7 @@ Specify semantic token modifiers that clangd should not send to client.
 Available modifiers could be found [here](features#modifiers) in the Modifier column.
 
 ## Documentation
-{:.v21}
+{:.v22}
 
 Specify server side documentation code comment interpretation.
 Affects the format of the documentation string sent to the client for hover and code completions.
@@ -554,4 +554,4 @@ Determines the comment format of code documentation.
 
 - `PlainText`: interpret code documentation as plain text. Markdown specific syntax will be escaped. On clients supporting markdown, this will result in showing markdown syntax without rendering. E.g. using \*\*bold text\*\* in the documentation comment will be shown as \*\*bold text\*\* and not as **bold text** in the hover/code completion.
 - `Markdown`: interpret documentation comments as markdown. Markdown syntax will not be escaped, except for HTML tags. On clients supporting markdown, this will result in rendering all markdown syntax.
-- `Doxygen`: interpret code documentation as [doxygen](https://www.doxygen.nl/) comments. In addition to treating the documentation as markdown, this will parse the documentation with Clangs doxygen parser. It will highlight used doxygen commands, convert doxygen commands to markdown syntax and extend hover content with e.g. function parameter or return documentation.
+- `Doxygen`: interpret code documentation as [doxygen](https://www.doxygen.nl/) comments. In addition to treating the documentation as markdown, this will parse the documentation with Clang's doxygen parser. It will highlight used doxygen commands, convert doxygen commands to markdown syntax and extend hover content with e.g. function parameter or return documentation.
diff --git a/styles.css b/styles.css
index f47ffbd..2e93147 100644
--- a/styles.css
+++ b/styles.css
@@ -170,7 +170,7 @@ a[href^="https://code.woboq.org/"] {
 /* Version marker ornaments */
 .v6::before, .v7::before, .v8::before, .v9::before, .v10::before, .v11::before, .v12::before,
 .v13::before, .v14::before, .v15::before, .v16::before, .v17::before, .v18::before, .v19::before,
-.v20::before, .v21::before {
+.v20::before, .v21::before, .v22::before {
   color: #008;
   border-radius: 3px;
   padding: 0.2em 0.6em;
@@ -198,6 +198,7 @@ a[href^="https://code.woboq.org/"] {
 .v19::before { content: "clangd-19"; }
 .v20::before { content: "clangd-20"; }
 .v21::before { content: "clangd-21"; }
+.v22::before { content: "clangd-22"; }
 #edit {
   text-decoration: none;
   position: absolute;