Skip to contentSkip to conversation

drm: sti: fix W=1 warnings

PATCH In review Benjamin Gaignard 3 participants 5 messages Sep 9, 2019 – Sep 17, 2019

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 drm: sti: fix W=1 warnings

Fix warnings when W=1.
No code changes, only clean up in sti internal structures and functions descriptions.

---
 drivers/gpu/drm/sti/sti_cursor.c |  2 +-
 drivers/gpu/drm/sti/sti_dvo.c    |  2 +-
 drivers/gpu/drm/sti/sti_gdp.c    |  2 +-
 drivers/gpu/drm/sti/sti_hda.c    |  2 +-
 drivers/gpu/drm/sti/sti_hdmi.c   |  4 ++--
 drivers/gpu/drm/sti/sti_tvout.c  | 10 +++++-----
 drivers/gpu/drm/sti/sti_vtg.c    |  2 +-
 7 files changed, 12 insertions(+), 12 deletions(-)
drivers/gpu/drm/sti/sti_cursor.c +1 -1
index 0bf7c332cf0b..ea64c1dcaf63 100644
@@ -47,7 +47,7 @@ struct dma_pixmap {
 	void *base;
 };
 
-/**
+/*
  * STI Cursor structure
  *
  * @sti_plane:    sti_plane structure
drivers/gpu/drm/sti/sti_dvo.c +1 -1
index 9e6d5d8b7030..c33d0aaee82b 100644
@@ -65,7 +65,7 @@ static struct dvo_config rgb_24bit_de_cfg = {
 	.awg_fwgen_fct = sti_awg_generate_code_data_enable_mode,
 };
 
-/**
+/*
  * STI digital video output structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_gdp.c +1 -1
index 8e926cd6a1c8..11595c748844 100644
@@ -103,7 +103,7 @@ struct sti_gdp_node_list {
 	dma_addr_t btm_field_paddr;
 };
 
-/**
+/*
  * STI GDP structure
  *
  * @sti_plane:          sti_plane structure
drivers/gpu/drm/sti/sti_hda.c +1 -1
index 94e404f13234..3512a94a0fca 100644
@@ -230,7 +230,7 @@ static const struct sti_hda_video_config hda_supported_modes[] = {
 	 AWGi_720x480p_60, NN_720x480p_60, VID_ED}
 };
 
-/**
+/*
  * STI hd analog structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_hdmi.c +2 -2
index f03d617edc4c..87e34f7a6cfe 100644
@@ -333,7 +333,6 @@ static void hdmi_infoframe_reset(struct sti_hdmi *hdmi,
  * Helper to concatenate infoframe in 32 bits word
  *
  * @ptr: pointer on the hdmi internal structure
- * @data: infoframe to write
  * @size: size to write
  */
 static inline unsigned int hdmi_infoframe_subpack(const u8 *ptr, size_t size)
@@ -543,13 +542,14 @@ static int hdmi_vendor_infoframe_config(struct sti_hdmi *hdmi)
 	return 0;
 }
 
+#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
+
 /**
  * Software reset of the hdmi subsystem
  *
  * @hdmi: pointer on the hdmi internal structure
  *
  */
