Re: [net-next PATCH 0/4] Documenting eBPF - extended Berkeley Packet Filter

From: Jonathan Corbet
Date: Tue Feb 07 2017 - 11:46:40 EST


On Tue, 7 Feb 2017 17:09:08 +0100
Jesper Dangaard Brouer <brouer@xxxxxxxxxx> wrote:

> > > Question: What kernel tree should this go into???
> > >
> > > If going through Jonathan Corbet, will it appear sooner here???
> > > https://www.kernel.org/doc/html/latest/
>
> What about this question? Or let me ask in another way, what tree is
> https://www.kernel.org/doc/html/latest/ based on?

I believe it's generated from the current -rc. If this stuff goes into
4.11, it should show up there next week.

> Yes, I was also wondering hard where to put it... and a book for
> user-space developer documentation would likely be the right place, but
> it was not there, as you mention ;-)
>
> I'm fine with moving it later under another "book". Linking to it as
> HTML would still be the same right? (https://www.kernel.org/doc/html/latest/bpf/index.html)
> And is the Documentation/bpf/ directory the correct place?

Moving it would change the URL, of course. If we want to avoid that, we
should try to come up with the proper placement from the outset. And we
would want to move it; I really want to clean up the mess that is the
top-level directory.

How about if it goes into Documentation/userspace-guide/bpf ? The
intermediate directory could just be empty for now, I'll put the book
structure into place later on. Then the URL for the BPF guide itself
wouldn't change.

jon