[igt-dev] [i-g-t V8 16/81] tests/i915/kms_dsc: Document each subtest for testplan

[Sharma, Swati2]

LGTM

Reviewed-by: Swati Sharma <swati2.sharma at intel.com>

On 16-Aug-23 4:45 PM, Bhanuprakash Modem wrote:
> Add documentation for all kms tests which is used by IGT testplan
> documentation.
> 
> V2: - Add documentation for dsc-with-output-formats-with-bpc (Swati)
> V3: - Fix test description
>      - Driver requirement: s/any/i915, xe/
> V4: - Optimize test description
> 
> Cc: Swati Sharma <swati2.sharma at intel.com>
> Signed-off-by: Bhanuprakash Modem <bhanuprakash.modem at intel.com>
> ---
>   tests/i915/kms_dsc.c | 25 +++++++++++++++++++++++++
>   1 file changed, 25 insertions(+)
> 
> diff --git a/tests/i915/kms_dsc.c b/tests/i915/kms_dsc.c
> index 5bdac57e2..21f0c5a32 100644
> --- a/tests/i915/kms_dsc.c
> +++ b/tests/i915/kms_dsc.c
> @@ -30,8 +30,33 @@
>    *
>    */
>   
> +/**
> + * TEST: kms dsc
> + * Category: Display
> + * Description: Test to validate display stream compression
> + */
>   #include "kms_dsc_helper.h"
>   
> +/**
> + * SUBTEST: dsc-%s
> + * Description: Tests Display Stream Compression functionality if supported by a
> + *              connector by forcing %arg[1] on all connectors that support it
> + * Driver requirement: i915, xe
> + * Functionality: dsc
> + * Mega feature: VDSC
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * arg[1]:
> + *
> + * @basic:                        DSC with default parameters
> + * @with-bpc:                     DSC with certain input BPC for the connector
> + * @with-bpc-formats:             DSC with certain input BPC for the connector and diff formats
> + * @with-formats:                 DSC with default parameters and creating fb with diff formats
> + * @with-output-formats:          DSC and output format
> + * @with-output-formats-with-bpc: DSC and output format with certain input BPC for the connector
> + */
> +
>   IGT_TEST_DESCRIPTION("Test to validate display stream compression");
>   
>   #define LEN		20