"ctrl+T" changes the braces position I HATE that

[Master811129]

after auto-fomating in Arduino Pro IDE. It changes the braces position (but legacy IDE doesn't):

[ubidefeo]

hi @Master811129
this is a setting in Clangd format that defaults to such behaviour

the Java IDE does not use ClangD for formatting.
I'm sure this can be tuned in the future, because everyone likes their style.
Arduino sketches are formatted according to a very specific set of rules in Astyle, so I guess that this behaviour will have to be tuned to reflect the one in the Java IDE.
Let's check wtih @per1234 and see what he has to say

[kittaakos]

after auto-fomating in Arduino Pro IDE. It changes the braces position (but legacy IDE doesn't):

Yes, this is a reasonable request. However, we have to figure out how users can/will customize it.
Let's investigate the BraceWrappingFlags options from here. Here is an online clangd formatter with preview.

[tigoe]

+1 for leaving it the way the Java IDE did it, as that is what Arduino users are familiar with.

[per1234]

Background

Hi @Master811129. As mentioned above, we switched from the Artistic Style code formatter used by Arduino IDE 1.x to a new code formatting tool: ClangFormat.

I believe this was the right decision since ClangFormat is one of the most popular formatters and because it is actively maintained as part of the LLVM project, while Artistic Style is no longer actively maintained (note the developer even recommends ClangFormat in that statement).

Current status

As also mentioned above, at the time you wrote this the formatter was using the default configuration (since the team had not yet had time to work on a custom configuration for the beta IDE), which had significant differences from the Arduino IDE 1.x formatter configuration.

Since that time, I was given the opportunity to create a custom Arduino style configuration. I dedicated myself to making every possible effort to exactly reproduce the behavior of the IDE 1.x formatter.

Unfortunately, due to differences in the two tools, it was not possible to achieve an exact match. I'm sorry to say that the issue you reported here is one of those few remaining discrepancies.

Configuration file

The good news is that ClangFormat is very configurable (far more so than Artistic Style). It is now possible to define your own custom configuration in two different ways:

Global scope

If you add a .clang-format configuration file to either of the following locations, the Arduino IDE will always use it instead of the Arduino default configuration:

Windows

C:\Users\<username>\.arduinoIDE\

- OR -

C:\Users\<username>\AppData\Local\Arduino15\

Linux

~/.arduinoIDE/

- OR -

~/.arduino15/

macOS

~/.arduinoIDE

- OR -

~/Library/Arduino15/

Sketch scope

If you add a .clang-format configuration file to the root of a sketch, the Arduino IDE will use that configuration when formatting that sketch. This file has precedence over a global formatter configuration file.

Configuration

If you prefer "broken" braces, you can set that via the BreakBeforeBraces configuration option:

https://releases.llvm.org/14.0.0/tools/clang/docs/ClangFormatStyleOptions.html#:~:text=BreakBeforeBraces,-(BraceBreakingStyle)

❗ Please note that the custom configuration file completely overrides the Arduino default configuration, rather than merging with it. Any configuration option you don't set in your custom file will be set to the ClangFormat default value.

Here is Arduino's default configuration file in case you would like to use it as a base for your custom configuration:

---
Language: Cpp
# LLVM is the default style setting, used when a configuration option is not set here
BasedOnStyle: LLVM
AccessModifierOffset: -2
AlignAfterOpenBracket: Align
AlignConsecutiveAssignments: false
AlignConsecutiveBitFields: false
AlignConsecutiveDeclarations: false
AlignConsecutiveMacros: false
AlignEscapedNewlines: DontAlign
AlignOperands: Align
AlignTrailingComments: true
AllowAllArgumentsOnNextLine: true
AllowAllConstructorInitializersOnNextLine: true
AllowAllParametersOfDeclarationOnNextLine: true
AllowShortBlocksOnASingleLine: Always
AllowShortCaseLabelsOnASingleLine: true
AllowShortEnumsOnASingleLine: true
AllowShortFunctionsOnASingleLine: Empty
AllowShortIfStatementsOnASingleLine: Always
AllowShortLambdasOnASingleLine: Empty
AllowShortLoopsOnASingleLine: true
AlwaysBreakAfterDefinitionReturnType: None
AlwaysBreakAfterReturnType: None
AlwaysBreakBeforeMultilineStrings: false
AlwaysBreakTemplateDeclarations: No
BinPackArguments: true
BinPackParameters: true
# Only used when "BreakBeforeBraces" set to "Custom"
BraceWrapping:
  AfterCaseLabel: false
  AfterClass: false
  AfterControlStatement: Never
  AfterEnum: false
  AfterFunction: false
  AfterNamespace: false
  #AfterObjCDeclaration:
  AfterStruct: false
  AfterUnion: false
  AfterExternBlock: false
  BeforeCatch: false
  BeforeElse: false
  BeforeLambdaBody: false
  BeforeWhile: false
  IndentBraces: false
  SplitEmptyFunction: false
  SplitEmptyRecord: false
  SplitEmptyNamespace: false
# Java-specific
#BreakAfterJavaFieldAnnotations:
BreakBeforeBinaryOperators: NonAssignment
BreakBeforeBraces: Attach
BreakBeforeTernaryOperators: true
BreakConstructorInitializers: BeforeColon
BreakInheritanceList: BeforeColon
BreakStringLiterals: false
ColumnLimit: 0
# "" matches none
CommentPragmas: ""
CompactNamespaces: false
ConstructorInitializerAllOnOneLineOrOnePerLine: true
ConstructorInitializerIndentWidth: 2
ContinuationIndentWidth: 2
Cpp11BracedListStyle: false
DeriveLineEnding: true
DerivePointerAlignment: true
DisableFormat: false
# Docs say "Do not use this in config files". The default (LLVM 11.0.1) is "false".
#ExperimentalAutoDetectBinPacking:
FixNamespaceComments: false
ForEachMacros: []
IncludeBlocks: Preserve
IncludeCategories: []
# "" matches none
IncludeIsMainRegex: ""
IncludeIsMainSourceRegex: ""
IndentCaseBlocks: true
IndentCaseLabels: true
IndentExternBlock: Indent
IndentGotoLabels: false
IndentPPDirectives: None
IndentWidth: 2
IndentWrappedFunctionNames: false
InsertTrailingCommas: None
# Java-specific
#JavaImportGroups:
# JavaScript-specific
#JavaScriptQuotes:
#JavaScriptWrapImports
KeepEmptyLinesAtTheStartOfBlocks: true
MacroBlockBegin: ""
MacroBlockEnd: ""
# Set to a large number to effectively disable
MaxEmptyLinesToKeep: 100000
NamespaceIndentation: None
NamespaceMacros: []
# Objective C-specific
#ObjCBinPackProtocolList:
#ObjCBlockIndentWidth:
#ObjCBreakBeforeNestedBlockParam:
#ObjCSpaceAfterProperty:
#ObjCSpaceBeforeProtocolList
PenaltyBreakAssignment: 1
PenaltyBreakBeforeFirstCallParameter: 1
PenaltyBreakComment: 1
PenaltyBreakFirstLessLess: 1
PenaltyBreakString: 1
PenaltyBreakTemplateDeclaration: 1
PenaltyExcessCharacter: 1
PenaltyReturnTypeOnItsOwnLine: 1
# Used as a fallback if alignment style can't be detected from code (DerivePointerAlignment: true)
PointerAlignment: Right
RawStringFormats: []
ReflowComments: false
SortIncludes: false
SortUsingDeclarations: false
SpaceAfterCStyleCast: false
SpaceAfterLogicalNot: false
SpaceAfterTemplateKeyword: false
SpaceBeforeAssignmentOperators: true
SpaceBeforeCpp11BracedList: false
SpaceBeforeCtorInitializerColon: true
SpaceBeforeInheritanceColon: true
SpaceBeforeParens: ControlStatements
SpaceBeforeRangeBasedForLoopColon: true
SpaceBeforeSquareBrackets: false
SpaceInEmptyBlock: false
SpaceInEmptyParentheses: false
SpacesBeforeTrailingComments: 2
SpacesInAngles: false
SpacesInCStyleCastParentheses: false
SpacesInConditionalStatement: false
SpacesInContainerLiterals: false
SpacesInParentheses: false
SpacesInSquareBrackets: false
Standard: Auto
StatementMacros: []
TabWidth: 2
TypenameMacros: []
# Default to LF if line endings can't be detected from the content (DeriveLineEnding).
UseCRLF: false
UseTab: Never
WhitespaceSensitiveMacros: []

---

At this point, we have done everything in our power to mitigate this issue so I will close it.