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

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

2021-02-16 Thread Joe Stringer
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 syscall available today, when I pull the