[PATCH 02/11] video: fbdev: kconfig: Remove blank help text

Subsystems: framebuffer layer, the rest

STALE3075d

7 messages, 3 authors, 2018-03-12 · open the first message on its own page

[PATCH 02/11] video: fbdev: kconfig: Remove blank help text

From: Ulf Magnusson <hidden>
Date: 2018-01-31 09:35:29

Blank help texts are probably either a typo, a Kconfig misunderstanding,
or some kind of half-committing to adding a help text (in which case a
TODO comment would be clearer, if the help text really can't be added
right away).

Best to remove them, IMO.

Signed-off-by: Ulf Magnusson <redacted>
---
 drivers/video/fbdev/Kconfig | 1 -
 1 file changed, 1 deletion(-)
diff --git a/drivers/video/fbdev/Kconfig b/drivers/video/fbdev/Kconfig
index 6962b4583fd7..11e699f1062b 100644
--- a/drivers/video/fbdev/Kconfig
+++ b/drivers/video/fbdev/Kconfig
@@ -1156,7 +1156,6 @@ config FB_I810_I2C
 	bool "Enable DDC Support"
 	depends on FB_I810 && FB_I810_GTF
 	select FB_DDC
-	help
 
 config FB_LE80578
 	tristate "Intel LE80578 (Vermilion) support"
-- 
2.14.1

Re: [PATCH 02/11] video: fbdev: kconfig: Remove blank help text

From: Bartlomiej Zolnierkiewicz <hidden>
Date: 2018-02-01 15:52:54

Hi,

On Wednesday, January 31, 2018 10:34:21 AM Ulf Magnusson wrote:
Blank help texts are probably either a typo, a Kconfig misunderstanding,
or some kind of half-committing to adding a help text (in which case a
TODO comment would be clearer, if the help text really can't be added
right away).

Best to remove them, IMO.
How about actually adding some meaningful help texts instead
(as a general rule each user visible option should have valid
help text)?
quoted hunk
Signed-off-by: Ulf Magnusson <redacted>
---
 drivers/video/fbdev/Kconfig | 1 -
 1 file changed, 1 deletion(-)
diff --git a/drivers/video/fbdev/Kconfig b/drivers/video/fbdev/Kconfig
index 6962b4583fd7..11e699f1062b 100644
--- a/drivers/video/fbdev/Kconfig
+++ b/drivers/video/fbdev/Kconfig
@@ -1156,7 +1156,6 @@ config FB_I810_I2C
 	bool "Enable DDC Support"
 	depends on FB_I810 && FB_I810_GTF
 	select FB_DDC
-	help
Please add a missing help text instead (take a look at FB_SAVAGE_I2C
config option to see how a valid help text entry should look like).

In the longer term we should consider removing *_I2C config options
and just make the main config options always enable I2C subsystem
directly if needed/useful (some fbdev drivers are doing it this way
already).
 config FB_LE80578
 	tristate "Intel LE80578 (Vermilion) support"
Best regards,
--
Bartlomiej Zolnierkiewicz
Samsung R&D Institute Poland
Samsung Electronics

Re: [PATCH 02/11] video: fbdev: kconfig: Remove blank help text

From: Ulf Magnusson <hidden>
Date: 2018-02-01 16:56:22

On Thu, Feb 1, 2018 at 4:52 PM, Bartlomiej Zolnierkiewicz
[off-list ref] wrote:
Hi,

On Wednesday, January 31, 2018 10:34:21 AM Ulf Magnusson wrote:
quoted
Blank help texts are probably either a typo, a Kconfig misunderstanding,
or some kind of half-committing to adding a help text (in which case a
TODO comment would be clearer, if the help text really can't be added
right away).

Best to remove them, IMO.
How about actually adding some meaningful help texts instead
(as a general rule each user visible option should have valid
help text)?
quoted
Signed-off-by: Ulf Magnusson <redacted>
---
 drivers/video/fbdev/Kconfig | 1 -
 1 file changed, 1 deletion(-)
diff --git a/drivers/video/fbdev/Kconfig b/drivers/video/fbdev/Kconfig
index 6962b4583fd7..11e699f1062b 100644
--- a/drivers/video/fbdev/Kconfig
+++ b/drivers/video/fbdev/Kconfig
@@ -1156,7 +1156,6 @@ config FB_I810_I2C
      bool "Enable DDC Support"
      depends on FB_I810 && FB_I810_GTF
      select FB_DDC
-     help
Please add a missing help text instead (take a look at FB_SAVAGE_I2C
config option to see how a valid help text entry should look like).
The FB_I810_I2C option was added in 74f6ae84b23 ("[PATCH] i810fb: Add
i2c/DDC support"). What do you think about adding this bit from the
commit message as the help text?

  Add DDC/I2C support for i810fb.  This will allow the driver to get display
  information, especially for monitors with fickle timings.

I'm not familiar with this code, so I don't want to do too much
guessing myself. :)
In the longer term we should consider removing *_I2C config options
and just make the main config options always enable I2C subsystem
directly if needed/useful (some fbdev drivers are doing it this way
already).
quoted
 config FB_LE80578
      tristate "Intel LE80578 (Vermilion) support"
Best regards,
--
Bartlomiej Zolnierkiewicz
Samsung R&D Institute Poland
Samsung Electronics
Cheers,
Ulf

Re: [PATCH 02/11] video: fbdev: kconfig: Remove blank help text

From: Masahiro Yamada <hidden>
Date: 2018-02-01 17:08:59

