[igt-dev] [V5 i-g-t 62/81] tests/kms_plane_lowres: Document each subtest for testplan

[B, Jeevan]

> -----Original Message-----
> From: igt-dev <igt-dev-bounces at lists.freedesktop.org> On Behalf Of
> Bhanuprakash Modem
> Sent: Thursday, June 29, 2023 8:19 PM
> To: igt-dev at lists.freedesktop.org
> Subject: [igt-dev] [V5 i-g-t 62/81] tests/kms_plane_lowres: Document each
> subtest for testplan
> 
> Add documentation for all kms tests which is used by IGT testplan
> documentation.
> 
> Signed-off-by: Bhanuprakash Modem <bhanuprakash.modem at intel.com>
LGTM.
Reviewed-by: Jeevan B <jeevan.b at intel.com>

> ---
>  tests/kms_plane_lowres.c | 24 ++++++++++++++++++++++++
>  1 file changed, 24 insertions(+)
> 
> diff --git a/tests/kms_plane_lowres.c b/tests/kms_plane_lowres.c index
> 7aaf83c41..65d1dd183 100644
> --- a/tests/kms_plane_lowres.c
> +++ b/tests/kms_plane_lowres.c
> @@ -22,6 +22,12 @@
>   *
>   */
> 
> +/**
> + * TEST: kms plane lowres
> + * Category: Display
> + * Description: Test atomic mode setting with a plane by switching between
> high
> + *              and low resolutions
> + */
>  #include "igt.h"
>  #include "drmtest.h"
>  #include <errno.h>
> @@ -261,6 +267,24 @@ static void test_cleanup(data_t *data)
>  	igt_display_commit2(&data->display, COMMIT_ATOMIC);  }
> 
> +/**
> + * SUBTEST: tiling-%s
> + * Description: Tests the visibility of the planes when switching between
> high
> + *              and low resolution with %arg[1]
> + * Driver requirement: any
> + * Functionality: plane
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * arg[1]:
> + *
> + * @none:        Linear buffer (no tiling)
> + * @4:           4-tiling
> + * @x:           x-tiling
> + * @y:           y-tiling
> + * @yf:          yf-tiling
> + */
>  static void run_test(data_t *data, uint64_t modifier)  {
>  	enum pipe pipe;
> --
> 2.40.0