[clang] [NFC][analyzer] Document configuration options (PR #135169)

[Donát Nagy via cfe-commits]

================
@@ -7,6 +7,9 @@
 //===----------------------------------------------------------------------===//
 //
 //  This file defines the analyzer options avaible with -analyzer-config.
+//  Note that clang/docs/tools/generate_analyzer_options_docs.py relies on the
+//  structure of this file, so if this file is refactored, then make sure to
+//  update that script as well.
----------------
NagyDonat wrote:

In https://github.com/llvm/llvm-project/pull/135169/commits/180afc02b5f1ae640c892fa7df22984daff9c2d0 I added a test which validates that the script does understand `AnalyzerOptions.def`.

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