serenity/.clang-format

---
AlignEscapedNewlines: Left
AlignTrailingComments:
    Kind: Always
    OverEmptyLines: 0
BasedOnStyle: WebKit
BraceWrapping:
    AfterFunction: true
BreakBeforeBraces: Custom
BreakBeforeInheritanceComma: true
BreakConstructorInitializers: BeforeComma
IndentPPDirectives: AfterHash
IndentRequiresClause: false
InsertNewlineAtEOF: true
LineEnding: LF
NamespaceIndentation: None
QualifierAlignment: Right
RemoveSemicolon: true
RequiresClausePosition: WithFollowing
RequiresExpressionIndentation: OuterScope
SpaceAfterTemplateKeyword: false

---
Language: ObjC
BinPackParameters: false
BraceWrapping:
    AfterObjCDeclaration: true
ObjCBinPackProtocolList: Never
ObjCBlockIndentWidth: 4
ObjCBreakBeforeNestedBlockParam: true
ObjCSpaceAfterProperty: true
ObjCSpaceBeforeProtocolList: true

...
Add clang-format file Also run it across the whole tree to get everything using the One True Style. We don't yet run this in an automated fashion as it's a little slow, but there is a snippet to do so in makeall.sh. 2019-05-28 09:53:16 +00:00			`---`
Meta: Switch to clang-format-14 as the standard formatter Now that clang-format-14 ubuntu packages are available, it's time to finally upgrade our clang-format version. This version brings with it a bunch of useful features with const-placement being the most notable. These will be enabled in the following commits. 2022-02-06 19:05:35 +00:00			`AlignEscapedNewlines: Left`
Meta: Switch to clang-format-16 as the standard formatter This includes a few new options to the .clang-format configuration file to A) adhere to option changes within clang-format 16 (namely the option AlignTrailingComments), and B) enforce existing style guide rules with new clang-format rules. 2023-07-08 00:21:41 +00:00			`AlignTrailingComments:`
			`Kind: Always`
			`OverEmptyLines: 0`
Meta: Alphabetize clang-format options Except for Language, which is typically first. This helps when scrolling down the list of options in the clang-format documentation. 2023-07-08 02:37:46 +00:00			`BasedOnStyle: WebKit`
			`BraceWrapping:`
			`AfterFunction: true`
			`BreakBeforeBraces: Custom`
Add clang-format file Also run it across the whole tree to get everything using the One True Style. We don't yet run this in an automated fashion as it's a little slow, but there is a snippet to do so in makeall.sh. 2019-05-28 09:53:16 +00:00			`BreakBeforeInheritanceComma: true`
			`BreakConstructorInitializers: BeforeComma`
			`IndentPPDirectives: AfterHash`
Meta: Alphabetize clang-format options Except for Language, which is typically first. This helps when scrolling down the list of options in the clang-format documentation. 2023-07-08 02:37:46 +00:00			`IndentRequiresClause: false`
Meta: Switch to clang-format-16 as the standard formatter This includes a few new options to the .clang-format configuration file to A) adhere to option changes within clang-format 16 (namely the option AlignTrailingComments), and B) enforce existing style guide rules with new clang-format rules. 2023-07-08 00:21:41 +00:00			`InsertNewlineAtEOF: true`
			`LineEnding: LF`
Meta: Update .clang-format to not indent nested namespaces 2020-03-14 09:10:21 +00:00			`NamespaceIndentation: None`
Meta: Update .clang-format to correct qualifier alignment This ensures 'east-const' order. 2022-02-06 19:15:10 +00:00			`QualifierAlignment: Right`
Everywhere: Remove needless trailing semi-colons after functions This is a new option in clang-format-16. 2023-07-08 02:48:11 +00:00			`RemoveSemicolon: true`
Meta: Switch to clang-format-15 as the standard formatter The two major changes noticeable on the SerenityOS codebase are: - Much improved support for const placement, clang-format-14 ignored our east-const configuration in various places - Different formatting for requires clauses, now breaking them onto their own line, which helps with readability a bit Current versions of CLion also ship LLVM 15, so the built-in formatting now matches CI formatting again :^) 2022-10-16 22:05:51 +00:00			`RequiresClausePosition: WithFollowing`
Meta: Switch to clang-format-16 as the standard formatter This includes a few new options to the .clang-format configuration file to A) adhere to option changes within clang-format 16 (namely the option AlignTrailingComments), and B) enforce existing style guide rules with new clang-format rules. 2023-07-08 00:21:41 +00:00			`RequiresExpressionIndentation: OuterScope`
Meta: Alphabetize clang-format options Except for Language, which is typically first. This helps when scrolling down the list of options in the clang-format documentation. 2023-07-08 02:37:46 +00:00			`SpaceAfterTemplateKeyword: false`
Meta: Support using clang-format on Objective-C++ files We can (and have to) remove the C++ language identifier from the main set of rules. This will allow these rule to propagate to all languages. 2023-08-20 20:35:01 +00:00
			`---`
			`Language: ObjC`
			`BinPackParameters: false`
			`BraceWrapping:`
			`AfterObjCDeclaration: true`
			`ObjCBinPackProtocolList: Never`
			`ObjCBlockIndentWidth: 4`
			`ObjCBreakBeforeNestedBlockParam: true`
			`ObjCSpaceAfterProperty: true`
			`ObjCSpaceBeforeProtocolList: true`

			`...`