docs: add some test descriptions

Signed-off-by: Thomas Wood <thomas.wood@intel.com>

tests/core_getclient.c

@@ -32,9 +32,8 @@
 
 #include "drmtest.h"
 
-/**
+IGT_TEST_DESCRIPTION("Tests the DRM_IOCTL_GET_CLIENT ioctl.");
- * Checks DRM_IOCTL_GET_CLIENT.
+
- */
 igt_simple_main
 {
 	int fd, ret;

tests/core_getstats.c

@@ -40,6 +40,9 @@
  * I don't care too much about the actual contents, just that the kernel
  * doesn't crash.
  */
+
+IGT_TEST_DESCRIPTION("Tests the DRM_IOCTL_GET_STATS ioctl.");
+
 igt_simple_main
 {
 	int fd, ret;

tests/core_getversion.c

@@ -29,9 +29,9 @@
 #include <sys/ioctl.h>
 #include "drmtest.h"
 
-/**
+IGT_TEST_DESCRIPTION("Tests the DRM_IOCTL_GET_VERSION ioctl and libdrm's "
- * Checks DRM_IOCTL_GET_VERSION and libdrm's drmGetVersion() interface to it.
+		     "drmGetVersion() interface to it.");
- */
+
 igt_simple_main
 {
 	int fd;

tests/kms_3d.c

@@ -27,6 +27,8 @@
 #include "drmtest.h"
 #include "igt_edid.h"
 
+IGT_TEST_DESCRIPTION("Tests 3D mode setting.");
+
 igt_simple_main
 {
 	int drm_fd;

tests/kms_cursor_crc.c

@@ -34,6 +34,14 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION(
+   "Use the display CRC support to validate cursor plane functionality. "
+   "The test will position the cursor plane either fully onscreen, "
+   "partially onscreen, or fully offscreen, using either a fully opaque "
+   "or fully transparent surface. In each case it then reads the PF CRC "
+   "and compares it with the CRC value obtained when the cursor plane "
+   "was disabled.");
+
 #ifndef DRM_CAP_CURSOR_WIDTH
 #define DRM_CAP_CURSOR_WIDTH 0x8
 #endif

tests/kms_fbc_crc.c

@@ -34,6 +34,11 @@
 #include "intel_batchbuffer.h"
 #include "ioctl_wrappers.h"
 
+IGT_TEST_DESCRIPTION(
+   "Performs various write operations to the scanout buffer while FBC is "
+   "enabled. CRC checks will be used to make sure the modifications to scanout "
+   "buffer are detected.");
+
 enum test_mode {
 	TEST_PAGE_FLIP,
 	TEST_MMAP_CPU,

tests/kms_fence_pin_leak.c

@@ -35,6 +35,9 @@
 #include "intel_chipset.h"
 #include "igt_aux.h"
 
+IGT_TEST_DESCRIPTION("Exercises full ppgtt fence pin_count leak in the "
+		     "kernel.");
+
 typedef struct {
 	int drm_fd;
 	uint32_t devid;

tests/kms_flip_event_leak.c

@@ -39,12 +39,12 @@ typedef struct {
 	igt_display_t display;
 } data_t;
 
-/*
+IGT_TEST_DESCRIPTION(
- * This test tries to provoke the kernel to leak a pending page flip event
+    "This test tries to provoke the kernel into leaking a pending page flip "
- * when the fd is closed before the flip has completed. The test itself won't
+    "event when the fd is closed before the flip has completed. The test "
- * fail even if the kernel leaks the event, but the resulting dmesg WARN
+    "itself won't fail even if the kernel leaks the event, but the resulting "
- * will cause piglit to report a failure.
+    "dmesg WARN will indicate a failure.");
- */
+
 static bool test(data_t *data, enum pipe pipe, igt_output_t *output)
 {
 	igt_plane_t *primary;