mirror of
git://code.qt.io/qt/qt5.git
synced 2025-12-21 07:28:21 +08:00
9c1349047e
1. We tend to use 2 spaces for indenting pre-processor directives, when we do it. Unfortunately clang-format also counts header-guards so not really recommended to use blindly on a header... 2. Add comments to namespaces, since the closing brace is simply a brace with no further decoration. 3. Attach escaped new-lines on the left (instead of current: right). Where 'right' will add the '\' characters on the far-right of our column limit, 'left' will put them as far left as it can while having them vertically aligned. Change-Id: Ib5a836c76f7761d743e0100c83e7db609b959249 Reviewed-by: Thiago Macieira <thiago.macieira@intel.com> Reviewed-by: Kai Koehne <kai.koehne@qt.io>
109 lines
3.6 KiB
Plaintext
109 lines
3.6 KiB
Plaintext
# Copyright (C) 2016 Olivier Goffart <ogoffart@woboq.com>
|
|
#
|
|
# You may use this file under the terms of the 3-clause BSD license.
|
|
# See the file LICENSE from this package for details.
|
|
|
|
# This is the clang-format configuration style to be used by Qt,
|
|
# based on the rules from https://wiki.qt.io/Qt_Coding_Style and
|
|
# https://wiki.qt.io/Coding_Conventions
|
|
|
|
---
|
|
# Webkit style was loosely based on the Qt style
|
|
BasedOnStyle: WebKit
|
|
|
|
Standard: c++17
|
|
|
|
# Column width is limited to 100 in accordance with Qt Coding Style.
|
|
# https://wiki.qt.io/Qt_Coding_Style
|
|
# Note that this may be changed at some point in the future.
|
|
ColumnLimit: 100
|
|
# How much weight do extra characters after the line length limit have.
|
|
# PenaltyExcessCharacter: 4
|
|
|
|
# Disable reflow of some specific comments
|
|
# qdoc comments: indentation rules are different.
|
|
# Translation comments and SPDX license identifiers are also excluded.
|
|
CommentPragmas: "^!|^:|^ SPDX-License-Identifier:"
|
|
|
|
# We want a space between the type and the star for pointer types.
|
|
PointerBindsToType: false
|
|
|
|
# We use template< without space.
|
|
SpaceAfterTemplateKeyword: false
|
|
|
|
# We want to break before the operators, but not before a '='.
|
|
BreakBeforeBinaryOperators: NonAssignment
|
|
|
|
# Braces are usually attached, but not after functions or class declarations.
|
|
BreakBeforeBraces: Custom
|
|
BraceWrapping:
|
|
AfterClass: true
|
|
AfterControlStatement: false
|
|
AfterEnum: false
|
|
AfterFunction: true
|
|
AfterNamespace: false
|
|
AfterObjCDeclaration: false
|
|
AfterStruct: true
|
|
AfterUnion: false
|
|
BeforeCatch: false
|
|
BeforeElse: false
|
|
IndentBraces: false
|
|
|
|
# When constructor initializers do not fit on one line, put them each on a new line.
|
|
ConstructorInitializerAllOnOneLineOrOnePerLine: true
|
|
# Indent initializers by 4 spaces
|
|
ConstructorInitializerIndentWidth: 4
|
|
|
|
# Indent width for line continuations.
|
|
ContinuationIndentWidth: 8
|
|
|
|
# No indentation for namespaces.
|
|
NamespaceIndentation: None
|
|
|
|
# Allow indentation for preprocessing directives (if/ifdef/endif). https://reviews.llvm.org/rL312125
|
|
IndentPPDirectives: AfterHash
|
|
# We only indent with 2 spaces for preprocessor directives
|
|
PPIndentWidth: 2
|
|
|
|
# Horizontally align arguments after an open bracket.
|
|
# The coding style does not specify the following, but this is what gives
|
|
# results closest to the existing code.
|
|
AlignAfterOpenBracket: true
|
|
AlwaysBreakTemplateDeclarations: true
|
|
|
|
# Ideally we should also allow less short function in a single line, but
|
|
# clang-format does not handle that.
|
|
AllowShortFunctionsOnASingleLine: Inline
|
|
|
|
# The coding style specifies some include order categories, but also tells to
|
|
# separate categories with an empty line. It does not specify the order within
|
|
# the categories. Since the SortInclude feature of clang-format does not
|
|
# re-order includes separated by empty lines, the feature is not used.
|
|
SortIncludes: false
|
|
|
|
# macros for which the opening brace stays attached.
|
|
ForEachMacros: [ foreach, Q_FOREACH, BOOST_FOREACH, forever, Q_FOREVER, QBENCHMARK, QBENCHMARK_ONCE ]
|
|
|
|
# Break constructor initializers before the colon and after the commas.
|
|
BreakConstructorInitializers: BeforeColon
|
|
|
|
# Add "// namespace <namespace>" comments on closing brace for a namespace
|
|
# Ignored for namespaces that qualify as a short namespace,
|
|
# see 'ShortNamespaceLines'
|
|
FixNamespaceComments: true
|
|
|
|
# Definition of how short a short namespace is, default 1
|
|
ShortNamespaceLines: 1
|
|
|
|
# When escaping newlines in a macro attach the '\' as far left as possible, e.g.
|
|
##define a \
|
|
# something; \
|
|
# other; \
|
|
# thelastlineislong;
|
|
AlignEscapedNewlines: Left
|
|
|
|
# Avoids the addition of a space between an identifier and the
|
|
# initializer list in list-initialization.
|
|
SpaceBeforeCpp11BracedList: false
|
|
|