linux-kernel - Re: treewide: replace '---help---' in Kconfig files with 'help'

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <alpine.DEB.2.21.2006151004180.10003@ramsan.of.borg>
Date:   Mon, 15 Jun 2020 10:06:29 +0200 (CEST)
From:   Geert Uytterhoeven <geert@...ux-m68k.org>
To:     Masahiro Yamada <masahiroy@...nel.org>
cc:     linux-kernel@...r.kernel.org
Subject: Re: treewide: replace '---help---' in Kconfig files with 'help'

 	Hi Yamada-san,

On Sat, 13 Jun 2020, Linux Kernel Mailing List wrote:
> Commit:     a7f7f6248d9740d710fd6bd190293fe5e16410ac
> Parent:     e4a42c82e943b97ce124539fcd7a47445b43fa0d
> Refname:    refs/heads/master
> Web:        https://git.kernel.org/torvalds/c/a7f7f6248d9740d710fd6bd190293fe5e16410ac
> Author:     Masahiro Yamada <masahiroy@...nel.org>
> AuthorDate: Sun Jun 14 01:50:22 2020 +0900
> Committer:  Masahiro Yamada <masahiroy@...nel.org>
> CommitDate: Sun Jun 14 01:57:21 2020 +0900
>
>    treewide: replace '---help---' in Kconfig files with 'help'
>
>    Since commit 84af7a6194e4 ("checkpatch: kconfig: prefer 'help' over
>    '---help---'"), the number of '---help---' has been gradually
>    decreasing, but there are still more than 2400 instances.
>
>    This commit finishes the conversion. While I touched the lines,
>    I also fixed the indentation.
>
>    There are a variety of indentation styles found.
>
>      a) 4 spaces + '---help---'
>      b) 7 spaces + '---help---'
>      c) 8 spaces + '---help---'
>      d) 1 space + 1 tab + '---help---'
>      e) 1 tab + '---help---'    (correct indentation)
>      f) 1 tab + 1 space + '---help---'
>      g) 1 tab + 2 spaces + '---help---'
>
>    In order to convert all of them to 1 tab + 'help', I ran the
>    following commend:
>
>      $ find . -name 'Kconfig*' | xargs sed -i 's/^[[:space:]]*---help---/\thelp/'
>
>    Signed-off-by: Masahiro Yamada <masahiroy@...nel.org>
> diff --git a/arch/ia64/Kconfig b/arch/ia64/Kconfig
> index 88b05b5256a9..1fa2fe2ef053 100644
> --- a/arch/ia64/Kconfig
> +++ b/arch/ia64/Kconfig
> @@ -266,7 +266,7 @@ config PERMIT_BSP_REMOVE
> 	bool "Support removal of Bootstrap Processor"
> 	depends on HOTPLUG_CPU
> 	default n
> -	---help---
> +	help
> 	Say Y here if your platform SAL will support removal of BSP with HOTPLUG_CPU
> 	support.
>
> @@ -274,7 +274,7 @@ config FORCE_CPEI_RETARGET
> 	bool "Force assumption that CPEI can be re-targeted"
> 	depends on PERMIT_BSP_REMOVE
> 	default n
> -	---help---
> +	help
> 	Say Y if you need to force the assumption that CPEI can be re-targeted to
> 	any cpu in the system. This hint is available via ACPI 3.0 specifications.
> 	Tiger4 systems are capable of re-directing CPEI to any CPU other than BSP.

I guess help text blocks like the above should be indented?
Unfortunately there are many of them.

Thanks!

Gr{oetje,eeting}s,

 						Geert

--
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@...ux-m68k.org

In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
 							    -- Linus Torvalds