On Tue, 7 Feb 2017 09:46:08 -0700 Jonathan Corbet <corbet@xxxxxxx> wrote: > 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. I sounds like Daniel (see other email) have bigger plans for what Documentation/BPF/ should contain. E.g. consolidating Documentation/networking/filter.txt which covers the cBPF/eBPF internals. If that is the case (and I like the idea), then it goes beyond a "userspace-guide". And perhaps "BPF" is a "book" of its own? And it seems Daniel is proposing capital-letters BPF for the directory name "Documentation/BPF/"? Any opinions on that? (I'm neutral) -- Best regards, Jesper Dangaard Brouer MSc.CS, Principal Kernel Engineer at Red Hat LinkedIn: http://www.linkedin.com/in/brouer -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