-#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
 static void hdmi_swreset(struct sti_hdmi *hdmi)
 {
 	u32 val;
drivers/gpu/drm/sti/sti_tvout.c +5 -5
index e1b3c8cb7287..b1fc77b150da 100644
@@ -157,9 +157,9 @@ static void tvout_write(struct sti_tvout *tvout, u32 val, int offset)
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @cr_r:
- * @y_g:
- * @cb_b:
+ * @cr_r: red chroma or red order
+ * @y_g: y or green order
+ * @cb_b: blue chroma or blue order
  */
 static void tvout_vip_set_color_order(struct sti_tvout *tvout, int reg,
 				      u32 cr_r, u32 y_g, u32 cb_b)
@@ -214,7 +214,7 @@ static void tvout_vip_set_rnd(struct sti_tvout *tvout, int reg, u32 rnd)
  * @tvout: tvout structure
  * @reg: register to set
  * @main_path: main or auxiliary path
- * @sel_input: selected_input (main/aux + conv)
+ * @video_out: selected_input (main/aux + conv)
  */
 static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
 				    int reg,
@@ -251,7 +251,7 @@ static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @in_vid_signed: used video input format
+ * @in_vid_fmt: used video input format
  */
 static void tvout_vip_set_in_vid_fmt(struct sti_tvout *tvout,
 		int reg, u32 in_vid_fmt)
drivers/gpu/drm/sti/sti_vtg.c +1 -1
index ef4009f11396..0b17ac8a3faa 100644
@@ -121,7 +121,7 @@ struct sti_vtg_sync_params {
 	u32 vsync_off_bot;
 };
 
-/**
+/*
  * STI VTG structure
  *
  * @regs: register mapping
Signature · 1 line
2.15.0
#1 lore raw
Quoted 6 lines · Benjamin Gaignard

Fix warnings when W=1.
No code changes, only clean up in sti internal structures and functions descriptions.

For my own reference, applied on drm-misc-next

Quoted 139 lines
---
 drivers/gpu/drm/sti/sti_cursor.c |  2 +-
 drivers/gpu/drm/sti/sti_dvo.c    |  2 +-
 drivers/gpu/drm/sti/sti_gdp.c    |  2 +-
 drivers/gpu/drm/sti/sti_hda.c    |  2 +-
 drivers/gpu/drm/sti/sti_hdmi.c   |  4 ++--
 drivers/gpu/drm/sti/sti_tvout.c  | 10 +++++-----
 drivers/gpu/drm/sti/sti_vtg.c    |  2 +-
 7 files changed, 12 insertions(+), 12 deletions(-)
drivers/gpu/drm/sti/sti_cursor.c +1 -1
index 0bf7c332cf0b..ea64c1dcaf63 100644
@@ -47,7 +47,7 @@ struct dma_pixmap {
        void *base;
 };
 
-/**
+/*
  * STI Cursor structure
  *
  * @sti_plane:    sti_plane structure
drivers/gpu/drm/sti/sti_dvo.c +1 -1
index 9e6d5d8b7030..c33d0aaee82b 100644
@@ -65,7 +65,7 @@ static struct dvo_config rgb_24bit_de_cfg = {
        .awg_fwgen_fct = sti_awg_generate_code_data_enable_mode,
 };
 
-/**
+/*
  * STI digital video output structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_gdp.c +1 -1
index 8e926cd6a1c8..11595c748844 100644
@@ -103,7 +103,7 @@ struct sti_gdp_node_list {
        dma_addr_t btm_field_paddr;
 };
 
-/**
+/*
  * STI GDP structure
  *
  * @sti_plane:          sti_plane structure
drivers/gpu/drm/sti/sti_hda.c +1 -1
index 94e404f13234..3512a94a0fca 100644
@@ -230,7 +230,7 @@ static const struct sti_hda_video_config hda_supported_modes[] = {
         AWGi_720x480p_60, NN_720x480p_60, VID_ED}
 };
 
-/**
+/*
  * STI hd analog structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_hdmi.c +2 -2
index f03d617edc4c..87e34f7a6cfe 100644
@@ -333,7 +333,6 @@ static void hdmi_infoframe_reset(struct sti_hdmi *hdmi,
  * Helper to concatenate infoframe in 32 bits word
  *
  * @ptr: pointer on the hdmi internal structure
- * @data: infoframe to write
  * @size: size to write
  */
 static inline unsigned int hdmi_infoframe_subpack(const u8 *ptr, size_t size)
@@ -543,13 +542,14 @@ static int hdmi_vendor_infoframe_config(struct sti_hdmi *hdmi)
        return 0;
 }
 
+#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
+
 /**
  * Software reset of the hdmi subsystem
  *
  * @hdmi: pointer on the hdmi internal structure
  *
  */
