From 696c8f6434c7ec8db64f88125d4a7b31afd130bf Mon Sep 17 00:00:00 2001 From: Daniel Vetter Date: Wed, 14 Aug 2013 18:30:03 +0200 Subject: [PATCH] lib/drmtest: documentation for igt_fixture Signed-off-by: Daniel Vetter --- lib/drmtest.h | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/lib/drmtest.h b/lib/drmtest.h index 79cac57..d246b7d 100644 --- a/lib/drmtest.h +++ b/lib/drmtest.h @@ -175,6 +175,14 @@ void igt_exit(void) __attribute__((noreturn)); */ #define igt_require(expr) do { if (!(expr)) __igt_skip_check(__FILE__, __LINE__, __func__, #expr ); } while (0) +/** + * igt_fixture - annote global test fixture code + * + * Testcase with subtests often need to set up a bunch of global state as the + * common test fixture. To avoid such code interferring with the subtest + * enumeration (e.g. when enumerating on systemes without an intel gpu) such + * blocks should be annotated with igt_fixture. + */ #define igt_fixture if (!igt_only_list_subtests()) /* check functions which auto-skip tests by calling igt_skip() */ -- 2.7.4