linux-kbuild.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Shuah Khan <shuahkh@osg.samsung.com>
To: Masahiro Yamada <yamada.masahiro@socionext.com>
Cc: Michal Marek <mmarek@suse.com>, Jonathan Corbet <corbet@lwn.net>,
	Linux Kbuild mailing list <linux-kbuild@vger.kernel.org>,
	Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
	Shuah Khan <shuahkh@osg.samsung.com>
Subject: Re: [PATCH] Makefile: enable dochelp run from main make level
Date: Tue, 10 Oct 2017 14:09:21 -0600	[thread overview]
Message-ID: <95c3c8fb-83b3-5d92-f5cc-4cc1cca2913f@osg.samsung.com> (raw)
In-Reply-To: <CAK7LNAS0Zc=_r9wLOssY9hy=d+yGJSew3Maaw_5bGdC=pr6YTw@mail.gmail.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.

thanks,
-- Shuah


  reply	other threads:[~2017-10-10 20:09 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [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 [this message]
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

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=95c3c8fb-83b3-5d92-f5cc-4cc1cca2913f@osg.samsung.com \
    --to=shuahkh@osg.samsung.com \
    --cc=corbet@lwn.net \
    --cc=linux-kbuild@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mmarek@suse.com \
    --cc=yamada.masahiro@socionext.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
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).