Noissue - clang-format configuration file for C++

c++/clang-format/clang-format-eyeo

 ---
-Language:        Cpp
-AccessModifierOffset: -2
-AlignAfterOpenBracket: Align
-AlignEscapedNewlinesLeft: false
-AlignTrailingComments: true
-AllowAllParametersOfDeclarationOnNextLine: false
-AllowShortBlocksOnASingleLine: false
-AllowShortFunctionsOnASingleLine: All
-AllowShortIfStatementsOnASingleLine: false
-AllowShortLoopsOnASingleLine: false
-AlwaysBreakBeforeMultilineStrings: false
-AlwaysBreakTemplateDeclarations: true
+# The syntax herein is for Clang 4, with opt-in support for Clang 5.
+
+Language: Cpp
+BasedOnStyle: Mozilla
+
+# _de facto_ style is no breaking for return types.
+# Clang 5 version
+AlwaysBreakAfterReturnType: None 
+# Clang 4 version
+# Clang 4 documentation defect: It defines "AlwaysBreakAfterReturnType" and 
+# states that "AlwaysBreakAfterDefinitionReturnType" is deprecated. Disregard
+# this; the line below is necessary for Clang 4 and the Clang 5 version need not
+# be commented out.  
+AlwaysBreakAfterDefinitionReturnType: None
+
+# Long function definitions or calls should not become even longer.
+BinPackArguments: true
 BinPackParameters: true
-BreakBeforeBinaryOperators: false
+
+# Non-assignment operators appear at the beginning of line (after indent).
+BreakBeforeBinaryOperators: NonAssignment
+
+# General override: "Opening braces always go on their own line." 
 BreakBeforeBraces: Allman
-BreakBeforeTernaryOperators: false
+
+# Don't treat commas specially within initializers.
+# Clang 5 version
+#BreakConstructorInitializers: BeforeColon
+# Clang 4 version
 BreakConstructorInitializersBeforeComma: false
+
+# Don't wrap long lines automatically.
+# If lines need to be wrapped, do so explicitly. 
 ColumnLimit: 0
-CommentPragmas:  '^ IWYU pragma:'
-ConstructorInitializerAllOnOneLineOrOnePerLine: true
-ConstructorInitializerIndentWidth: 2
-ContinuationIndentWidth: 2
+
+# Format braced lists like function calls.  
 Cpp11BracedListStyle: true
-DerivePointerAlignment: false
-DisableFormat:   false
-ExperimentalAutoDetectBinPacking: false
-ForEachMacros:   [ foreach, Q_FOREACH, BOOST_FOREACH ]
-IndentCaseLabels: true
-IndentFunctionDeclarationAfterType: false
-IndentWidth: 2
-IndentWrappedFunctionNames: false
+
+# Don't preserve excess vertical whitespace. 
 KeepEmptyLinesAtTheStartOfBlocks: false
-MaxEmptyLinesToKeep: 1
+
+# C++ override. "Indent namespace bodies."
 NamespaceIndentation: All
-PenaltyBreakBeforeFirstCallParameter: 19
-PenaltyBreakComment: 300
-PenaltyBreakFirstLessLess: 120
-PenaltyBreakString: 1000
-PenaltyExcessCharacter: 1000000
-PenaltyReturnTypeOnItsOwnLine: 200
-PointerAlignment: Left
-SpaceBeforeAssignmentOperators: true
-SpaceBeforeParens: ControlStatements
-SpaceInEmptyParentheses: false
-SpacesBeforeTrailingComments: 1
-SpacesInAngles: false
-SpacesInContainerLiterals: true
-SpacesInCStyleCastParentheses: false
-SpacesInParentheses: false
-SpacesInSquareBrackets: false
+
+# Use modern C++. Argument stands for C++11, C++14, etc. 
 Standard: Cpp11
-TabWidth: 8
-UseTab: Never
 ...
-