Re: [PATCH bpf-next 00/17] Improve BPF syscall command documentation

2021-02-18 Thread Joe Stringer
On Thu, Feb 18, 2021 at 11:49 AM Jonathan Corbet wrote: > > Joe Stringer writes: > > * The changes in patch 16 here extended Documentation/bpf/index.rst, > > but to assist in improving the overall kernel documentation > > organisation / hierarchy, you would prefer to instead introduce a > > dedic

Re: [PATCH bpf-next 00/17] Improve BPF syscall command documentation

2021-02-18 Thread Jonathan Corbet
Joe Stringer writes: > Hey Jon, thanks for the feedback. Absolutely, what you say makes > sense. The intent here wasn't to come up with something new. Based on > your prompt from this email (and a quick look at your KR '19 > presentation), I'm hearing a few observations: > * Storing the documenta

Re: [PATCH bpf-next 00/17] Improve BPF syscall command documentation

2021-02-18 Thread Toke Høiland-Jørgensen
Joe Stringer writes: > On Wed, Feb 17, 2021 at 5:55 AM Toke Høiland-Jørgensen > wrote: >> >> Joe Stringer writes: >> > Given the relative success of the process around bpf-helpers(7) to >> > encourage developers to document their user-facing changes, in this >> > patch series I explore applyin

Re: [PATCH bpf-next 00/17] Improve BPF syscall command documentation

2021-02-17 Thread Joe Stringer
On Wed, Feb 17, 2021 at 9:32 AM Jonathan Corbet wrote: > > [CC += linux-doc] > > Joe Stringer writes: > > > From: Joe Stringer > > > > The state of bpf(2) manual pages today is not exactly ideal. For the > > most part, it was written several years ago and has not kept up with the > > pace of dev

Re: [PATCH bpf-next 00/17] Improve BPF syscall command documentation

2021-02-17 Thread Joe Stringer
On Wed, Feb 17, 2021 at 5:55 AM Toke Høiland-Jørgensen wrote: > > Joe Stringer writes: > > Given the relative success of the process around bpf-helpers(7) to > > encourage developers to document their user-facing changes, in this > > patch series I explore applying this technique to bpf(2) as wel

Re: [PATCH bpf-next 00/17] Improve BPF syscall command documentation

2021-02-17 Thread Jonathan Corbet
[CC += linux-doc] Joe Stringer writes: > From: Joe Stringer > > The state of bpf(2) manual pages today is not exactly ideal. For the > most part, it was written several years ago and has not kept up with the > pace of development in the kernel tree. For instance, out of a total of > ~35 command

Re: [PATCH bpf-next 00/17] Improve BPF syscall command documentation

2021-02-17 Thread Toke Høiland-Jørgensen
Joe Stringer writes: > From: Joe Stringer > > The state of bpf(2) manual pages today is not exactly ideal. For the > most part, it was written several years ago and has not kept up with the > pace of development in the kernel tree. For instance, out of a total of > ~35 commands to the BPF syscal