-#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
 static void hdmi_swreset(struct sti_hdmi *hdmi)
 {
        u32 val;
drivers/gpu/drm/sti/sti_tvout.c +5 -5
index e1b3c8cb7287..b1fc77b150da 100644
@@ -157,9 +157,9 @@ static void tvout_write(struct sti_tvout *tvout, u32 val, int offset)
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @cr_r:
- * @y_g:
- * @cb_b:
+ * @cr_r: red chroma or red order
+ * @y_g: y or green order
+ * @cb_b: blue chroma or blue order
  */
 static void tvout_vip_set_color_order(struct sti_tvout *tvout, int reg,
                                      u32 cr_r, u32 y_g, u32 cb_b)
@@ -214,7 +214,7 @@ static void tvout_vip_set_rnd(struct sti_tvout *tvout, int reg, u32 rnd)
  * @tvout: tvout structure
  * @reg: register to set
  * @main_path: main or auxiliary path
- * @sel_input: selected_input (main/aux + conv)
+ * @video_out: selected_input (main/aux + conv)
  */
 static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
                                    int reg,
@@ -251,7 +251,7 @@ static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @in_vid_signed: used video input format
+ * @in_vid_fmt: used video input format
  */
 static void tvout_vip_set_in_vid_fmt(struct sti_tvout *tvout,
                int reg, u32 in_vid_fmt)
drivers/gpu/drm/sti/sti_vtg.c +1 -2
index ef4009f11396..0b17ac8a3faa 100644
@@ -121,7 +121,7 @@ struct sti_vtg_sync_params {
        u32 vsync_off_bot;
 };
 
-/**
+/*
  * STI VTG structure
  *
  * @regs: register mapping
--
Quoted 2 lines

2.15.0

_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Reviewed-by Benjamin Gaignard
#2 lore raw
Quoted 10 lines · Benjamin Gaignard
Quoted 6 lines · Benjamin Gaignard

Fix warnings when W=1.
No code changes, only clean up in sti internal structures and functions descriptions.

For my own reference, applied on drm-misc-next

Dude seriously no:

Self-review ain't ok in drm-misc, you need someone to ack/double-check/have a look. And given that you had to fabricate your self-review yourself somehow (the tools really don't do that for you) this doesn't look like an accident.

Adding other maintainers.
-Daniel

Quoted 142 lines
Quoted 142 lines
---
 drivers/gpu/drm/sti/sti_cursor.c |  2 +-
 drivers/gpu/drm/sti/sti_dvo.c    |  2 +-
 drivers/gpu/drm/sti/sti_gdp.c    |  2 +-
 drivers/gpu/drm/sti/sti_hda.c    |  2 +-
 drivers/gpu/drm/sti/sti_hdmi.c   |  4 ++--
 drivers/gpu/drm/sti/sti_tvout.c  | 10 +++++-----
 drivers/gpu/drm/sti/sti_vtg.c    |  2 +-
 7 files changed, 12 insertions(+), 12 deletions(-)
drivers/gpu/drm/sti/sti_cursor.c +1 -1
index 0bf7c332cf0b..ea64c1dcaf63 100644
@@ -47,7 +47,7 @@ struct dma_pixmap {
        void *base;
 };
 
-/**
+/*
  * STI Cursor structure
  *
  * @sti_plane:    sti_plane structure
drivers/gpu/drm/sti/sti_dvo.c +1 -1
index 9e6d5d8b7030..c33d0aaee82b 100644
@@ -65,7 +65,7 @@ static struct dvo_config rgb_24bit_de_cfg = {
        .awg_fwgen_fct = sti_awg_generate_code_data_enable_mode,
 };
 
-/**
+/*
  * STI digital video output structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_gdp.c +1 -1
index 8e926cd6a1c8..11595c748844 100644
@@ -103,7 +103,7 @@ struct sti_gdp_node_list {
        dma_addr_t btm_field_paddr;
 };
 
-/**
+/*
  * STI GDP structure
  *
  * @sti_plane:          sti_plane structure
drivers/gpu/drm/sti/sti_hda.c +1 -1
index 94e404f13234..3512a94a0fca 100644
@@ -230,7 +230,7 @@ static const struct sti_hda_video_config hda_supported_modes[] = {
         AWGi_720x480p_60, NN_720x480p_60, VID_ED}
 };
 
-/**
+/*
  * STI hd analog structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_hdmi.c +2 -2
index f03d617edc4c..87e34f7a6cfe 100644
@@ -333,7 +333,6 @@ static void hdmi_infoframe_reset(struct sti_hdmi *hdmi,
  * Helper to concatenate infoframe in 32 bits word
  *
  * @ptr: pointer on the hdmi internal structure
- * @data: infoframe to write
  * @size: size to write
  */
 static inline unsigned int hdmi_infoframe_subpack(const u8 *ptr, size_t size)
@@ -543,13 +542,14 @@ static int hdmi_vendor_infoframe_config(struct sti_hdmi *hdmi)
        return 0;
 }
 
+#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
+
 /**
  * Software reset of the hdmi subsystem
  *
  * @hdmi: pointer on the hdmi internal structure
  *
  */
