* [PATCH] Makefile: enable dochelp run from main make level [not found] <20171002234421.20254-1-shuahkh@osg.samsung.com> @ 2017-10-02 23:44 ` Shuah Khan 2017-10-07 11:24 ` Masahiro Yamada 0 siblings, 1 reply; 8+ messages in thread From: Shuah Khan @ 2017-10-02 23:44 UTC (permalink / raw) To: yamada.masahiro, mmarek, corbet; +Cc: Shuah Khan, linux-kbuild, linux-kernel Change to enable dochelp run from main make level to make it easier to use it. Signed-off-by: Shuah Khan <shuahkh@osg.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 ^ permalink raw reply related [flat|nested] 8+ messages in thread
* Re: [PATCH] Makefile: enable dochelp run from main make level 2017-10-02 23:44 ` [PATCH] Makefile: enable dochelp run from main make level Shuah Khan @ 2017-10-07 11:24 ` Masahiro Yamada 2017-10-10 20:09 ` Shuah Khan 0 siblings, 1 reply; 8+ messages in thread From: Masahiro Yamada @ 2017-10-07 11:24 UTC (permalink / raw) To: Shuah Khan Cc: Michal Marek, Jonathan Corbet, Linux Kbuild mailing list, Linux Kernel Mailing List 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: > Change to enable dochelp run from main make level to make it easier to > use it. > > Signed-off-by: Shuah Khan <shuahkh@osg.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? -- Best Regards Masahiro Yamada ^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Makefile: enable dochelp run from main make level 2017-10-07 11:24 ` Masahiro Yamada @ 2017-10-10 20:09 ` Shuah Khan 2017-10-11 0:54 ` Masahiro Yamada 0 siblings, 1 reply; 8+ messages in thread From: Shuah Khan @ 2017-10-10 20:09 UTC (permalink / raw) To: Masahiro Yamada Cc: Michal Marek, Jonathan Corbet, Linux Kbuild mailing list, Linux Kernel Mailing List, Shuah Khan On 10/07/2017 05:24 AM, Masahiro Yamada wrote: > 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >> Change to enable dochelp run from main make level to make it easier to >> use it. >> >> Signed-off-by: Shuah Khan <shuahkh@osg.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. thanks, -- Shuah ^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Makefile: enable dochelp run from main make level 2017-10-10 20:09 ` Shuah Khan @ 2017-10-11 0:54 ` Masahiro Yamada 2017-10-11 0:58 ` Randy Dunlap 0 siblings, 1 reply; 8+ messages in thread From: Masahiro Yamada @ 2017-10-11 0:54 UTC (permalink / raw) To: Shuah Khan Cc: Michal Marek, Jonathan Corbet, Linux Kbuild mailing list, Linux Kernel Mailing List 2017-10-11 5:09 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: > On 10/07/2017 05:24 AM, Masahiro Yamada wrote: >> 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >>> Change to enable dochelp run from main make level to make it easier to >>> use it. >>> >>> Signed-off-by: Shuah Khan <shuahkh@osg.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", ... -- Best Regards Masahiro Yamada ^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Makefile: enable dochelp run from main make level 2017-10-11 0:54 ` Masahiro Yamada @ 2017-10-11 0:58 ` Randy Dunlap 2017-10-11 1:06 ` Shuah Khan 0 siblings, 1 reply; 8+ messages in thread From: Randy Dunlap @ 2017-10-11 0:58 UTC (permalink / raw) To: Masahiro Yamada, Shuah Khan Cc: Michal Marek, Jonathan Corbet, Linux Kbuild mailing list, Linux Kernel Mailing List On 10/10/17 17:54, Masahiro Yamada wrote: > 2017-10-11 5:09 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >> On 10/07/2017 05:24 AM, Masahiro Yamada wrote: >>> 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >>>> Change to enable dochelp run from main make level to make it easier to >>>> use it. >>>> >>>> Signed-off-by: Shuah Khan <shuahkh@osg.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 ^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Makefile: enable dochelp run from main make level 2017-10-11 0:58 ` Randy Dunlap @ 2017-10-11 1:06 ` Shuah Khan 2017-10-12 18:15 ` Randy Dunlap 2017-10-17 23:57 ` Masahiro Yamada 0 siblings, 2 replies; 8+ messages in thread From: Shuah Khan @ 2017-10-11 1:06 UTC (permalink / raw) To: Randy Dunlap, Masahiro Yamada Cc: Michal Marek, Jonathan Corbet, Linux Kbuild mailing list, Linux Kernel Mailing List, Shuah Khan On 10/10/2017 06:58 PM, Randy Dunlap wrote: > On 10/10/17 17:54, Masahiro Yamada wrote: >> 2017-10-11 5:09 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >>> On 10/07/2017 05:24 AM, Masahiro Yamada wrote: >>>> 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >>>>> Change to enable dochelp run from main make level to make it easier to >>>>> use it. >>>>> >>>>> Signed-off-by: Shuah Khan <shuahkh@osg.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. > > If you would like I can send patches to cover some of these cases. thanks, -- Shuah ^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Makefile: enable dochelp run from main make level 2017-10-11 1:06 ` Shuah Khan @ 2017-10-12 18:15 ` Randy Dunlap 2017-10-17 23:57 ` Masahiro Yamada 1 sibling, 0 replies; 8+ messages in thread From: Randy Dunlap @ 2017-10-12 18:15 UTC (permalink / raw) To: Shuah Khan, Masahiro Yamada Cc: Michal Marek, Jonathan Corbet, Linux Kbuild mailing list, Linux Kernel Mailing List On 10/10/17 18:06, Shuah Khan wrote: > On 10/10/2017 06:58 PM, Randy Dunlap wrote: >> On 10/10/17 17:54, Masahiro Yamada wrote: >>> 2017-10-11 5:09 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >>>> On 10/07/2017 05:24 AM, Masahiro Yamada wrote: >>>>> 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >>>>>> Change to enable dochelp run from main make level to make it easier to >>>>>> use it. >>>>>> >>>>>> Signed-off-by: Shuah Khan <shuahkh@osg.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. >> >> > > If you would like I can send patches to cover some of these cases. I would be happy to see that... thanks, -- ~Randy ^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Makefile: enable dochelp run from main make level 2017-10-11 1:06 ` Shuah Khan 2017-10-12 18:15 ` Randy Dunlap @ 2017-10-17 23:57 ` Masahiro Yamada 1 sibling, 0 replies; 8+ messages in thread From: Masahiro Yamada @ 2017-10-17 23:57 UTC (permalink / raw) To: Shuah Khan Cc: Randy Dunlap, Michal Marek, Jonathan Corbet, Linux Kbuild mailing list, Linux Kernel Mailing List 2017-10-11 10:06 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: > On 10/10/2017 06:58 PM, Randy Dunlap wrote: >> On 10/10/17 17:54, Masahiro Yamada wrote: >>> 2017-10-11 5:09 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >>>> On 10/07/2017 05:24 AM, Masahiro Yamada wrote: >>>>> 2017-10-03 8:44 GMT+09:00 Shuah Khan <shuahkh@osg.samsung.com>: >>>>>> Change to enable dochelp run from main make level to make it easier to >>>>>> use it. >>>>>> >>>>>> Signed-off-by: Shuah Khan <shuahkh@osg.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. >> >> > > If you would like I can send patches to cover some of these cases. > We have a kind of hierarchy when arch/$(SRCARCH)/configs has sub-directories. For example, $ make ARCH=powerpc help [ snip ] storcenter_defconfig - Build for storcenter tqm8xx_defconfig - Build for tqm8xx wii_defconfig - Build for wii help-40x - Show 40x-specific targets help-44x - Show 44x-specific targets help-52xx - Show 52xx-specific targets help-83xx - Show 83xx-specific targets help-85xx - Show 85xx-specific targets help-boards - Show all of the above I think your suggestion is, to keep the top "make help" as-is and add new targets to display subsets. All targets you can run from the top-level must be described in "make help". Maybe like this? confighelp - Show only configuration targets dochelp - Show only documentation targets I feel a bit cumbersome, but I will probably accept it if people think it is useful. -- Best Regards Masahiro Yamada ^ permalink raw reply [flat|nested] 8+ messages in thread
end of thread, other threads:[~2017-10-17 23:58 UTC | newest]
Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
[not found] <20171002234421.20254-1-shuahkh@osg.samsung.com>
2017-10-02 23:44 ` [PATCH] Makefile: enable dochelp run from main make level Shuah Khan
2017-10-07 11:24 ` Masahiro Yamada
2017-10-10 20:09 ` Shuah Khan
2017-10-11 0:54 ` Masahiro Yamada
2017-10-11 0:58 ` Randy Dunlap
2017-10-11 1:06 ` Shuah Khan
2017-10-12 18:15 ` Randy Dunlap
2017-10-17 23:57 ` Masahiro Yamada
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).