diff --git a/clang/docs/ClangFormatStyleOptions.rst b/clang/docs/ClangFormatStyleOptions.rst --- a/clang/docs/ClangFormatStyleOptions.rst +++ b/clang/docs/ClangFormatStyleOptions.rst @@ -1321,6 +1321,17 @@ **BreakStringLiterals** (``bool``) Allow breaking string literals when formatting. + .. code-block:: c++ + + true: + const char* x = "veryVeryVeryVeryVeryVe" + "ryVeryVeryVeryVeryVery" + "VeryLongString"; + + false: + const char* x = + "veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongString"; + **ColumnLimit** (``unsigned``) The column limit. diff --git a/clang/include/clang/Format/Format.h b/clang/include/clang/Format/Format.h --- a/clang/include/clang/Format/Format.h +++ b/clang/include/clang/Format/Format.h @@ -782,7 +782,7 @@ /// The brace breaking style to use. BraceBreakingStyle BreakBeforeBraces; - // Different ways to wrap braces after control statements. + /// Different ways to wrap braces after control statements. enum BraceWrappingAfterControlStatementStyle { /// Never wrap braces after a control statement. /// \code @@ -1077,6 +1077,16 @@ bool BreakAfterJavaFieldAnnotations; /// Allow breaking string literals when formatting. + /// \code + /// true: + /// const char* x = "veryVeryVeryVeryVeryVe" + /// "ryVeryVeryVeryVeryVery" + /// "VeryLongString"; + /// + /// false: + /// const char* x = + /// "veryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryVeryLongString"; + /// \endcode bool BreakStringLiterals; /// The column limit. @@ -1985,7 +1995,6 @@ /// Latest: Parse and format using the latest supported language version. /// 'Cpp11' is an alias for LS_Latest for historical reasons. LS_Latest, - /// Auto: Automatic detection based on the input. /// Parse using the latest language version. Format based on detected input. LS_Auto,