Re: [alsa-devel] [RFC PATCH 3/7] ASoC: Intel: document what Kconfig options do

From: Takashi Iwai
Date: Tue Nov 21 2017 - 12:09:55 EST


On Sat, 18 Nov 2017 01:01:58 +0100,
Pierre-Louis Bossart wrote:
>
> Document what the options are supposed to mean, before clean-up in
> next patch.
>
> No functionality change here.
>
> Signed-off-by: Pierre-Louis Bossart <pierre-louis.bossart@xxxxxxxxxxxxxxx>
> ---
> sound/soc/intel/Kconfig | 20 +++++++++++++++++---
> 1 file changed, 17 insertions(+), 3 deletions(-)
>
> diff --git a/sound/soc/intel/Kconfig b/sound/soc/intel/Kconfig
> index 175b2965ca21..136426d60da0 100644
> --- a/sound/soc/intel/Kconfig
> +++ b/sound/soc/intel/Kconfig
> @@ -15,16 +15,30 @@ if SND_SOC_INTEL_SST_TOPLEVEL
>
> config SND_SST_IPC
> tristate
> + help
> + This option controls the IPC core for HiFi2 platforms

A help section for non-selectable config is fine, per se, but in most
cases it's written as a comment.

And, if we do add the help text, it's more important to do that for
selectable items. Currently the help texts are missing for the
platform configs like SND_SOC_INTEL_HASWELL.


thanks,

Takashi