diff --git a/doc/python/magnum.rst b/doc/python/magnum.rst index c79c54d..b6d8270 100644 --- a/doc/python/magnum.rst +++ b/doc/python/magnum.rst @@ -29,6 +29,8 @@ :language: c++ .. role:: py(code) :language: py +.. role:: sh(code) + :language: sh .. doctest setup >>> from magnum import * diff --git a/doc/python/pages/building.rst b/doc/python/pages/building.rst index 275d9bf..668444b 100644 --- a/doc/python/pages/building.rst +++ b/doc/python/pages/building.rst @@ -154,16 +154,17 @@ running them is then a matter of: cd src/python/magnum python -m unittest -.. block-warning:: Subject to change +.. block-default:: Disabling GL tests - If the tests detect that one of `platform.WindowlessApplication`\ s is - present, GL tests (suffixed with ``_gl``) will be run as well. Currently - there's no way to blacklist them if windowless application implementations - are compiled, you can only whitelist-run the remaining tests: + If the tests detect that one of + `platform.WindowlessApplication `\ s is + present, GL tests (suffixed with ``_gl``) will be run as well. In order to + disable them (for example when running on a headless CI), set the + :sh:`$MAGNUM_SKIP_GL_TESTS` environment variable to ``ON``: .. code:: sh - python -m unittest test.test_gl test.test_math # test.test_gl_gl is a GL test + MAGNUM_SKIP_GL_TESTS=ON python -m unittest For code coverage, `coverage.py `_ is used. Get it via ``pip`` or as a system package.