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-prev] [day] [month] [year] [list]

Message-ID: <CAK7LNAQjgvmyRZ=z4EAbSLBB_HF7Ej7D487UYc84po74ukJLRg@mail.gmail.com>
Date:   Fri, 19 Jun 2020 13:36:11 +0900
From:   Masahiro Yamada <masahiroy@...nel.org>
To:     Geert Uytterhoeven <geert@...ux-m68k.org>
Cc:     Linux Kernel Mailing List <linux-kernel@...r.kernel.org>
Subject: Re: treewide: replace '---help---' in Kconfig files with 'help'

On Mon, Jun 15, 2020 at 5:06 PM Geert Uytterhoeven <geert@...ux-m68k.org> wrote:
>
>         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.

Yes, the help body should be indented by 1 tab + 2 spaces,
which is documented in
Documentation/process/coding-style.rst

Since there are too many, I cannot fix them all.


> 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



-- 
Best Regards
Masahiro Yamada