Add a warning comment that this file is generated
authorAaron Ballman <aaron@aaronballman.com>
Thu, 12 Jan 2023 13:09:30 +0000 (08:09 -0500)
committerAaron Ballman <aaron@aaronballman.com>
Thu, 12 Jan 2023 13:10:57 +0000 (08:10 -0500)
This file is partially generated by a Python script in the
clang/docs/tools directory, but it's not obvious for people making
drive-by fixes. This comment hopefully helps people avoid making
changes that are later overwritten by the script.

clang/docs/ClangFormatStyleOptions.rst

index 302069e..4bcf3bd 100644 (file)
@@ -1,3 +1,9 @@
+..
+  !!!!NOTE!!!!
+  This file is automatically generated, in part. Do not edit the style options
+  in this file directly. Instead, modify them in include/clang/Format/Format.h
+  and run the docs/tools/dump_format_style.py script to update this file.
+
 .. raw:: html
 
       <style type="text/css">