[qt/clang/llvm]: Summary of bulk changes made

Git repository change summary for qt/clang/llvm
Pushed by mirror-service into branch 'upstream/users/rnk/clang-format-md-write'.
Changed from 0ddaf318d5bb460072d38bdefb788c735e4c1cf1 to b24c9b6208c1b0ea05fcd602405ffc7a92fbd30f
Acknowledgement was received that this change introduces only existing code that has been pushed to another public open source repository.

This change contains the following new commits:

Git commit 98b3781f4c268f06eb0444d51d9ac6617c7b505b by Reid Kleckner on 03/08/2026 at 00:27..
[docs][clang-format] Rename docs to Markdown

Rename ClangFormat and ClangFormatStyleOptions from reStructuredText to Markdown.

Update the clang-format documentation generator scripts and CMake custom targets to point at the renamed .md files so the generated documentation paths remain valid. Keep this changeset limited to rename/path updates; Markdown content cleanup is in the follow-up rewrite changeset.
https://invent.kde.org/qt/clang/llvm/-/commit/98b3781f4c268f06eb0444d51d9ac6617c7b505b

Git commit 86f5613fd3046b38f732514ba108af00108917fb by GitHub (on behalf of Reid Kleckner) on 03/08/2026 at 16:53..
Apply suggestions from code review

Co-authored-by: owenca <[email protected]>
Co-authored-by: Reid Kleckner <[email protected]>
https://invent.kde.org/qt/clang/llvm/-/commit/86f5613fd3046b38f732514ba108af00108917fb

Git commit 033d086ab6e0e9d2776930ac7327ecc8c4729522 by Reid Kleckner on 03/08/2026 at 16:54..
[docs][clang-format] Migrate generated clang-format docs to markdown

The challenge here is that the documentation is generated from Doxygen
comments in headers, `Format.h` and `IncludeStyle.h`.

First, the generator was updated to generate markdown constructs, and
then the Doxygen comments were also modified to use markdown constructs.
Mostly this means using single backticks instead of double backticks,
which is the Doxygen-native way of expressing code font blocks anyway,
so that's good.

To validate, I built the Sphinx docs and the doxygen, and I confirmed
that the generator script is idempotent, meaning it doesn't change the
markdown output. When I add a new option to clang-format, it shows up in
the help text block, so it works.

Before/after validation links:
| Source file | Before HTML | After HTML |
| --- | --- | --- |
| `clang/docs/ClangFormat.md` | [before](https://clang.llvm.org/docs/ClangFormat.html) | [after](https://llvmdocs.staging.reidkleckner.dev/clang/docs/ClangFormat.html) |
| `clang/docs/ClangFormatStyleOptions.md` | [before](https://clang.llvm.org/docs/ClangFormatStyleOptions.html) | [after](https://llvmdocs.staging.reidkleckner.dev/clang/docs/ClangFormatStyleOptions.html) |

Assisted-by: an agent
https://invent.kde.org/qt/clang/llvm/-/commit/033d086ab6e0e9d2776930ac7327ecc8c4729522

Git commit b24c9b6208c1b0ea05fcd602405ffc7a92fbd30f by Reid Kleckner on 03/08/2026 at 16:54..
fix link word wrapping
https://invent.kde.org/qt/clang/llvm/-/commit/b24c9b6208c1b0ea05fcd602405ffc7a92fbd30f