BasedOnStyle: LLVM							# start from LLVM's style and override the options below
UseTab: Always								# indent with tab characters instead of spaces
TabWidth: 8									# a tab counts as 8 columns for alignment/column-limit computations
IndentWidth: 8								# indent each nesting level by 8 columns, i.e. one tab, since UseTab is Always
ColumnLimit: 0 								# no line length limit: 157 lines in src/ exceed 120 chars (up to 271 chars), the code is clearly not width-constrained
BreakBeforeBraces: Attach					# keep the opening brace on the same line as the statement that introduces it (if/for/function/class)
PointerAlignment: Middle					# put a space on both sides of '*', e.g. "const ConfigNode * mapMainConfig" -- matches the majority style in the codebase despite a few isolated "Type* x"
ReferenceAlignment: Middle					# put a space on both sides of '&', e.g. "const PString & name" -- matches the codebase's existing style
SpaceBeforeParens: Never					# never put a space before '(', even for if/for/while -- matches "if(x)", "for(x)" as used throughout (unlike ControlStatements)
AllowShortIfStatementsOnASingleLine: false	# always put the body of an "if" on its own line, even for a single statement
AllowShortFunctionsOnASingleLine: None		# never collapse a function body onto the braces line, even when empty -- matches "~AbstractFunction(){\n\t\n}" staying on 3 lines
IndentAccessModifiers: true					# indent "public:"/"private:"/"protected:" one tab in from the class, and the members they introduce one tab further still
NamespaceIndentation: All					# indent the contents of every namespace block by one level, e.g. inside "namespace Swarm{...}"
ReflowComments: false						# never re-wrap comment text, so existing Doxygen blocks ("///", "/** @param ... */") are left untouched
SortIncludes: true							# sort #include directives within each category below
IncludeBlocks: Regroup						# always regroup into the categories below (one blank-line-separated block per category), regardless of existing blank lines
IncludeCategories:							# system (<...>) and local ("...") headers must never be merged/resorted together -- two separate blocks, each sorted alphabetically
  - Regex: '^<'
    Priority: 1
    SortPriority: 1
  - Regex: '.*'
    Priority: 2
    SortPriority: 2
DerivePointerAlignment: false				# never override PointerAlignment/ReferenceAlignment by guessing from local majority usage per file
FixNamespaceComments: true					# add "// namespace Swarm" after the closing brace of a namespace block
IndentPPDirectives: BeforeHash				# indent nested preprocessor directives (e.g. "#ifdef" inside "#ifdef"), indent placed before the '#'
InsertNewlineAtEOF: true					# ensure every formatted file ends with a trailing newline
