summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKlaus Aehlig <klaus.aehlig@huawei.com>2025-06-12 14:20:21 +0200
committerKlaus Aehlig <klaus.aehlig@huawei.com>2025-06-13 12:19:02 +0200
commit4b40928323cb79aa8d68c5073125dd887c372b7a (patch)
treeecc34d89c6e13398c0909152b5d387ff5ccba77c
parent2e2a8362aaa25b70bd11fe14c3035227f41960dd (diff)
downloadjustbuild-4b40928323cb79aa8d68c5073125dd887c372b7a.tar.gz
CONTRINBUTING: point to the newly added "lint" repository
To allow everyone to lint in the same way with minimal manual setup effort.
-rw-r--r--CONTRIBUTING.md13
1 files changed, 12 insertions, 1 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 838c8fd5..f8d86251 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -14,7 +14,18 @@ appropriate test coverage. For code to be accepted, all tests must
pass; the global test suite is `["@", "just tests", "", "ALL"]`.
Code is formatted with `clang-format` and linted with `clang-tidy`;
the corresponding configuration files can be found in the top-level
-directory of this repository.
+directory of this repository. The top-level lint target is
+`["@", "lint", "", ""]`; formatting issues can be fixed by building
+and applying the patch `["@", "lint", "", "format.diff"]`.
+
+*NOTE:* In order for everyone to use the same version of the linting
+tools, the `"lint"` repository
+[bootstraps](https://github.com/just-buildsystem/bootstrappable-toolchain)
+the required tools; the configuration variable `"TOOLCHAIN_CONFIG"`
+is honored. As a consequence, (transitively) depending on the
+`"lint"` repository pulls in quite some sources and linting the
+first time requires a significant amount of time to build the tools
+from first principles.
Changes should be organized as a patch series, i.e., as a sequence of
small changes that are easy to review, but nevertheless self-contained