* [PATCH] Documentation: kbuild: Add document about namespaces
@ 2019-10-07 3:03 Adam Zerella
2019-10-07 4:26 ` yamada.masahiro
0 siblings, 1 reply; 4+ messages in thread
From: Adam Zerella @ 2019-10-07 3:03 UTC (permalink / raw)
Cc: Masahiro Yamada, Michal Marek, Jonathan Corbet, linux-doc, Adam Zerella
Sphinx outputs the following build warning:
Documentation/kbuild/namespaces.rst:
WARNING: document isn't included in any toctree
Assuming this document is intended to be referenced within the
documentation it should be inside the toctree.
Signed-off-by: Adam Zerella <adam.zerella@gmail.com>
---
Documentation/kbuild/index.rst | 1 +
1 file changed, 1 insertion(+)
diff --git a/Documentation/kbuild/index.rst b/Documentation/kbuild/index.rst
index 0f144fad99a6..5dd01997c8ed 100644
--- a/Documentation/kbuild/index.rst
+++ b/Documentation/kbuild/index.rst
@@ -14,6 +14,7 @@ Kernel Build System
kconfig
makefiles
modules
+ namespaces
headers_install
--
2.21.0
^ permalink raw reply related [flat|nested] 4+ messages in thread
* RE: [PATCH] Documentation: kbuild: Add document about namespaces
2019-10-07 3:03 [PATCH] Documentation: kbuild: Add document about namespaces Adam Zerella
@ 2019-10-07 4:26 ` yamada.masahiro
2019-10-07 13:25 ` Jonathan Corbet
0 siblings, 1 reply; 4+ messages in thread
From: yamada.masahiro @ 2019-10-07 4:26 UTC (permalink / raw)
To: adam.zerella; +Cc: michal.lkml, corbet, linux-doc
Hi Adam,
> -----Original Message-----
> From: Adam Zerella <adam.zerella@gmail.com>
> Sent: Monday, October 07, 2019 12:03 PM
> Cc: Yamada, Masahiro/山田 真弘 <yamada.masahiro@socionext.com>;
> Michal Marek <michal.lkml@markovi.net>; Jonathan Corbet
> <corbet@lwn.net>; linux-doc@vger.kernel.org; Adam Zerella
> <adam.zerella@gmail.com>
> Subject: [PATCH] Documentation: kbuild: Add document about namespaces
>
> Sphinx outputs the following build warning:
>
> Documentation/kbuild/namespaces.rst:
> WARNING: document isn't included in any toctree
Oh, I did not notice this file was added to the kbuild directory.
I do not understand why it is related to the build system.
So, I'd rather have this file somewhere else.
Thanks.
> Assuming this document is intended to be referenced within the
> documentation it should be inside the toctree.
>
> Signed-off-by: Adam Zerella <adam.zerella@gmail.com>
> ---
> Documentation/kbuild/index.rst | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/Documentation/kbuild/index.rst
> b/Documentation/kbuild/index.rst
> index 0f144fad99a6..5dd01997c8ed 100644
> --- a/Documentation/kbuild/index.rst
> +++ b/Documentation/kbuild/index.rst
> @@ -14,6 +14,7 @@ Kernel Build System
> kconfig
> makefiles
> modules
> + namespaces
>
> headers_install
>
> --
> 2.21.0
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] Documentation: kbuild: Add document about namespaces
2019-10-07 4:26 ` yamada.masahiro
@ 2019-10-07 13:25 ` Jonathan Corbet
2019-10-07 13:36 ` Matthias Maennich
0 siblings, 1 reply; 4+ messages in thread
From: Jonathan Corbet @ 2019-10-07 13:25 UTC (permalink / raw)
To: yamada.masahiro; +Cc: adam.zerella, michal.lkml, linux-doc, Matthias Maennich
On Mon, 7 Oct 2019 04:26:24 +0000
<yamada.masahiro@socionext.com> wrote:
> > Sphinx outputs the following build warning:
> >
> > Documentation/kbuild/namespaces.rst:
> > WARNING: document isn't included in any toctree
>
>
> Oh, I did not notice this file was added to the kbuild directory.
>
> I do not understand why it is related to the build system.
> So, I'd rather have this file somewhere else.
Yeah, probably it makes sense to move it into the core-api manual.
Matthias (added to CC) do you disagree? If not, maybe Adam you could redo
the patch with the move as well?
Thanks,
jon
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] Documentation: kbuild: Add document about namespaces
2019-10-07 13:25 ` Jonathan Corbet
@ 2019-10-07 13:36 ` Matthias Maennich
0 siblings, 0 replies; 4+ messages in thread
From: Matthias Maennich @ 2019-10-07 13:36 UTC (permalink / raw)
To: Jonathan Corbet; +Cc: yamada.masahiro, adam.zerella, michal.lkml, linux-doc
On Mon, Oct 07, 2019 at 07:25:38AM -0600, Jonathan Corbet wrote:
>On Mon, 7 Oct 2019 04:26:24 +0000
><yamada.masahiro@socionext.com> wrote:
>
>> > Sphinx outputs the following build warning:
>> >
>> > Documentation/kbuild/namespaces.rst:
>> > WARNING: document isn't included in any toctree
>>
>>
>> Oh, I did not notice this file was added to the kbuild directory.
>>
>> I do not understand why it is related to the build system.
>> So, I'd rather have this file somewhere else.
>
>Yeah, probably it makes sense to move it into the core-api manual.
>Matthias (added to CC) do you disagree? If not, maybe Adam you could redo
>the patch with the move as well?
I am happy to follow a good suggestion as I wasn't sure about the
location in the first place.
Cheers,
Matthias
>
>Thanks,
>
>jon
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2019-10-07 13:36 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-10-07 3:03 [PATCH] Documentation: kbuild: Add document about namespaces Adam Zerella
2019-10-07 4:26 ` yamada.masahiro
2019-10-07 13:25 ` Jonathan Corbet
2019-10-07 13:36 ` Matthias Maennich
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.