[qt/clang/llvm]: Summary of bulk changes made
KDE Git Services - Bulk Change <[email protected]>
| Newsgroups | gmane.comp.kde.cvs |
|---|---|
| Message-ID | <[email protected]> |
Git repository change summary for qt/clang/llvm Pushed by mirror-service into branch 'upstream/users/rnk/clang-format-md-write'. Changed from da04ce10261bd1fa9f963e4b3e865c8c0d237b35 to 0ddaf318d5bb460072d38bdefb788c735e4c1cf1 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 4cd9820863d58920ca42db1a410ffbb0ea42a9c8 by Reid Kleckner on 23/07/2026 at 01:58.. [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/4cd9820863d58920ca42db1a410ffbb0ea42a9c8 Git commit 0ddaf318d5bb460072d38bdefb788c735e4c1cf1 by Reid Kleckner on 23/07/2026 at 02:24.. [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/0ddaf318d5bb460072d38bdefb788c735e4c1cf1