Move clang-format off and clang-format on comments outside of the enum and re-generate documentation.

Author: ichaer

clang/docs/ClangFormatStyleOptions.rst

@@ -5209,7 +5209,7 @@ the configuration (without a prefix: ``Auto``).
 
   Possible values:
 
-  * ``// clang-format on`` (in configuration: ``// clang-format on``)
+  * ``RCS_Never`` (in configuration: ``Never``)
     Leave comments untouched.
 
     .. code-block:: c++
@@ -5219,7 +5219,7 @@ the configuration (without a prefix: ``Auto``).
        /* third veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongComment with plenty of information
             * and a misaligned second line */
 
-  * ``// clang-format on`` (in configuration: ``// clang-format on``)
+  * ``RCS_IndentOnly`` (in configuration: ``IndentOnly``)
     Only apply indentation rules, moving comments left or right, without
     changing formatting inside the comments.
 
@@ -5230,7 +5230,7 @@ the configuration (without a prefix: ``Auto``).
        /* third veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongComment with plenty of information
         * and a misaligned second line */
 
-  * ``// clang-format on`` (in configuration: ``// clang-format on``)
+  * ``RCS_Always`` (in configuration: ``Always``)
     Apply indentation rules and re-flow long comments into new lines, trying
     to obey the ``ColumnLimit``.
 

clang/include/clang/Format/Format.h

@@ -3749,19 +3749,17 @@ struct FormatStyle {
   /// \version 13
   ReferenceAlignmentStyle ReferenceAlignment;
 
+  // clang-format off
   /// \brief Types of comment re-flow style.
   enum ReflowCommentsStyle : int8_t {
-    // clang-format off
     /// Leave comments untouched.
     /// \code
     ///    // veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongComment with plenty of information
     ///    /* second veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongComment with plenty of information */
     ///    /* third veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongComment with plenty of information
     ///         * and a misaligned second line */
     /// \endcode
-    // clang-format on
     RCS_Never,
-    // clang-format off
     /// Only apply indentation rules, moving comments left or right, without
     /// changing formatting inside the comments.
     /// \code
@@ -3770,9 +3768,7 @@ struct FormatStyle {
     ///    /* third veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongComment with plenty of information
     ///     * and a misaligned second line */
     /// \endcode
-    // clang-format on
     RCS_IndentOnly,
-    // clang-format off
     /// Apply indentation rules and re-flow long comments into new lines, trying
     /// to obey the ``ColumnLimit``.
     /// \code
@@ -3783,9 +3779,9 @@ struct FormatStyle {
     ///    /* third veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongComment with plenty of
     ///     * information and a misaligned second line */
     /// \endcode
-    // clang-format on
     RCS_Always
   };
+  // clang-format on
 
   /// \brief Comment reformatting style.
   /// \version 3.8