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

From: Jesper Dangaard Brouer
Date: Tue Feb 07 2017 - 11:11:11 EST


On Tue, 7 Feb 2017 08:37:17 -0700
Jonathan Corbet <corbet@xxxxxxx> wrote:

> On Tue, 07 Feb 2017 15:30:11 +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?


> > If it will not appear sooner that way, then it's likely best to keep
> > it in sync with the tree that takes eBPF code changes.
>
> I've developed a fairly strong preference for carrying patches touching
> index.rst; otherwise I spend a lot of time explaining merge conflicts to
> Linus.
>
> If the consensus is that this is ready to go, I expect I can squeeze it in
> for 4.11. I'm not too worried about regressions...:)
>
> I haven't actually built it yet, but from a first look it seems like an
> awfully good start. The one thing that comes to mind is that I'm likely
> to want to move it at some point. I'd really like to start a separate
> book for user-space developer documentation, and this would certainly
> belong there. That book doesn't exist yet, though, so I can't quite blame
> you, hard as I might try, for not putting this document there.

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?

--
Best regards,
Jesper Dangaard Brouer
MSc.CS, Principal Kernel Engineer at Red Hat
LinkedIn: http://www.linkedin.com/in/brouer