https://github.com/Glitch-On created
https://github.com/llvm/llvm-project/pull/233126
The Extra Clang Tools release notes have carried content for clang-tidy and,
lately, clangd, while the other tools shipped release after release with empty
sections even when they changed. Part of that is the template: it still has an
"include-fixer" section left over from the 2019 rename to clang-include-fixer,
next to the renamed one; it has a section for the clang-tidy Visual Studio
plugin, which was removed in 2019 (559ae14c9b6c); and it has no section at all
for clang-include-cleaner, clang-apply-replacements, clang-change-namespace,
clang-move or clang-reorder-fields.
This gives every tool in clang-tools-extra its own section, drops the two dead
ones, and keeps the sections after clangd in alphabetical order. The same edits
are applied to `ReleaseNotes.md` and `ReleaseNotesTemplate.txt`, as the header
comment in the notes asks, so the next release starts from the corrected layout.
It then fills in what this release changed outside clang-tidy and clangd but
never noted: Objective-C support in the include-cleaner analysis (#211119,
#212617, #212633, #212564, #216158, #216201), the main header insertion fix
(#212852), and the clang-doc crash on invalid UTF-8 in comments (#210886). I
went through every commit to the non-clang-tidy tools since the 23.x branch
point; the remaining ones are clang-wide refactors with no user-visible effect.
I did not audit clangd's commits, since clangd already has notes and its
maintainers write those in bulk.
Checked by building the clang-tools-extra docs with Sphinx: no warnings on the
release notes page, and the `{doc}` link to the `misc-include-cleaner` check
resolves.
One judgment call: the four sections for tools with no changes this cycle will
show up empty in the shipped notes, as five sections already did in 23.x. I
kept them so the template works as a checklist for every tool, but I am happy
to add only clang-include-cleaner if that is preferred.
Fixes #64324
>From 44eddd9f8dd9f783b1a837ff6a16a8e8126b4a50 Mon Sep 17 00:00:00 2001
From: Vansh <[email protected]>
Date: Sun, 18 Oct 2026 00:38:37 +0530
Subject: [PATCH] [clang-tools-extra][docs] Cover all tools in the release
notes
The Extra Clang Tools release notes have carried content for clang-tidy
and, lately, clangd, while the other tools shipped release after release
with empty sections even when they changed. Part of that is the
template: it still has an "include-fixer" section left over from the
2019 rename to clang-include-fixer, next to the renamed one; it has a
section for the clang-tidy Visual Studio plugin, which was removed in
2019; and it has no section at all for clang-include-cleaner,
clang-apply-replacements, clang-change-namespace, clang-move or
clang-reorder-fields.
Give every tool in clang-tools-extra its own section, drop the two dead
ones, and keep the sections after clangd in alphabetical order. The same
edits are applied to ReleaseNotes.md and ReleaseNotesTemplate.txt so
the next release starts from the corrected layout.
Then fill in what this release changed outside clang-tidy and clangd
but never noted: Objective-C support in the include-cleaner analysis
(#211119, #212617, #212633, #212564, #216158, #216201), the main header
insertion fix (#212852), and the clang-doc crash on invalid UTF-8 in
comments (#210886). The remaining commits to the other tools in this
cycle are refactors with no user-visible effect.
Fixes #64324
---
clang-tools-extra/docs/ReleaseNotes.md | 36 +++++++++++++++----
.../docs/ReleaseNotesTemplate.txt | 18 ++++++----
2 files changed, 42 insertions(+), 12 deletions(-)
diff --git a/clang-tools-extra/docs/ReleaseNotes.md
b/clang-tools-extra/docs/ReleaseNotes.md
index 69f3ecee49926b..4509d05af82adf 100644
--- a/clang-tools-extra/docs/ReleaseNotes.md
+++ b/clang-tools-extra/docs/ReleaseNotes.md
@@ -124,10 +124,40 @@ infrastructure are described first, followed by
tool-specific sections.
- Added support for loading dynamic plugins via the `-load` command-line
option.
+### Improvements to clang-apply-replacements
+
+### Improvements to clang-change-namespace
+
### Improvements to clang-doc
+- Fixed a crash, in builds with assertions enabled, when a documentation
+ comment contains invalid UTF-8. The text is now sanitized before it is
+ emitted.
+ ([#210675](https://github.com/llvm/llvm-project/issues/210675))
+
+### Improvements to clang-include-cleaner
+
+- Added Objective-C support to the include analysis. References made through
+ interfaces, protocols, categories, compatible aliases, instance variables,
+ properties, message sends, `@selector` expressions, literals and boxed
+ expressions, and toll-free bridged casts are now attributed to the headers
+ that declare them, and forward declarations of interfaces and protocols no
+ longer satisfy a use that needs the definition. This also applies to clangd
+ and to the clang-tidy {doc}`misc-include-cleaner
+ <clang-tidy/checks/misc/include-cleaner>` check, which share the analysis.
+
+- Fixed the main header of a source file being inserted at the wrong position
+ when several missing includes are added at once.
+ ([#212852](https://github.com/llvm/llvm-project/pull/212852))
+
+### Improvements to clang-include-fixer
+
+### Improvements to clang-move
+
### Improvements to clang-query
+### Improvements to clang-reorder-fields
+
### Improvements to clang-tidy
- Improved {program}`check_clang_tidy.py` by adding support of
@@ -431,12 +461,6 @@ infrastructure are described first, followed by
tool-specific sections.
inserting a missing `#include`, which stopped {program}`clang-format` and
the `llvm-include-order` check from being able to sort it correctly
afterwards.
-### Improvements to include-fixer
-
-### Improvements to clang-include-fixer
-
### Improvements to modularize
### Improvements to pp-trace
-
-### Clang-tidy Visual Studio plugin
diff --git a/clang-tools-extra/docs/ReleaseNotesTemplate.txt
b/clang-tools-extra/docs/ReleaseNotesTemplate.txt
index 8874e1d393c6aa..9cf55bf008bae5 100644
--- a/clang-tools-extra/docs/ReleaseNotesTemplate.txt
+++ b/clang-tools-extra/docs/ReleaseNotesTemplate.txt
@@ -80,10 +80,22 @@ infrastructure are described first, followed by
tool-specific sections.
#### Miscellaneous
+### Improvements to clang-apply-replacements
+
+### Improvements to clang-change-namespace
+
### Improvements to clang-doc
+### Improvements to clang-include-cleaner
+
+### Improvements to clang-include-fixer
+
+### Improvements to clang-move
+
### Improvements to clang-query
+### Improvements to clang-reorder-fields
+
### Improvements to clang-tidy
#### New checks
@@ -96,12 +108,6 @@ infrastructure are described first, followed by
tool-specific sections.
#### Miscellaneous
-### Improvements to include-fixer
-
-### Improvements to clang-include-fixer
-
### Improvements to modularize
### Improvements to pp-trace
-
-### Clang-tidy Visual Studio plugin
_______________________________________________
cfe-commits mailing list
[email protected]
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
