[igt-dev] [V5, i-g-t, 18/81] tests/i915/kms_fbcon_fbt: 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/i915/kms_fbcon_fbt.c | 42 ++++++++++++++++++++++++++++++++++++++
>   1 file changed, 42 insertions(+)
> 
> diff --git a/tests/i915/kms_fbcon_fbt.c b/tests/i915/kms_fbcon_fbt.c
> index 71c5285f1..990d31a23 100644
> --- a/tests/i915/kms_fbcon_fbt.c
> +++ b/tests/i915/kms_fbcon_fbt.c
> @@ -32,6 +32,48 @@
>   #include <sys/stat.h>
>   #include <fcntl.h>
>   
> +/**
> + * TEST: kms fbcon fbt
> + * Category: Display
> + * Description: Test the relationship between fbcon and the frontbuffer tracking
> + *              infrastructure.
> + *
> + * SUBTEST: fbc
> + * Description: Test the relationship between fbcon and the frontbuffer tracking
> + *              infrastructure with fbc enabled.
> + * Driver requirement: any
> + * Functionality: fbc, fbcon
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: fbc-suspend
> + * Description: Suspend test to validate  the relationship between fbcon and the
> + *              frontbuffer tracking infrastructure with fbc enabled.
> + * Driver requirement: any
> + * Functionality: fbc, fbcon
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: psr
> + * Description: Test the relationship between fbcon and the frontbuffer tracking
> + *              infrastructure with psr enabled.
> + * Driver requirement: any
> + * Functionality: fbcon, psr
> + * Mega feature: PSR
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: psr-suspend
> + * Description: Suspend test to validate the relationship between fbcon and the
> + *              frontbuffer tracking infrastructure with psr enabled.
> + * Driver requirement: any
> + * Functionality: fbcon, psr
> + * Mega feature: PSR
> + * Run type: FULL
> + * Test category: functionality test
> + */
>   
>   IGT_TEST_DESCRIPTION("Test the relationship between fbcon and the frontbuffer "
>   		     "tracking infrastructure.");

-- 
~Nidhi Gupta