[igt-dev] [i-g-t 76/79] tests/kms_vblank: Document each subtest for testplan

[Bhanuprakash Modem]

Add documentation for all kms tests which is used by IGT testplan
documentation.

Signed-off-by: Bhanuprakash Modem <bhanuprakash.modem at intel.com>
---
 tests/kms_vblank.c | 69 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/tests/kms_vblank.c b/tests/kms_vblank.c
index da0ada78e..1849e8cc5 100644
--- a/tests/kms_vblank.c
+++ b/tests/kms_vblank.c
@@ -40,6 +40,75 @@
 #include <sys/wait.h>
 
 #include <drm.h>
+/**
+ * TEST: kms vblank
+ * Category: Display
+ * Description: Test speed of WaitVblank.
+ *
+ * SUBTEST: crtc-id
+ * Description: check the Vblank and flip events works with given crtc id
+ * Driver requirement: any
+ * Functionality: vblank
+ * Mega feature: General Display Features
+ * Run type: FULL
+ * Test category: functionality test
+ *
+ * SUBTEST: invalid
+ * Description: Negative test for vblank request
+ * Driver requirement: any
+ * Functionality: vblank
+ * Mega feature: General Display Features
+ * Run type: FULL
+ * Test category: functionality test
+ *
+ * SUBTEST: pipe-%s-%s
+ * Description: Check if test run while hanging by introducing NOHANG flag (or)
+ *              Check if injected hang is working properly
+ * Driver requirement: any
+ * Functionality: vblank
+ * Mega feature: General Display Features
+ * Run type: FULL
+ * Test category: functionality test
+ *
+ * arg[1]:
+ *
+ * @A:
+ * @B:
+ * @C:
+ * @D:
+ * @E:
+ * @F:
+ * @G:
+ * @H:
+ *
+ * arg[2]:
+ *
+ * @accuracy-idle:
+ * @query-busy:
+ * @query-busy-hang:
+ * @query-forked:
+ * @query-forked-busy:
+ * @query-forked-busy-hang:
+ * @query-forked-hang:
+ * @query-idle:
+ * @query-idle-hang:
+ * @ts-continuation-dpms-rpm:
+ * @ts-continuation-dpms-suspend:
+ * @ts-continuation-idle:
+ * @ts-continuation-idle-hang:
+ * @ts-continuation-modeset:
+ * @ts-continuation-modeset-hang:
+ * @ts-continuation-modeset-rpm:
+ * @ts-continuation-suspend:
+ * @wait-busy:
+ * @wait-busy-hang:
+ * @wait-forked:
+ * @wait-forked-busy:
+ * @wait-forked-busy-hang:
+ * @wait-forked-hang:
+ * @wait-idle:
+ * @wait-idle-hang:
+ */
 
 IGT_TEST_DESCRIPTION("Test speed of WaitVblank.");
 
-- 
2.40.0