summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.gitlab-ci/README.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/.gitlab-ci/README.md b/.gitlab-ci/README.md
new file mode 100644
index 00000000..f80669b5
--- /dev/null
+++ b/.gitlab-ci/README.md
@@ -0,0 +1,26 @@
+# Continuous Integration scripts for at-spi2-core
+
+Please see the general [documentation for at-spi2-core's Gitlab CI][ci-docs].
+
+This directory contains scripts which get called during a CI run, and
+utilities to maintain the CI infrastructure.
+
+* `run-tests.sh` - Runs the test suite and prints other diagnostics.
+
+* `gen-coverage.sh` - After the test suite is run, merges the various
+ code coverage reports from `lcov`, and generates an HTML report.
+
+* `lcovrc` - Configuration file for `lcov`, used by `gen-coverage.sh`.
+ Among other things, this tells `lcov` to exclude branch coverage for
+ the unreachable branches of `g_return_if_fail()` and friends.
+
+* `run-style-check.sh` - Runs `clang-format-diff` to test for source
+ files with inconsistent formatting, and uploads the resulting report
+ to gitlab so it can be viewed as part of a merge request's analysis.
+
+* `search-common-ancestor.sh` - Utility used from
+ `run-style-check.sh`; finds a git branch point from the current
+ commit.
+
+
+[ci-docs]: ../devel-docs/gitlab-ci.md