blob: 9385a5846b0253cecfed3238838f6bed6601eff4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
# clang-format config for raylib-jamstack C/C++ bindings.
#
# Codifies the dominant style of the hand-written C/C++ mrbgem sources
# (mrbgems/*/src/* + src/main.c): Allman braces, 2-space indent, ~100-col limit,
# return type on its own line for top-level function definitions. Verified to
# produce ZERO diff on raylib_bindings.c (the most style-consistent file); other
# files have real inconsistencies (single-line function defs, semicolon-chained
# statements) that `clang-format -i` will normalize.
#
# Scope: hand-written sources only. raylib_gen.c (generated) and vendor/ are
# excluded (see bin/lint). Never hand-edit raylib_gen.c.
#
# Run manually: bin/lint --check-c (report / dry-run)
# bin/lint --fix-c (rewrite in place)
# Run directly: clang-format -i <files> (fix in place)
# clang-format --dry-run --Werror <files> (report)
#
# See .agents/knowledge/linting.md for the rationale + how it fits with the
# LSP setup (clangd's --clang-tidy stays OFF for the live-edit path; manual
# clang-format/clang-tidy are deliberate, separate steps).
BasedOnStyle: LLVM
# --- Indentation ---
IndentWidth: 2
TabWidth: 2
UseTab: Never
ContinuationIndentWidth: 2
IndentCaseLabels: false
IndentGotoLabels: false
NamespaceIndentation: None
IndentWrappedFunctionNames: false
# --- Braces: Allman (open brace on its own line) ---
BreakBeforeBraces: Allman
AllowShortBlocksOnASingleLine: Empty
AllowShortFunctionsOnASingleLine: Empty
AllowShortIfStatementsOnASingleLine: WithoutElse
AllowShortLoopsOnASingleLine: false
AllowShortCaseLabelsOnASingleLine: false
AllowShortEnumsOnASingleLine: false
# --- Return type on its own line for top-level function definitions ---
# This matches raylib_bindings.c's style (return type, then name+args, then {).
AlwaysBreakAfterReturnType: TopLevelDefinitions
AlwaysBreakAfterDefinitionReturnType: TopLevel
# --- Column limit ---
ColumnLimit: 100
ReflowComments: false # don't rewrap hand-written /* ... */ comments
# --- Includes ---
SortIncludes: Never # preserve the commented, grouped include order
IncludeBlocks: Preserve
# --- Alignment ---
AlignAfterOpenBracket: Align
AlignConsecutiveAssignments: false
AlignConsecutiveDeclarations: false
AlignConsecutiveMacros: true
AlignEscapedNewlines: Left
AlignOperands: Align
AlignTrailingComments: true
# --- Spacing ---
SpaceBeforeParens: ControlStatements
SpaceBeforeSquareBrackets: false
SpaceAroundPointerQualifiers: Default
BitFieldColonSpacing: Both
SpacesInParentheses: false
SpacesInSquareBrackets: false
SpacesInContainerLiterals: false
# --- Pointers ---
PointerAlignment: Right # mrb_state *mrb (not mrb_state* mrb)
# --- Misc ---
Cpp11BracedListStyle: true # {.name = name} not { .name = name } (no inner spaces)
|
