CLANG XFORMAT FULL
CLANG XFORMAT CODE

Note that clang-format doesn't work well in an external repo it does not support specifying a style file, and instead scans directories recursively upward from a file to find the closest parent directory with a. clang-format file to Blender's repository (probably root Blender repo).

CLANG XFORMAT CODE

Let's both save time and increase code quality by leveraging the immense engineering effort of the clang format team to increase Blender's code consistency. In the past, automatic tools did not work well enough, but that is no longer true. The simple reason is that it's a waste of precious developer time to have them obsess over formatting details. The key reason is to have consistent code that is readable by all Blender developers, and to help save time by removing time spent debating style questions.

CLANG XFORMAT FULL

And unlike other attempts, clang-format is used and extended by some of the largest companies for their large scale codebases: Apple, Google, Mozilla, and more.Īdditionally, beyond just leveraging the full C/C++ parser of Clang, clang-format aims to support a limited number of formatting styles, but support those styles extremely well handling as many edge cases correctly as possible, to avoid spending engineering time fixing autoformatting mistakes.įor all these reasons, this proposal is to figure out a plan to bring clang-format to Blender. clang-format is different than the previous versions for a key reason: it is built around a full-scale industrial strength C/C++ parsing engine, clang. In the intervening years, a new entrant has stepped onto the stage: clang-format. Unfortunately, this only works for simple code the moment sophisticated code is used, these simplistic formatting solutions don't work well. This was usually because they did not implement a full C/C++ parser, and instead tried to parse a subset of the language in order to provide the formatting. In the past, there have been various tools for reformatting C and C++ code, but for the most part they did not work well. Incorporate an automated way to enforce this style across Blender.Ĭurrently the code in Blender has a style guide, but there are only limited tools to enforce this style.Change a few parts of Blender's C/C++ code style like using spaces instead of tabs, and some other minor things.UPDATED JAN 7/2019 - Ultimately this proposal will do two things

Clang xformat