-#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
 static void hdmi_swreset(struct sti_hdmi *hdmi)
 {
        u32 val;
drivers/gpu/drm/sti/sti_tvout.c +5 -5
index e1b3c8cb7287..b1fc77b150da 100644
@@ -157,9 +157,9 @@ static void tvout_write(struct sti_tvout *tvout, u32 val, int offset)
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @cr_r:
- * @y_g:
- * @cb_b:
+ * @cr_r: red chroma or red order
+ * @y_g: y or green order
+ * @cb_b: blue chroma or blue order
  */
 static void tvout_vip_set_color_order(struct sti_tvout *tvout, int reg,
                                      u32 cr_r, u32 y_g, u32 cb_b)
@@ -214,7 +214,7 @@ static void tvout_vip_set_rnd(struct sti_tvout *tvout, int reg, u32 rnd)
  * @tvout: tvout structure
  * @reg: register to set
  * @main_path: main or auxiliary path
- * @sel_input: selected_input (main/aux + conv)
+ * @video_out: selected_input (main/aux + conv)
  */
 static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
                                    int reg,
@@ -251,7 +251,7 @@ static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @in_vid_signed: used video input format
+ * @in_vid_fmt: used video input format
  */
 static void tvout_vip_set_in_vid_fmt(struct sti_tvout *tvout,
                int reg, u32 in_vid_fmt)
drivers/gpu/drm/sti/sti_vtg.c +1 -2
index ef4009f11396..0b17ac8a3faa 100644
@@ -121,7 +121,7 @@ struct sti_vtg_sync_params {
        u32 vsync_off_bot;
 };
 
-/**
+/*
  * STI VTG structure
  *
  * @regs: register mapping
--

2.15.0

Signature · 7 lines
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
#3 lore raw
Quoted 20 lines · Daniel Vetter
Quoted 10 lines · Benjamin Gaignard
Quoted 6 lines · Benjamin Gaignard

Fix warnings when W=1.
No code changes, only clean up in sti internal structures and functions descriptions.

For my own reference, applied on drm-misc-next

Dude seriously no:

Quoted 8 lines

Self-review ain't ok in drm-misc, you need someone to ack/double-check/have a look. And given that you had to fabricate your self-review yourself somehow (the tools really don't do that for you) this doesn't look like an accident.

Adding other maintainers.
-Daniel

All my apologies, I have taken a shortcut for this STI patch... I will ask to Philippe or Yannick to formally review STI related patches on mailing and not only on internal one.

Benjamin

Quoted 134 lines
Quoted 134 lines
Quoted 134 lines
---
 drivers/gpu/drm/sti/sti_cursor.c |  2 +-
 drivers/gpu/drm/sti/sti_dvo.c    |  2 +-
 drivers/gpu/drm/sti/sti_gdp.c    |  2 +-
 drivers/gpu/drm/sti/sti_hda.c    |  2 +-
 drivers/gpu/drm/sti/sti_hdmi.c   |  4 ++--
 drivers/gpu/drm/sti/sti_tvout.c  | 10 +++++-----
 drivers/gpu/drm/sti/sti_vtg.c    |  2 +-
 7 files changed, 12 insertions(+), 12 deletions(-)
drivers/gpu/drm/sti/sti_cursor.c +1 -1
index 0bf7c332cf0b..ea64c1dcaf63 100644
@@ -47,7 +47,7 @@ struct dma_pixmap {
        void *base;
 };
 
-/**
+/*
  * STI Cursor structure
  *
  * @sti_plane:    sti_plane structure
drivers/gpu/drm/sti/sti_dvo.c +1 -1
index 9e6d5d8b7030..c33d0aaee82b 100644
@@ -65,7 +65,7 @@ static struct dvo_config rgb_24bit_de_cfg = {
        .awg_fwgen_fct = sti_awg_generate_code_data_enable_mode,
 };
 
-/**
+/*
  * STI digital video output structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_gdp.c +1 -1
index 8e926cd6a1c8..11595c748844 100644
@@ -103,7 +103,7 @@ struct sti_gdp_node_list {
        dma_addr_t btm_field_paddr;
 };
 
-/**
+/*
  * STI GDP structure
  *
  * @sti_plane:          sti_plane structure
drivers/gpu/drm/sti/sti_hda.c +1 -1
index 94e404f13234..3512a94a0fca 100644
@@ -230,7 +230,7 @@ static const struct sti_hda_video_config hda_supported_modes[] = {
         AWGi_720x480p_60, NN_720x480p_60, VID_ED}
 };
 
-/**
+/*
  * STI hd analog structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_hdmi.c +2 -2
index f03d617edc4c..87e34f7a6cfe 100644
@@ -333,7 +333,6 @@ static void hdmi_infoframe_reset(struct sti_hdmi *hdmi,
  * Helper to concatenate infoframe in 32 bits word
  *
  * @ptr: pointer on the hdmi internal structure
- * @data: infoframe to write
  * @size: size to write
  */
 static inline unsigned int hdmi_infoframe_subpack(const u8 *ptr, size_t size)
@@ -543,13 +542,14 @@ static int hdmi_vendor_infoframe_config(struct sti_hdmi *hdmi)
        return 0;
 }
 