2018-02-02 1:56 GMT+09:00 Ulf Magnusson [off-list ref]:
On Thu, Feb 1, 2018 at 4:52 PM, Bartlomiej Zolnierkiewicz
[off-list ref] wrote:
quoted
Hi,

On Wednesday, January 31, 2018 10:34:21 AM Ulf Magnusson wrote:
quoted
Blank help texts are probably either a typo, a Kconfig misunderstanding,
or some kind of half-committing to adding a help text (in which case a
TODO comment would be clearer, if the help text really can't be added
right away).

Best to remove them, IMO.
FYI.

I picked up this patch to kbuild
because I need this to suppress warning messages
introduced by 11/11.

I am planning to send a PR for this series.


-- 
Best Regards
Masahiro Yamada

Re: [PATCH 02/11] video: fbdev: kconfig: Remove blank help text

From: Bartlomiej Zolnierkiewicz <hidden>
Date: 2018-02-13 12:31:56

On Thursday, February 01, 2018 05:56:18 PM Ulf Magnusson wrote:
On Thu, Feb 1, 2018 at 4:52 PM, Bartlomiej Zolnierkiewicz
[off-list ref] wrote:
quoted
Hi,

On Wednesday, January 31, 2018 10:34:21 AM Ulf Magnusson wrote:
quoted
Blank help texts are probably either a typo, a Kconfig misunderstanding,
or some kind of half-committing to adding a help text (in which case a
TODO comment would be clearer, if the help text really can't be added
right away).

Best to remove them, IMO.
How about actually adding some meaningful help texts instead
(as a general rule each user visible option should have valid
help text)?
quoted
Signed-off-by: Ulf Magnusson <redacted>
---
 drivers/video/fbdev/Kconfig | 1 -
 1 file changed, 1 deletion(-)
diff --git a/drivers/video/fbdev/Kconfig b/drivers/video/fbdev/Kconfig
index 6962b4583fd7..11e699f1062b 100644
--- a/drivers/video/fbdev/Kconfig
+++ b/drivers/video/fbdev/Kconfig
@@ -1156,7 +1156,6 @@ config FB_I810_I2C
      bool "Enable DDC Support"
      depends on FB_I810 && FB_I810_GTF
      select FB_DDC
-     help
Please add a missing help text instead (take a look at FB_SAVAGE_I2C
config option to see how a valid help text entry should look like).
The FB_I810_I2C option was added in 74f6ae84b23 ("[PATCH] i810fb: Add
i2c/DDC support"). What do you think about adding this bit from the
commit message as the help text?

  Add DDC/I2C support for i810fb.  This will allow the driver to get display
  information, especially for monitors with fickle timings.
Seems fine to me, please add:

    If unsure, say Y.

and send it as a proper patch.
I'm not familiar with this code, so I don't want to do too much
guessing myself. :)
:)
quoted
In the longer term we should consider removing *_I2C config options
and just make the main config options always enable I2C subsystem
directly if needed/useful (some fbdev drivers are doing it this way
already).
quoted
 config FB_LE80578
      tristate "Intel LE80578 (Vermilion) support"
Best regards,
--
Bartlomiej Zolnierkiewicz
Samsung R&D Institute Poland
Samsung Electronics
Cheers,
Ulf
Best regards,
--
Bartlomiej Zolnierkiewicz
Samsung R&D Institute Poland
Samsung Electronics

[PATCH] video: fbdev: kconfig: Add help text to FB_I810_I2C

From: Ulf Magnusson <hidden>
Date: 2018-02-13 14:02:57

The FB_I810_I2C symbol previously had a blank help text, which was
removed in e9829ac4e5fd ("video: fbdev: kconfig: Remove blank help
text").

Give it a proper help text, derived from commit 74f6ae84b23 ("[PATCH]
i810fb: Add > i2c/DDC support").

Signed-off-by: Ulf Magnusson <redacted>
---
Note: The removal of the blank help text is already in Linus' tree.

 drivers/video/fbdev/Kconfig | 5 +++++
 1 file changed, 5 insertions(+)
diff --git a/drivers/video/fbdev/Kconfig b/drivers/video/fbdev/Kconfig
index 11e699f1062b..c691f1489bb7 100644
--- a/drivers/video/fbdev/Kconfig
+++ b/drivers/video/fbdev/Kconfig
@@ -1156,6 +1156,11 @@ config FB_I810_I2C
 	bool "Enable DDC Support"
 	depends on FB_I810 && FB_I810_GTF
 	select FB_DDC
+	help
+	  Add DDC/I2C support for i810fb.  This will allow the driver to get
+	  display information, especially for monitors with fickle timings.
+
+	  If unsure, say Y.
 
 config FB_LE80578
 	tristate "Intel LE80578 (Vermilion) support"
-- 
2.14.1

Re: [PATCH] video: fbdev: kconfig: Add help text to FB_I810_I2C

From: Bartlomiej Zolnierkiewicz <hidden>
Date: 2018-03-12 15:09:02

On Tuesday, February 13, 2018 03:02:48 PM Ulf Magnusson wrote:
The FB_I810_I2C symbol previously had a blank help text, which was
removed in e9829ac4e5fd ("video: fbdev: kconfig: Remove blank help
text").

Give it a proper help text, derived from commit 74f6ae84b23 ("[PATCH]
i810fb: Add > i2c/DDC support").

Signed-off-by: Ulf Magnusson <redacted>
Patch queued for 4.17, thanks.

Best regards,
--
Bartlomiej Zolnierkiewicz
Samsung R&D Institute Poland
Samsung Electronics
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help