summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--CONTRIBUTING.md7
-rw-r--r--ci/script.sh5
2 files changed, 12 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8d8b8ded..03a1f630 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -85,6 +85,13 @@ locally. More information is available in the [CI Readme][ci-readme].
[travis-ci]: https://travis-ci.org/nix-rust/nix
[ci-readme]: ci/README.md
+### Disabling a test in the CI environment
+
+Sometimes there are features that cannot be tested in the CI environment.
+To stop a test from running under CI, add `#[cfg_attr(travis, ignore)]`
+to it. Please include a comment describing the reason it shouldn't run
+under CI, and a link to an upstream issue if possible!
+
## bors, the bot who merges all the PRs
All pull requests are merged via [bors], an integration bot. After the
diff --git a/ci/script.sh b/ci/script.sh
index 39c3aeec..df61c35a 100644
--- a/ci/script.sh
+++ b/ci/script.sh
@@ -3,6 +3,11 @@
set -ex
main() {
+ # Add a cfg spec to allow disabling specific tests under CI.
+ if [ "$TRAVIS" = true ]; then
+ export RUSTFLAGS=--cfg=travis
+ fi
+
# Build debug and release targets
cross build --target $TARGET
cross build --target $TARGET --release