linux-kernel - Re: [PATCH] Makefile: enable dochelp run from main make level

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

Message-ID: <21881410-258e-0912-68c3-23c2d24d3ccb@infradead.org>
Date:   Tue, 10 Oct 2017 17:58:03 -0700
From:   Randy Dunlap <rdunlap@...radead.org>
To:     Masahiro Yamada <yamada.masahiro@...ionext.com>,
        Shuah Khan <shuahkh@....samsung.com>
Cc:     Michal Marek <mmarek@...e.com>, Jonathan Corbet <corbet@....net>,
        Linux Kbuild mailing list <linux-kbuild@...r.kernel.org>,
        Linux Kernel Mailing List <linux-kernel@...r.kernel.org>
Subject: Re: [PATCH] Makefile: enable dochelp run from main make level

On 10/10/17 17:54, Masahiro Yamada wrote:
> 2017-10-11 5:09 GMT+09:00 Shuah Khan <shuahkh@....samsung.com>:
>> On 10/07/2017 05:24 AM, Masahiro Yamada wrote:
>>> 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@....samsung.com>:
>>>> Change to enable dochelp run from main make level to make it easier to
>>>> use it.
>>>>
>>>> Signed-off-by: Shuah Khan <shuahkh@....samsung.com>
>>>> ---
>>>>  Makefile | 2 +-
>>>>  1 file changed, 1 insertion(+), 1 deletion(-)
>>>>
>>>> diff --git a/Makefile b/Makefile
>>>> index cf007a31d575..f99d1b36c437 100644
>>>> --- a/Makefile
>>>> +++ b/Makefile
>>>> @@ -1454,7 +1454,7 @@ $(help-board-dirs): help-%:
>>>>
>>>>  # Documentation targets
>>>>  # ---------------------------------------------------------------------------
>>>> -DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs linkcheckdocs
>>>> +DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs linkcheckdocs dochelp
>>>>  PHONY += $(DOC_TARGETS)
>>>>  $(DOC_TARGETS): scripts_basic FORCE
>>>>         $(Q)$(MAKE) $(build)=Documentation $@
>>>> --
>>>> 2.11.0
>>>>
>>>
>>>
>>> The dochelp is invoked from "make help" of the main make level.
>>>
>>> Do you mean "make dochelp" is also necessary?
>>>
>>
>> Right. It is a bit hard to pick out individual help messages from
>> the 'make help' output and it would make it easier to use to enable
>> dochelp.
>>
>> That said, it is your call on whether it would make it cumbersome to
>> support 'make dochlep' and other sub-makefile help targets.
>>
>> I can go either way.
>>
> 
> I thought of this.
> The same thing would apply to "make confighelp", "make pkghelp", ...

Yes, especially confighelp.  I have to use grep, otherwise there is too
much noise.


-- 
~Randy