[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:

Good idea. I'll probably drop a simple lit test into `clang/test/Analysis` which validates that the script can parse everything in `AnalyzerOptions.def`. I don't think that more testing is worth the additional effort -- this is a tertiary plumbing script after all.

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