* [PATCH] drm/amd/display: dc.h: eliminate kernel-doc warnings
@ 2023-07-12 2:23 Randy Dunlap
2023-07-12 13:57 ` Harry Wentland
0 siblings, 1 reply; 3+ messages in thread
From: Randy Dunlap @ 2023-07-12 2:23 UTC (permalink / raw)
To: linux-kernel
Cc: Randy Dunlap, Harry Wentland, Leo Li, Rodrigo Siqueira,
Aurabindo Pillai, Alex Deucher, amd-gfx, Christian König,
Pan, Xinhui, dri-devel
Quash 175 kernel-doc warnings in dc.h by unmarking 2 struct
comments as containing kernel-doc notation and by spelling one
struct field correctly in a kernel-doc comment.
Fixes: 1682bd1a6b5f ("drm/amd/display: Expand kernel doc for DC")
Fixes: ea76895ffab1 ("drm/amd/display: Document pipe split policy")
Fixes: f6ae69f49fcf ("drm/amd/display: Include surface of unaffected streams")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Harry Wentland <harry.wentland@amd.com>
Cc: Leo Li <sunpeng.li@amd.com>
Cc: Rodrigo Siqueira <Rodrigo.Siqueira@amd.com>
Cc: Aurabindo Pillai <aurabindo.pillai@amd.com>
Cc: Alex Deucher <alexander.deucher@amd.com>
Cc: amd-gfx@lists.freedesktop.org
Cc: Alex Deucher <alexander.deucher@amd.com>
Cc: Christian König <christian.koenig@amd.com>
Cc: "Pan, Xinhui" <Xinhui.Pan@amd.com>
Cc: dri-devel@lists.freedesktop.org
---
drivers/gpu/drm/amd/display/dc/dc.h | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff -- a/drivers/gpu/drm/amd/display/dc/dc.h b/drivers/gpu/drm/amd/display/dc/dc.h
--- a/drivers/gpu/drm/amd/display/dc/dc.h
+++ b/drivers/gpu/drm/amd/display/dc/dc.h
@@ -506,7 +506,7 @@ enum dcn_zstate_support_state {
DCN_ZSTATE_SUPPORT_DISALLOW,
};
-/**
+/*
* struct dc_clocks - DC pipe clocks
*
* For any clocks that may differ per pipe only the max is stored in this
@@ -728,7 +728,7 @@ struct resource_pool;
struct dce_hwseq;
struct link_service;
-/**
+/*
* struct dc_debug_options - DC debug struct
*
* This struct provides a simple mechanism for developers to change some
@@ -756,7 +756,7 @@ struct dc_debug_options {
bool use_max_lb;
enum dcc_option disable_dcc;
- /**
+ /*
* @pipe_split_policy: Define which pipe split policy is used by the
* display core.
*/
@@ -1334,7 +1334,7 @@ struct dc_validation_set {
struct dc_stream_state *stream;
/**
- * @plane_state: Surface state
+ * @plane_states: Surface state
*/
struct dc_plane_state *plane_states[MAX_SURFACES];
^ permalink raw reply [flat|nested] 3+ messages in thread* Re: [PATCH] drm/amd/display: dc.h: eliminate kernel-doc warnings
2023-07-12 2:23 [PATCH] drm/amd/display: dc.h: eliminate kernel-doc warnings Randy Dunlap
@ 2023-07-12 13:57 ` Harry Wentland
2023-07-12 14:01 ` Alex Deucher
0 siblings, 1 reply; 3+ messages in thread
From: Harry Wentland @ 2023-07-12 13:57 UTC (permalink / raw)
To: Randy Dunlap, linux-kernel
Cc: Leo Li, Rodrigo Siqueira, Aurabindo Pillai, Alex Deucher,
amd-gfx, Christian König, Pan, Xinhui, dri-devel
On 2023-07-11 22:23, Randy Dunlap wrote:
> Quash 175 kernel-doc warnings in dc.h by unmarking 2 struct
> comments as containing kernel-doc notation and by spelling one
> struct field correctly in a kernel-doc comment.
>
> Fixes: 1682bd1a6b5f ("drm/amd/display: Expand kernel doc for DC")
> Fixes: ea76895ffab1 ("drm/amd/display: Document pipe split policy")
> Fixes: f6ae69f49fcf ("drm/amd/display: Include surface of unaffected streams")
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> Cc: Harry Wentland <harry.wentland@amd.com>
> Cc: Leo Li <sunpeng.li@amd.com>
> Cc: Rodrigo Siqueira <Rodrigo.Siqueira@amd.com>
> Cc: Aurabindo Pillai <aurabindo.pillai@amd.com>
> Cc: Alex Deucher <alexander.deucher@amd.com>
> Cc: amd-gfx@lists.freedesktop.org
> Cc: Alex Deucher <alexander.deucher@amd.com>
> Cc: Christian König <christian.koenig@amd.com>
> Cc: "Pan, Xinhui" <Xinhui.Pan@amd.com>
> Cc: dri-devel@lists.freedesktop.org
Reviewed-by: Harry Wentland <harry.wentland@amd.com>
Harry
> ---
> drivers/gpu/drm/amd/display/dc/dc.h | 8 ++++----
> 1 file changed, 4 insertions(+), 4 deletions(-)
>
> diff -- a/drivers/gpu/drm/amd/display/dc/dc.h b/drivers/gpu/drm/amd/display/dc/dc.h
> --- a/drivers/gpu/drm/amd/display/dc/dc.h
> +++ b/drivers/gpu/drm/amd/display/dc/dc.h
> @@ -506,7 +506,7 @@ enum dcn_zstate_support_state {
> DCN_ZSTATE_SUPPORT_DISALLOW,
> };
>
> -/**
> +/*
> * struct dc_clocks - DC pipe clocks
> *
> * For any clocks that may differ per pipe only the max is stored in this
> @@ -728,7 +728,7 @@ struct resource_pool;
> struct dce_hwseq;
> struct link_service;
>
> -/**
> +/*
> * struct dc_debug_options - DC debug struct
> *
> * This struct provides a simple mechanism for developers to change some
> @@ -756,7 +756,7 @@ struct dc_debug_options {
> bool use_max_lb;
> enum dcc_option disable_dcc;
>
> - /**
> + /*
> * @pipe_split_policy: Define which pipe split policy is used by the
> * display core.
> */
> @@ -1334,7 +1334,7 @@ struct dc_validation_set {
> struct dc_stream_state *stream;
>
> /**
> - * @plane_state: Surface state
> + * @plane_states: Surface state
> */
> struct dc_plane_state *plane_states[MAX_SURFACES];
>
^ permalink raw reply [flat|nested] 3+ messages in thread* Re: [PATCH] drm/amd/display: dc.h: eliminate kernel-doc warnings
2023-07-12 13:57 ` Harry Wentland
@ 2023-07-12 14:01 ` Alex Deucher
0 siblings, 0 replies; 3+ messages in thread
From: Alex Deucher @ 2023-07-12 14:01 UTC (permalink / raw)
To: Harry Wentland
Cc: Randy Dunlap, linux-kernel, Leo Li, Pan, Xinhui,
Rodrigo Siqueira, amd-gfx, Aurabindo Pillai, dri-devel,
Alex Deucher, Christian König
Applied. Thanks!
Alex
On Wed, Jul 12, 2023 at 9:58 AM Harry Wentland <harry.wentland@amd.com> wrote:
>
> On 2023-07-11 22:23, Randy Dunlap wrote:
> > Quash 175 kernel-doc warnings in dc.h by unmarking 2 struct
> > comments as containing kernel-doc notation and by spelling one
> > struct field correctly in a kernel-doc comment.
> >
> > Fixes: 1682bd1a6b5f ("drm/amd/display: Expand kernel doc for DC")
> > Fixes: ea76895ffab1 ("drm/amd/display: Document pipe split policy")
> > Fixes: f6ae69f49fcf ("drm/amd/display: Include surface of unaffected streams")
> > Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> > Cc: Harry Wentland <harry.wentland@amd.com>
> > Cc: Leo Li <sunpeng.li@amd.com>
> > Cc: Rodrigo Siqueira <Rodrigo.Siqueira@amd.com>
> > Cc: Aurabindo Pillai <aurabindo.pillai@amd.com>
> > Cc: Alex Deucher <alexander.deucher@amd.com>
> > Cc: amd-gfx@lists.freedesktop.org
> > Cc: Alex Deucher <alexander.deucher@amd.com>
> > Cc: Christian König <christian.koenig@amd.com>
> > Cc: "Pan, Xinhui" <Xinhui.Pan@amd.com>
> > Cc: dri-devel@lists.freedesktop.org
>
> Reviewed-by: Harry Wentland <harry.wentland@amd.com>
>
> Harry
>
> > ---
> > drivers/gpu/drm/amd/display/dc/dc.h | 8 ++++----
> > 1 file changed, 4 insertions(+), 4 deletions(-)
> >
> > diff -- a/drivers/gpu/drm/amd/display/dc/dc.h b/drivers/gpu/drm/amd/display/dc/dc.h
> > --- a/drivers/gpu/drm/amd/display/dc/dc.h
> > +++ b/drivers/gpu/drm/amd/display/dc/dc.h
> > @@ -506,7 +506,7 @@ enum dcn_zstate_support_state {
> > DCN_ZSTATE_SUPPORT_DISALLOW,
> > };
> >
> > -/**
> > +/*
> > * struct dc_clocks - DC pipe clocks
> > *
> > * For any clocks that may differ per pipe only the max is stored in this
> > @@ -728,7 +728,7 @@ struct resource_pool;
> > struct dce_hwseq;
> > struct link_service;
> >
> > -/**
> > +/*
> > * struct dc_debug_options - DC debug struct
> > *
> > * This struct provides a simple mechanism for developers to change some
> > @@ -756,7 +756,7 @@ struct dc_debug_options {
> > bool use_max_lb;
> > enum dcc_option disable_dcc;
> >
> > - /**
> > + /*
> > * @pipe_split_policy: Define which pipe split policy is used by the
> > * display core.
> > */
> > @@ -1334,7 +1334,7 @@ struct dc_validation_set {
> > struct dc_stream_state *stream;
> >
> > /**
> > - * @plane_state: Surface state
> > + * @plane_states: Surface state
> > */
> > struct dc_plane_state *plane_states[MAX_SURFACES];
> >
>
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2023-07-12 14:02 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-07-12 2:23 [PATCH] drm/amd/display: dc.h: eliminate kernel-doc warnings Randy Dunlap
2023-07-12 13:57 ` Harry Wentland
2023-07-12 14:01 ` Alex Deucher
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®