[PATCH] D142578: [Clang][Doc] Edit the Clang release notes

Mon Jan 30 09:13:40 PST 2023

aaron.ballman added a comment.

Thank you for working on this, it is really shaping up nicely!

In D142578#4088769 <https://reviews.llvm.org/D142578#4088769>, @royjacobson wrote:

> In D142578#4088011 <https://reviews.llvm.org/D142578#4088011>, @tschuett wrote:
>
>> IDK. Clang 16 is fully is a fully conformant C++20 except for some DRs. Or beginning with Clang 16, we start a long-term project to overhaul the diagnostics.
>>
>> I agree that breaking changes are important.
>
> I contemplated on this for a bit, and I don't have anything that I feel is representative enough and fits into one paragraph. I'm still not against the general idea though.

I think "major announcements" should be limited to things almost everyone will want to know about, like "we're changing our license" or "we've finished support for <major language revision>". So not every release will have major announcements, and that's fine -- we can remove any empty sections from the release notes.

================
Comment at: clang/docs/ReleaseNotes.rst:16
      Release notes for previous releases can be found on
-     `the Download Page <https://releases.llvm.org/download.html>`_.
+     `the Releases Page <https://llvm.org/releases>`_.

----------------
Are you planning to merge the changes in generic text over to the trunk once this lands?

================
Comment at: clang/docs/ReleaseNotes.rst:43
+  conforming GNU extensions. Projects incompatible with C++17 can add
+  ``-std=gnu++14`` to their build settings to restore the previous behaviour.

----------------
Do we want to mention that this may also impact build-time performance of projects relying on the default language standard mode, because C++17 pulls in a lot more compile-time-intensive APIs like constexpr and more template metaprogramming?

================
Comment at: clang/docs/ReleaseNotes.rst:46
+- The ``-fexperimental-new-pass-manager`` and ``-fno-legacy-pass-manager``
+  flags have been removed. These flags have been silently ignored since 15.

----------------
I don't know if we want to standardize on `Clang-15` or `Clang 15`, etc. Feel free to edit as you see fit.

Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D142578/new/

https://reviews.llvm.org/D142578