+#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
+
 /**
  * Software reset of the hdmi subsystem
  *
  * @hdmi: pointer on the hdmi internal structure
  *
  */
-#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
 static void hdmi_swreset(struct sti_hdmi *hdmi)
 {
        u32 val;
drivers/gpu/drm/sti/sti_tvout.c +5 -5
index e1b3c8cb7287..b1fc77b150da 100644
@@ -157,9 +157,9 @@ static void tvout_write(struct sti_tvout *tvout, u32 val, int offset)
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @cr_r:
- * @y_g:
- * @cb_b:
+ * @cr_r: red chroma or red order
+ * @y_g: y or green order
+ * @cb_b: blue chroma or blue order
  */
 static void tvout_vip_set_color_order(struct sti_tvout *tvout, int reg,
                                      u32 cr_r, u32 y_g, u32 cb_b)
@@ -214,7 +214,7 @@ static void tvout_vip_set_rnd(struct sti_tvout *tvout, int reg, u32 rnd)
  * @tvout: tvout structure
  * @reg: register to set
  * @main_path: main or auxiliary path
- * @sel_input: selected_input (main/aux + conv)
+ * @video_out: selected_input (main/aux + conv)
  */
 static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
                                    int reg,
@@ -251,7 +251,7 @@ static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @in_vid_signed: used video input format
+ * @in_vid_fmt: used video input format
  */
 static void tvout_vip_set_in_vid_fmt(struct sti_tvout *tvout,
                int reg, u32 in_vid_fmt)
drivers/gpu/drm/sti/sti_vtg.c +0 -0
index ef4009f11396..0b17ac8a3faa 100644
@@ -121,7 +121,7 @@ struct sti_vtg_sync_params {
        u32 vsync_off_bot;
 };
 
Quoted 13 lines
Quoted 8 lines
Quoted 8 lines
drivers/gpu/drm/sti/sti_vtg.c +1 -2
-/**
+/*
  * STI VTG structure
  *
  * @regs: register mapping
--

2.15.0

--
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch

_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

#4 lore raw
Quoted 27 lines · Benjamin Gaignard
Quoted 25 lines · Daniel Vetter
Quoted 10 lines · Benjamin Gaignard
Quoted 6 lines · Benjamin Gaignard

Fix warnings when W=1.
No code changes, only clean up in sti internal structures and functions descriptions.

For my own reference, applied on drm-misc-next

Dude seriously no:

Self-review ain't ok in drm-misc, you need someone to ack/double-check/have a look. And given that you had to fabricate your self-review yourself somehow (the tools really don't do that for you) this doesn't look like an accident.

Quoted 7 lines
Quoted 3 lines

Adding other maintainers.
-Daniel

All my apologies, I have taken a shortcut for this STI patch... I will ask to Philippe or Yannick to formally review STI related patches on mailing and not only on internal one.

Note we don't require full formal review, that's just overkill. But a quick ack shouldn't bee too much for any driver with more than 1 person working on it.

Also pls no internal review, because review is about learning and sharing knowledge, and code correctness only secondary. If you do that behind closed doors you forgoe most of the benefits. -Daniel

Quoted 150 lines

Benjamin

Quoted 147 lines
Quoted 134 lines
Quoted 134 lines
---
 drivers/gpu/drm/sti/sti_cursor.c |  2 +-
 drivers/gpu/drm/sti/sti_dvo.c    |  2 +-
 drivers/gpu/drm/sti/sti_gdp.c    |  2 +-
 drivers/gpu/drm/sti/sti_hda.c    |  2 +-
 drivers/gpu/drm/sti/sti_hdmi.c   |  4 ++--
 drivers/gpu/drm/sti/sti_tvout.c  | 10 +++++-----
 drivers/gpu/drm/sti/sti_vtg.c    |  2 +-
 7 files changed, 12 insertions(+), 12 deletions(-)
drivers/gpu/drm/sti/sti_cursor.c +1 -1
index 0bf7c332cf0b..ea64c1dcaf63 100644
@@ -47,7 +47,7 @@ struct dma_pixmap {
        void *base;
 };
 
-/**
+/*
  * STI Cursor structure
  *
  * @sti_plane:    sti_plane structure
drivers/gpu/drm/sti/sti_dvo.c +1 -1
index 9e6d5d8b7030..c33d0aaee82b 100644
@@ -65,7 +65,7 @@ static struct dvo_config rgb_24bit_de_cfg = {
        .awg_fwgen_fct = sti_awg_generate_code_data_enable_mode,
 };
 
-/**
+/*
  * STI digital video output structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_gdp.c +1 -1
index 8e926cd6a1c8..11595c748844 100644
@@ -103,7 +103,7 @@ struct sti_gdp_node_list {
        dma_addr_t btm_field_paddr;
 };
 
-/**
+/*
  * STI GDP structure
  *
  * @sti_plane:          sti_plane structure
drivers/gpu/drm/sti/sti_hda.c +1 -1
index 94e404f13234..3512a94a0fca 100644
@@ -230,7 +230,7 @@ static const struct sti_hda_video_config hda_supported_modes[] = {
         AWGi_720x480p_60, NN_720x480p_60, VID_ED}
 };
 
-/**
+/*
  * STI hd analog structure
  *
  * @dev: driver device
drivers/gpu/drm/sti/sti_hdmi.c +2 -2
index f03d617edc4c..87e34f7a6cfe 100644
@@ -333,7 +333,6 @@ static void hdmi_infoframe_reset(struct sti_hdmi *hdmi,
  * Helper to concatenate infoframe in 32 bits word
  *
  * @ptr: pointer on the hdmi internal structure
- * @data: infoframe to write
  * @size: size to write
  */
 static inline unsigned int hdmi_infoframe_subpack(const u8 *ptr, size_t size)
@@ -543,13 +542,14 @@ static int hdmi_vendor_infoframe_config(struct sti_hdmi *hdmi)
        return 0;
 }
 
