diff --git a/llvm/docs/TestingGuide.rst b/llvm/docs/TestingGuide.rst --- a/llvm/docs/TestingGuide.rst +++ b/llvm/docs/TestingGuide.rst @@ -406,8 +406,8 @@ --------------------------- Some tests can be run only in specific configurations, such as -with debug builds or on particular platforms. Use ``REQUIRES`` -and ``UNSUPPORTED`` to control when the test is enabled. +with debug builds or on particular platforms. Use ``REQUIRES``, +``REQUIRES-ANY`` and ``UNSUPPORTED`` to control when the test is enabled. Some tests are expected to fail. For example, there may be a known bug that the test detect. Use ``XFAIL`` to mark a test as an expected failure. @@ -418,19 +418,23 @@ ; This test will be only enabled in the build with asserts. ; REQUIRES: asserts + ; This test will enable if targeting x86_64 or x86_64h. + ; REQUIRES-ANY: x86_64, x86_64h ; This test is disabled on Linux. ; UNSUPPORTED: -linux- ; This test is expected to fail on PowerPC. ; XFAIL: powerpc -``REQUIRES`` and ``UNSUPPORTED`` and ``XFAIL`` all accept a comma-separated -list of boolean expressions. The values in each expression may be: +``REQUIRES``, ``REQUIRES-ANY``, ``UNSUPPORTED`` and ``XFAIL`` all accept a +comma-separated list of boolean expressions. The values in each expression may +be: - Features added to ``config.available_features`` by configuration files such as ``lit.cfg``. - Substrings of the target triple (``UNSUPPORTED`` and ``XFAIL`` only). | ``REQUIRES`` enables the test if all expressions are true. +| ``REQUIRES-ANY`` enables the test if any expression is true. | ``UNSUPPORTED`` disables the test if any expression is true. | ``XFAIL`` expects the test to fail if any expression is true.