Update the example of BS_Stroustrup to match what is done by clang-format

[sylvestre.ledru]

Summary

reported here https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=911561

clang-format-7 -style="{BreakBeforeBraces: Stroustrup}" wasn't doing
the same as the doc

[krasimir]

docs/ClangFormatStyleOptions.rst

904

Looking into this, I think your update of the example below is correct, but the description should stay as-is:

Like ``Attach``, but break before function definitions,...

The Always break before braces should still apply to the BS_Allman option below.
Am I missing something here?

[sylvestre.ledru]

Remove the desc update

[krasimir]

Thank you!

docs/ClangFormatStyleOptions.rst

.. code-block:: c++
       {
       };
       if (foo()) {
       } else {
       }
       enum X : int { A, B };
 
   * ``BS_Stroustrup`` (in configuration: ``Stroustrup``)
-    Like ``Attach``, but break before function definitions, ``catch``, and
-    ``else``.
+    Always break before braces.
 
     .. code-block:: c++
 
       try {
         foo();
-      } catch () {
+      }
+      catch () {
       }
       void foo() { bar(); }
-      class foo
-      {
+      class foo {
       };
       if (foo()) {
-      } else {
       }
-      enum X : int
-      {
-        A,
-        B
-      };
+      else {
+      }
+      enum X : int { A, B };
 
   * ``BS_Allman`` (in configuration: ``Allman``)
     Always break before braces.
 
     .. code-block:: c++
 
       try {
         foo();

include/clang/Format/Format.h

enum BraceBreakingStyle {
     ///   {
     ///   };
     ///   if (foo()) {
     ///   } else {
     ///   }
     ///   enum X : int { A, B };
     /// \endcode
     BS_Mozilla,
-    /// Like ``Attach``, but break before function definitions, ``catch``, and
-    /// ``else``.
+    /// Always break before braces.
     /// \code
     ///   try {
     ///     foo();
-    ///   } catch () {
+    ///   }
+    ///   catch () {
     ///   }
     ///   void foo() { bar(); }
-    ///   class foo
-    ///   {
+    ///   class foo {
     ///   };
     ///   if (foo()) {
-    ///   } else {
     ///   }
-    ///   enum X : int
-    ///   {
-    ///     A,
-    ///     B
-    ///   };
+    ///   else {
+    ///   }
+    ///   enum X : int { A, B };
     /// \endcode
     BS_Stroustrup,
     /// Always break before braces.
     /// \code
     ///   try {
     ///     foo();
     ///   }
     ///   catch () {