+#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
+
 /**
  * Software reset of the hdmi subsystem
  *
  * @hdmi: pointer on the hdmi internal structure
  *
  */
-#define HDMI_TIMEOUT_SWRESET  100   /*milliseconds */
 static void hdmi_swreset(struct sti_hdmi *hdmi)
 {
        u32 val;
drivers/gpu/drm/sti/sti_tvout.c +5 -5
index e1b3c8cb7287..b1fc77b150da 100644
@@ -157,9 +157,9 @@ static void tvout_write(struct sti_tvout *tvout, u32 val, int offset)
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @cr_r:
- * @y_g:
- * @cb_b:
+ * @cr_r: red chroma or red order
+ * @y_g: y or green order
+ * @cb_b: blue chroma or blue order
  */
 static void tvout_vip_set_color_order(struct sti_tvout *tvout, int reg,
                                      u32 cr_r, u32 y_g, u32 cb_b)
@@ -214,7 +214,7 @@ static void tvout_vip_set_rnd(struct sti_tvout *tvout, int reg, u32 rnd)
  * @tvout: tvout structure
  * @reg: register to set
  * @main_path: main or auxiliary path
- * @sel_input: selected_input (main/aux + conv)
+ * @video_out: selected_input (main/aux + conv)
  */
 static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
                                    int reg,
@@ -251,7 +251,7 @@ static void tvout_vip_set_sel_input(struct sti_tvout *tvout,
  *
  * @tvout: tvout structure
  * @reg: register to set
- * @in_vid_signed: used video input format
+ * @in_vid_fmt: used video input format
  */
 static void tvout_vip_set_in_vid_fmt(struct sti_tvout *tvout,
                int reg, u32 in_vid_fmt)
drivers/gpu/drm/sti/sti_vtg.c +0 -0
index ef4009f11396..0b17ac8a3faa 100644
@@ -121,7 +121,7 @@ struct sti_vtg_sync_params {
        u32 vsync_off_bot;
 };
 
Quoted 8 lines
Quoted 8 lines
drivers/gpu/drm/sti/sti_vtg.c +1 -2
-/**
+/*
  * STI VTG structure
  *
  * @regs: register mapping
--

2.15.0

--
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch

Signature · 3 lines
Daniel Vetter
Software Engineer, Intel Corporation
+41 (0) 79 365 57 48 - http://blog.ffwll.ch