<feed xmlns='http://www.w3.org/2005/Atom'>
<title>progmasoft-cpp/Progmasoft_Core_C_Coding_Guidelines/C11/TOOLING.md, branch main</title>
<subtitle>The C++ style guide of Progmasoft: naming, formatting, language rules, errors, ownership, ABI, testing and tooling.</subtitle>
<link rel='alternate' type='text/html' href='https://git.progmasoft.com/progmasoft-cpp/'/>
<entry>
<title>Write Progmasoft Core C Coding Guidelines</title>
<updated>2026-11-15T12:45:44+00:00</updated>
<author>
<name>Leitwolf11</name>
</author>
<published>2026-11-15T12:45:44+00:00</published>
<link rel='alternate' type='text/html' href='https://git.progmasoft.com/progmasoft-cpp/commit/?id=fec4661eee5ef6548f9d914a409a496251efcb39'/>
<id>fec4661eee5ef6548f9d914a409a496251efcb39</id>
<content type='text'>
The C11 guidelines take the place of the empty folder, with all eleven
chapters in C11/ since there is one version: principles, formatting with the
.clang-format profile, naming (scope, storage, pointer and direction prefixes,
module prefixes, the meaning of function verbs), files and headers, control
flow, declarations and initializers, preprocessor, memory and ownership, the
C11 language page, comments and Doxygen, and tooling with the .clang-tidy
profile. index.json lists them against the progmasoft-cpp-index schema.

The profile targets clang-format 23. Two settings were added so that it
produces the layout the chapters describe: IncludeIsMainRegex '$^', so a
source file's own header is not moved above the standard ones, and
PenaltyBreakAssignment 100, so a call stays on the line of its '=' and breaks
between its arguments. A list over several lines ends with a comma after its
last item (EnumTrailingComma: Insert for enums): without it clang-format
joins the list or lines it up after the '{'. The forms clang-format 23 cannot
produce are listed in Formatting: 'return(value)', the compound literal
'(Type){ 0 }' and an empty do body.

Every C block of the chapters was checked: clang-format 23.1.5 leaves each
one unchanged except for 'return(value)', and the example module compiles
with clang -std=c11 -pedantic-errors -Wall -Wextra -Werror and passes the
clang-tidy profile.

The C guidelines are a style of their own; a C interface of a C++ library
keeps following the C++ guidelines. README, ADOPTING, LICENSE and the
changelog name them.

Co-Authored-By: Claude Opus 5.5 &lt;noreply@anthropic.com&gt;
Claude-Session: https://claude.ai/code/session_01Ji7xZMYjc4zankoc7hGBE1
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The C11 guidelines take the place of the empty folder, with all eleven
chapters in C11/ since there is one version: principles, formatting with the
.clang-format profile, naming (scope, storage, pointer and direction prefixes,
module prefixes, the meaning of function verbs), files and headers, control
flow, declarations and initializers, preprocessor, memory and ownership, the
C11 language page, comments and Doxygen, and tooling with the .clang-tidy
profile. index.json lists them against the progmasoft-cpp-index schema.

The profile targets clang-format 23. Two settings were added so that it
produces the layout the chapters describe: IncludeIsMainRegex '$^', so a
source file's own header is not moved above the standard ones, and
PenaltyBreakAssignment 100, so a call stays on the line of its '=' and breaks
between its arguments. A list over several lines ends with a comma after its
last item (EnumTrailingComma: Insert for enums): without it clang-format
joins the list or lines it up after the '{'. The forms clang-format 23 cannot
produce are listed in Formatting: 'return(value)', the compound literal
'(Type){ 0 }' and an empty do body.

Every C block of the chapters was checked: clang-format 23.1.5 leaves each
one unchanged except for 'return(value)', and the example module compiles
with clang -std=c11 -pedantic-errors -Wall -Wextra -Werror and passes the
clang-tidy profile.

The C guidelines are a style of their own; a C interface of a C++ library
keeps following the C++ guidelines. README, ADOPTING, LICENSE and the
changelog name them.

Co-Authored-By: Claude Opus 5.5 &lt;noreply@anthropic.com&gt;
Claude-Session: https://claude.ai/code/session_01Ji7xZMYjc4zankoc7hGBE1
</pre>
</div>
</content>
</entry>
</feed>
