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

[Balazs Benics 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.
----------------
steakhal wrote:

I wonder if we can have a test for this? At least some canary test that the script works.

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