Update clang-format rules

Signed-off-by: Dennis Tsiang <dennis.tsiang@arm.com>
Change-Id: I76f87648a8ddaeddb6774123d263957b845d10a1

.clang-format

@@ -1,109 +1,183 @@
+# The style used for all options not specifically set in the configuration.
 BasedOnStyle: LLVM
 
+# The extra indent or outdent of access modifiers, e.g. public:.
 AccessModifierOffset: -3
 
+# If true, aligns escaped newlines as far left as possible. Otherwise puts them into the right-most column.
 AlignEscapedNewlinesLeft: true
 
+# If true, aligns trailing comments.
 AlignTrailingComments: true
 
+# Allow putting all parameters of a function declaration onto the next line even if BinPackParameters is false.
 AllowAllParametersOfDeclarationOnNextLine: false
 
+# Allows contracting simple braced statements to a single line.
 AllowShortBlocksOnASingleLine: false
 
+# If true, short case labels will be contracted to a single line.
 AllowShortCaseLabelsOnASingleLine: false
 
+# Dependent on the value, int f() { return 0; } can be put on a single line. Possible values: None, Inline, All.
 AllowShortFunctionsOnASingleLine: None
 
+# If true, if (a) return; can be put on a single line.
 AllowShortIfStatementsOnASingleLine: false
 
+# If true, while (true) continue; can be put on a single line.
 AllowShortLoopsOnASingleLine: false
 
+# If true, always break after function definition return types.
 AlwaysBreakAfterDefinitionReturnType: false
 
+# If true, always break before multiline string literals.
 AlwaysBreakBeforeMultilineStrings: false
 
+# If true, always break after the template<...> of a template declaration.
 AlwaysBreakTemplateDeclarations: true
 
+# If false, a function call's arguments will either be all on the same line or will have one line each.
 BinPackArguments: true
 
+# If false, a function declaration's or function definition's parameters will either all be on the same line
+# or will have one line each.
 BinPackParameters: true
 
+# The way to wrap binary operators. Possible values: None, NonAssignment, All.
 BreakBeforeBinaryOperators: None
 
-BreakBeforeBraces: Allman
+# The brace breaking style to use. Possible values: Attach, Linux, Stroustrup, Allman, GNU.
+BreakBeforeBraces: Custom
+# Like Allman but do not indent extern blocks
+BraceWrapping:
+    AfterExternBlock: 'false'
+    AfterCaseLabel: 'true'
+    AfterClass: 'true'
+    AfterEnum: 'true'
+    AfterFunction: 'true'
+    AfterNamespace: 'true'
+    AfterObjCDeclaration: 'true'
+    AfterStruct: 'true'
+    AfterUnion: 'true'
+    BeforeCatch: 'true'
+    BeforeElse: 'true'
+    AfterControlStatement: 'Always'
 
+# If true, ternary operators will be placed after line breaks.
 BreakBeforeTernaryOperators: false
 
+# Always break constructor initializers before commas and align the commas with the colon.
 BreakConstructorInitializersBeforeComma: true
 
+# The column limit. A column limit of 0 means that there is no column limit.
 ColumnLimit: 120
 
+# A regular expression that describes comments with special meaning, which should not be split into lines or otherwise changed.
 CommentPragmas: '^ *'
 
+# If the constructor initializers don't fit on a line, put each initializer on its own line.
 ConstructorInitializerAllOnOneLineOrOnePerLine: false
 
+# The number of characters to use for indentation of constructor initializer lists.
 ConstructorInitializerIndentWidth: 3
 
+# Indent width for line continuations.
 ContinuationIndentWidth: 3
 
+# If true, format braced lists as best suited for C++11 braced lists.
 Cpp11BracedListStyle: false
 
+# Disables formatting at all.
 DisableFormat: false
 
+# A vector of macros that should be interpreted as foreach loops instead of as function calls.
 ForEachMacros: ['']
 
+# Indent case labels one level from the switch statement.
+# When false, use the same indentation level as for the switch statement.
+# Switch statement body is always indented one level more than case labels.
 IndentCaseLabels: false
 
+# The number of columns to use for indentation.
 IndentWidth: 3
 
