[clang] [diagtool] Make the BuiltinDiagnosticsByID table sorted (PR #120321)

[Björn Pettersson via cfe-commits]

================
@@ -0,0 +1,31 @@
+//===--- DiagnosticIDs.inc --------------------------------------*- C++ -*-===//
+//
+// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+// See https://llvm.org/LICENSE.txt for license information.
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+//
+//===----------------------------------------------------------------------===//
+///
+/// \file
+/// Defines the Diagnostic IDs in ID sorted order.
+///
+//===----------------------------------------------------------------------===//
+
+// Turn off clang-format, as the order of the includes are important to make
+// sure the table is sorted.
----------------
bjope wrote:

The context for "the table" is a bit unclear here.
Maybe something like
  "... to make sure tables based on Diagnostic IDs are partitioned/sorted based on DiagID."

https://github.com/llvm/llvm-project/pull/120321