drm/amd/display: kernel-doc: document mpc_color_caps.num_rmcm_3dluts

[PATCH] drm/amd/display: kernel-doc: document mpc_color_caps.num_rmcm_3dluts

Posted by Akiyoshi Kurita 4 months, 2 weeks ago

Add the missing @num_rmcm_3dluts field description to silence a
kernel-doc warning. While here, fix a typo in the same block
("pre-definied" -> "pre-defined") and clarify the oGAM description.

No functional change.

Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
---
 drivers/gpu/drm/amd/display/dc/dc.h | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/drivers/gpu/drm/amd/display/dc/dc.h b/drivers/gpu/drm/amd/display/dc/dc.h
index f24e1da68269..144de7b3ed49 100644
--- a/drivers/gpu/drm/amd/display/dc/dc.h
+++ b/drivers/gpu/drm/amd/display/dc/dc.h
@@ -231,12 +231,12 @@ struct lut3d_caps {
  * plane combined blocks
  *
  * @gamut_remap: color transformation matrix
- * @ogam_ram: programmable out gamma LUT
+ * @ogam_ram: programmable output gamma (oGAM) LUT
  * @ocsc: output color space conversion matrix
  * @num_3dluts: MPC 3D LUT; always assumes a preceding shaper LUT
- * @shared_3d_lut: shared 3D LUT flag. Can be either DPP or MPC, but single
- * instance
- * @ogam_rom_caps: pre-definied curve caps for regamma 1D LUT
+ * @num_rmcm_3dluts: number of RMCM 3D LUT instances supported by MPC (0 if unsupported)
+ * @shared_3d_lut: shared 3D LUT flag. Can be either DPP or MPC, but single instance
+ * @ogam_rom_caps: pre-defined curve caps for regamma 1D LUT
  * @mcm_3d_lut_caps: HW support cap for MCM LUT memory
  * @rmcm_3d_lut_caps: HW support cap for RMCM LUT memory
  * @preblend: whether color manager supports preblend with MPC
-- 
2.47.3

Re: [PATCH] drm/amd/display: kernel-doc: document mpc_color_caps.num_rmcm_3dluts

Posted by Alex Hung 4 months, 1 week ago

kernel-doc for num_rmcm_3dluts is updated in the following commit in 
amd-staging-drm-next:

380366f6d35d drm/amd/display: Document num_rmcm_3dluts in mpc_color_caps

On 9/19/25 14:30, Akiyoshi Kurita wrote:
> Add the missing @num_rmcm_3dluts field description to silence a
> kernel-doc warning. While here, fix a typo in the same block
> ("pre-definied" -> "pre-defined") and clarify the oGAM description.
> 
> No functional change.
> 
> Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
> ---
>   drivers/gpu/drm/amd/display/dc/dc.h | 8 ++++----
>   1 file changed, 4 insertions(+), 4 deletions(-)
> 
> diff --git a/drivers/gpu/drm/amd/display/dc/dc.h b/drivers/gpu/drm/amd/display/dc/dc.h
> index f24e1da68269..144de7b3ed49 100644
> --- a/drivers/gpu/drm/amd/display/dc/dc.h
> +++ b/drivers/gpu/drm/amd/display/dc/dc.h
> @@ -231,12 +231,12 @@ struct lut3d_caps {
>    * plane combined blocks
>    *
>    * @gamut_remap: color transformation matrix
> - * @ogam_ram: programmable out gamma LUT
> + * @ogam_ram: programmable output gamma (oGAM) LUT
>    * @ocsc: output color space conversion matrix
>    * @num_3dluts: MPC 3D LUT; always assumes a preceding shaper LUT
> - * @shared_3d_lut: shared 3D LUT flag. Can be either DPP or MPC, but single
> - * instance
> - * @ogam_rom_caps: pre-definied curve caps for regamma 1D LUT
> + * @num_rmcm_3dluts: number of RMCM 3D LUT instances supported by MPC (0 if unsupported)
> + * @shared_3d_lut: shared 3D LUT flag. Can be either DPP or MPC, but single instance
> + * @ogam_rom_caps: pre-defined curve caps for regamma 1D LUT
>    * @mcm_3d_lut_caps: HW support cap for MCM LUT memory
>    * @rmcm_3d_lut_caps: HW support cap for RMCM LUT memory
>    * @preblend: whether color manager supports preblend with MPC