+# Indent if a function definition or declaration is wrapped after the type.
 IndentWrappedFunctionNames: false
 
+# If true, empty lines at the start of blocks are kept.
 KeepEmptyLinesAtTheStartOfBlocks: true
 
+# Language, this format style is targeted at. Possible values: None, Cpp, Java, JavaScript, Proto.
 Language: Cpp
 
+# The maximum number of consecutive empty lines to keep.
 MaxEmptyLinesToKeep: 1
 
+# The indentation used for namespaces. Possible values: None, Inner, All.
 NamespaceIndentation: None
 
+# The penalty for breaking a function call after "call(".
 PenaltyBreakBeforeFirstCallParameter: 19
 
+# The penalty for each line break introduced inside a comment.
 PenaltyBreakComment: 300
 
+# The penalty for breaking before the first <<.
 PenaltyBreakFirstLessLess: 120
 
+# The penalty for each line break introduced inside a string literal.
 PenaltyBreakString: 1000
 
+# The penalty for each character outside of the column limit.
 PenaltyExcessCharacter: 1000000
 
+# Penalty for putting the return type of a function onto its own line.
 PenaltyReturnTypeOnItsOwnLine: 1000000000
 
+# Pointer and reference alignment style. Possible values: Left, Right, Middle.
 PointerAlignment: Right
 
+# Do not sort includes
 SortIncludes: false
 
+# If true, a space may be inserted after C style casts.
 SpaceAfterCStyleCast: false
 
+# If false, spaces will be removed before assignment operators.
 SpaceBeforeAssignmentOperators: true
 
+# Defines in which cases to put a space before opening parentheses. Possible values: Never, ControlStatements, Always.
 SpaceBeforeParens: ControlStatements
 
+# If true, spaces may be inserted into '()'.
 SpaceInEmptyParentheses: false
 
+# The number of spaces before trailing line comments (// - comments).
 SpacesBeforeTrailingComments: 1
 
+# If true, spaces will be inserted after '<' and before '>' in template argument lists.
 SpacesInAngles: false
 
+# If true, spaces may be inserted into C style casts.
 SpacesInCStyleCastParentheses: false
 
+# If true, spaces are inserted inside container literals (e.g. ObjC and Javascript array and dict literals).
 SpacesInContainerLiterals: false
 
+# If true, spaces will be inserted after '(' and before ')'.
 SpacesInParentheses: false
 
+# If true, spaces will be inserted after '[' and befor']'.
 SpacesInSquareBrackets: false
 
+# Format compatible with this standard, e.g. use A<A<int> > instead of A<A<int>> for LS_Cpp03. Possible values: Cpp03, Cpp11, Auto.
 Standard: Cpp11
 
+# The number of columns used for tab stops.
 TabWidth: 3
 
+# The way to use tab characters in the resulting file. Possible values: Never, ForIndentation, Always.
 UseTab: Never
+
+FixNamespaceComments: false

.pre-commit-config.yaml

@@ -5,7 +5,7 @@ minimum_pre_commit_version: 2.9.0
 
 repos:
     - repo: https://github.com/pre-commit/mirrors-clang-format
-      rev: v10.0.1
+      rev: v14.0.0
       hooks:
           - id: clang-format
 

util/custom_allocator.cpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-2021 Arm Limited.
+ * Copyright (c) 2020-2021, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *

util/custom_allocator.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-2022 Arm Limited.
+ * Copyright (c) 2020-2022, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *

