This document attempts to describe a few developer policies used in MLIR (such as coding standards used) as well as development approach (such as, testing methods).
MLIR follows the LLVM style guide. We also adhere to the following, that deviates from, or isn't specified in the LLVM style guide:
- Adopts camelBack;
- Except for IR units (Region, Block, and Operation), non-nullable output argument are passed by non-const reference in general.
- IR constructs are not designed for const correctness.
Please run clang-format on the files you modified with the .clang-format
configuration file available in the root directory. Check the clang-format
documentation for more details
on integrating it with your development environment. In particular, if clang is
installed system-wide, running git clang-format origin/master will update the
files in the working directory with the relevant formatting changes; don't
forget to include those to the commit.
To avoid collision between options provided by different dialects, the naming
convention is to prepend the dialect name to every dialect-specific passes and
options in general. Options that are specific to a pass should also be prefixed
with the pass name. For example, the affine dialect provides a loop tiling pass
that is registered on the command line as -affine-tile, and with a tile size
option that can be set with -affine-tile-size.
See here for the testing guide.