Re: [PATCH v1 1/1] kbuild: Add "make headers" to "make help" output

[Xin Li <xin@zytor.com>]

On 3/10/2025 7:13 PM, Masahiro Yamada wrote:
> On Tue, Mar 11, 2025 at 10:52 AM Masahiro Yamada <masahiroy@kernel.org> wrote:
>>
>> On Mon, Mar 10, 2025 at 3:23 PM Xin Li <xin@zytor.com> wrote:
>>>
>>> On 3/8/2025 7:12 AM, Masahiro Yamada wrote:
>>>> On Sat, Mar 8, 2025 at 1:05 PM Xin Li (Intel) <xin@zytor.com> wrote:
>>>>>
>>>>> Meanwhile explicitly state that the headers are uapi headers.
>>>>
>>>> There are many internal-use targets, which are not documented in the
>>>> help message.
>>>> I assume this one is the case.
>>>>
>>>> If users want to install UAPI headers, 'headers_install' is
>>>> the user-visible interface and it is already documented.
>>>>
>>>>
>>>
>>> hpa and Boris prefer to add it, which I also agree.  But ofc it's your
>>> call :)
>>>
>>> If you don't want to add help for "headers", it probably still makes
>>> sense to explicitly state that the headers are uapi headers, no?
>>>
>>> Thanks!
>>>       Xin
>>
>>
>> If a help message for "headers" is desired, how about this?
>>
>>    headers  - Build read-to-install uapi headers in usr/include
> 
> 
> 
> 
> For clarification, the following is the rationale.
> 
> 
> Build                 Installation
> -------------------------------------
> vmlinux               install
> modules               modules_install
> dtbs                  dtbs_install
> headers               headers_install
> 
> 
> 
> In Kbuild, the Build and Installation are separate steps,
> since the latter usually requires the root permission.
> 

Oh, I didn't realize, thanks for making it clear.
     Xin