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

From: Masahiro Yamada
Date: Tue Oct 10 2017 - 20:55:31 EST


2017-10-11 5:09 GMT+09:00 Shuah Khan <shuahkh@xxxxxxxxxxxxxxx>:
> On 10/07/2017 05:24 AM, Masahiro Yamada wrote:
>> 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@xxxxxxxxxxxxxxx>:
>>> Change to enable dochelp run from main make level to make it easier to
>>> use it.
>>>
>>> Signed-off-by: Shuah Khan <shuahkh@xxxxxxxxxxxxxxx>
>>> ---
>>> 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", ...



--
Best Regards
Masahiro Yamada