[clang-format] Handle deprecated options in dump_format_style.py

[owenpan]

Summary

Also add two deprecated options as comments back to Format.h.

[MyDeveloperDay]

Great thanks

[owenpan]

Landed in b1c300f.

clang/docs/tools/dump_format_style.py

for line in self.header:
           state = State.InEnum
           name = re.sub(r'enum\s+(\w+)\s*(:((\s*\w+)+)\s*)?\{', '\\1', line)
           enum = Enum(name, comment)
         elif line.startswith('struct'):
           state = State.InNestedStruct
           name = re.sub(r'struct\s+(\w+)\s*\{', '\\1', line)
           nested_struct = NestedStruct(name, comment)
         elif line.endswith(';'):
+          prefix = '// '
+          if line.startswith(prefix):
+            line = line[len(prefix):]
           state = State.InStruct
           field_type, field_name = re.match(r'([<>:\w(,\s)]+)\s+(\w+);',
                                             line).groups()
 
           if not version:
             self.__warning(f'missing version for {field_name}', line)
           option = Option(str(field_name), str(field_type), comment, version)
           options.append(option)

clang/include/clang/Format/Format.h

struct FormatStyle {
   ///   callFunction(a,
   ///                b,
   ///                c,
   ///                d);
   /// \endcode
   /// \version 9
   bool AllowAllArgumentsOnNextLine;
 
+  /// This option is **deprecated**. See ``NextLine`` of
+  /// ``PackConstructorInitializers``.
+  /// \version 9
+  // bool AllowAllConstructorInitializersOnNextLine;
+
   /// If the function declaration doesn't fit on a line,
   /// allow putting all parameters of a function declaration onto
   /// the next line even if ``BinPackParameters`` is ``false``.
   /// \code
   ///   true:
   ///   void myFunction(
   ///       int a, int b, int c, int d, int e);
   ///

   /// \code
   ///   namespace Foo { namespace Bar {
   ///   namespace Extra {
   ///   }}}
   /// \endcode
   /// \version 5
   bool CompactNamespaces;
 
+  /// This option is **deprecated**. See ``CurrentLine`` of
+  /// ``PackConstructorInitializers``.
+  /// \version 3.7
+  // bool ConstructorInitializerAllOnOneLineOrOnePerLine;
+
   /// The number of characters to use for indentation of constructor
   /// initializer lists as well as inheritance lists.
   /// \version 3.7
   unsigned ConstructorInitializerIndentWidth;
 
   /// Indent width for line continuations.
   /// \code
   ///    ContinuationIndentWidth: 2