On Tue, Mar 2, 2021 at 9:20 AM Joe Stringer <joe@xxxxxxxxx> wrote: > > Rather than tackle everything at once, I have focused in this series on > the syscall commands, "enum bpf_cmd". ... > The eventual goal of this effort would be to extend the kernel UAPI > headers such that each of the categories I had listed above (commands, > maps, progs, hooks) have dedicated documentation in the kernel tree, and > that developers must update the comments in the headers to document the > APIs prior to patch acceptance, and that we could auto-generate the > latest version of the bpf(2) manual pages based on a few static > description sections combined with the dynamically-generated output from > the header. > v2: > * Remove build infrastructure in favor of kernel-doc directives > * Shift userspace-api docs under Documentation/userspace-api/ebpf > * Fix scripts/bpf_doc.py syscall --header (throw unsupported error) > * Improve .gitignore handling of newly autogenerated files Looks great. Applied. Thanks!