[igt-dev] [V5, i-g-t, 35/81] tests/kms_atomic_interruptible: Document each subtest for testplan

[Gupta, Nidhi1]

LGTM
Reviewed-by: Nidhi Gupta <nidhi1.gupta at intel.com>

On 6/29/2023 8:18 PM, Bhanuprakash Modem wrote:
> 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_atomic_interruptible.c | 50 ++++++++++++++++++++++++++++++++
>   1 file changed, 50 insertions(+)
> 
> diff --git a/tests/kms_atomic_interruptible.c b/tests/kms_atomic_interruptible.c
> index 2acdcb29d..10bfa6c1b 100644
> --- a/tests/kms_atomic_interruptible.c
> +++ b/tests/kms_atomic_interruptible.c
> @@ -21,6 +21,11 @@
>    * IN THE SOFTWARE.
>    */
>   
> +/**
> + * TEST: kms atomic interruptible
> + * Category: Display
> + * Description: Tests that interrupt various atomic ioctls.
> + */
>   #include <signal.h>
>   
>   #include "igt.h"
> @@ -74,6 +79,51 @@ static drmEventContext drm_events = {
>   	.page_flip_handler = ev_page_flip
>   };
>   
> +/**
> + * SUBTEST: %s-setmode
> + * Description: Tests the interrupt properties of %arg[1] modeset
> + * Driver requirement: any
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * arg[1]:
> + *
> + * @atomic:      atomic
> + * @legacy:      legacy
> + */
> +
> +/**
> + * SUBTEST: legacy-%s
> + * Description: Tests the interrupt properties for %arg[1]
> + * Driver requirement: any
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * arg[1]:
> + *
> + * @cursor:         Cursor
> + * @dpms:           DPMS
> + * @pageflip:       Page flip
> + */
> +
> +/**
> + * SUBTEST: universal-setplane-%s
> + * Description: Tests the interrupt properties for %arg[1]
> + * Driver requirement: any
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * arg[1]:
> + *
> + * @cursor:         Cursor plane
> + * @primary:        Primary plane
> + */
>   static void run_plane_test(igt_display_t *display, enum pipe pipe, igt_output_t *output,
>   			   enum plane_test_type test_type, unsigned plane_type)
>   {

-- 
~Nidhi Gupta