util/file_descriptor.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021 Arm Limited.
+ * Copyright (c) 2021, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *
@@ -44,7 +44,6 @@ namespace util
 class fd_owner : private noncopyable
 {
 public:
-
    fd_owner() = default;
    fd_owner(int fd)
       : fd_handle{ fd }

util/format_modifiers.cpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022 Arm Limited.
+ * Copyright (c) 2022, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *

util/timed_semaphore.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017, 2019 Arm Limited.
+ * Copyright (c) 2017, 2019, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *
@@ -39,8 +39,7 @@
 
 #pragma once
 
-extern "C"
-{
+extern "C" {
 #include <pthread.h>
 }
 

util/unordered_map.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021-2022 Arm Limited.
+ * Copyright (c) 2021-2022, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *
@@ -37,9 +37,7 @@ namespace util
  *        exceptions don't throw them and also ensures that the memory can
  *        only be allocated by an custom_allocator.
  */
-template <typename Key, typename Value,
-	typename Hash = std::hash<Key>,
-	typename Comparator = std::equal_to<Key>,
+template <typename Key, typename Value, typename Hash = std::hash<Key>, typename Comparator = std::equal_to<Key>,
           typename Allocator = util::custom_allocator<std::pair<const Key, Value>>>
 class unordered_map : public std::unordered_map<Key, Value, Hash, Comparator, Allocator>, private noncopyable
 {

util/unordered_set.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021-2022 Arm Limited.
+ * Copyright (c) 2021-2022, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *
@@ -37,9 +37,7 @@ namespace util
  *        exceptions don't throw them and also ensures that the memory can
  *        only be allocated by an custom_allocator.
  */
-template <typename Key,
-   typename Hash = std::hash<Key>,
-   typename Comparator = std::equal_to<Key>,
+template <typename Key, typename Hash = std::hash<Key>, typename Comparator = std::equal_to<Key>,
           typename Allocator = util::custom_allocator<Key>>
 class unordered_set : public std::unordered_set<Key, Hash, Comparator, Allocator>, private noncopyable
 {

wsi/surface_properties.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017-2019, 2021-2023 Arm Limited.
+ * Copyright (c) 2017-2019, 2021-2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *
@@ -100,16 +100,10 @@ class surface_format_properties
 {
 public:
    surface_format_properties(VkFormat format)
-      : m_surface_format
-   {
-      format, VK_COLORSPACE_SRGB_NONLINEAR_KHR
-   }
+      : m_surface_format{ format, VK_COLORSPACE_SRGB_NONLINEAR_KHR }
 #if WSI_IMAGE_COMPRESSION_CONTROL_SWAPCHAIN
-   , m_compression
-   {
-      VK_STRUCTURE_TYPE_IMAGE_COMPRESSION_PROPERTIES_EXT, nullptr, VK_IMAGE_COMPRESSION_DEFAULT_EXT,
-         VK_IMAGE_COMPRESSION_FIXED_RATE_NONE_EXT
-   }
+      , m_compression{ VK_STRUCTURE_TYPE_IMAGE_COMPRESSION_PROPERTIES_EXT, nullptr, VK_IMAGE_COMPRESSION_DEFAULT_EXT,
+                       VK_IMAGE_COMPRESSION_FIXED_RATE_NONE_EXT }
 #endif
    {
    }

wsi/synchronization.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021-2022 Arm Limited.
+ * Copyright (c) 2021-2022, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *

wsi/wayland/surface.cpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021 Arm Limited.
+ * Copyright (c) 2021, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *
@@ -242,8 +242,7 @@ bool surface::init()
    return true;
 }
 
-util::unique_ptr<surface> surface::make_surface(const util::allocator &allocator, wl_display *display,
-                                                wl_surface *surf)
+util::unique_ptr<surface> surface::make_surface(const util::allocator &allocator, wl_display *display, wl_surface *surf)
 {
    init_parameters params{ allocator, display, surf };
    auto wsi_surface = allocator.make_unique<surface>(params);

wsi/wayland/surface.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021 Arm Limited.
+ * Copyright (c) 2021, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *

wsi/wayland/swapchain.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017-2019, 2021-2022 Arm Limited.
+ * Copyright (c) 2017-2019, 2021-2022, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *
@@ -27,8 +27,7 @@
 #include "wsi/swapchain_base.hpp"
 #include "wl_helpers.hpp"
 
-extern "C"
-{
+extern "C" {
 #include <vulkan/vk_icd.h>
 }
 

wsi/wayland/wl_helpers.cpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017-2019, 2021 Arm Limited.
+ * Copyright (c) 2017-2019, 2021, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *

wsi/wayland/wl_object_owner.hpp

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021 Arm Limited.
+ * Copyright (c) 2021, 2024 Arm Limited.
  *
  * SPDX-License-Identifier: MIT
  *