• Quentin Monnet's avatar
    bpf: change eBPF helper doc parsing script to allow for smaller indent · eeacb716
    Quentin Monnet authored
    Documentation for eBPF helpers can be parsed from bpf.h and eventually
    turned into a man page. Commit 6f96674d ("bpf: relax constraints on
    formatting for eBPF helper documentation") changed the script used to
    parse it, in order to allow for different indent style and to ease the
    work for writing documentation for future helpers.
    
    The script currently considers that the first tab can be replaced by 6
    to 8 spaces. But the documentation for bpf_fib_lookup() uses a mix of
    tabs (for the "Description" part) and of spaces ("Return" part), and
    only has 5 space long indent for the latter.
    
    We probably do not want to change the values accepted by the script each
    time a new helper gets a new indent style. However, it is worth noting
    that with those 5 spaces, the "Description" and "Return" part *look*
    aligned in the generated patch and in `git show`, so it is likely other
    helper authors will use the same length. Therefore, allow for helper
    documentation to use 5 spaces only for the first indent level.
    Signed-off-by: 's avatarQuentin Monnet <quentin.monnet@netronome.com>
    Signed-off-by: 's avatarDaniel Borkmann <daniel@iogearbox.net>
    eeacb716
Name
Last commit
Last update
Documentation Loading commit data...
LICENSES Loading commit data...
arch Loading commit data...
block Loading commit data...
certs Loading commit data...
crypto Loading commit data...
drivers Loading commit data...
firmware Loading commit data...
fs Loading commit data...
include Loading commit data...
init Loading commit data...
ipc Loading commit data...
kernel Loading commit data...
lib Loading commit data...
mm Loading commit data...
net Loading commit data...
samples Loading commit data...
scripts Loading commit data...
security Loading commit data...
sound Loading commit data...
tools Loading commit data...
usr Loading commit data...
virt Loading commit data...
.clang-format Loading commit data...
.cocciconfig Loading commit data...
.get_maintainer.ignore Loading commit data...
.gitattributes Loading commit data...
.gitignore Loading commit data...
.mailmap Loading commit data...
COPYING Loading commit data...
CREDITS Loading commit data...
Kbuild Loading commit data...
Kconfig Loading commit data...
MAINTAINERS Loading commit data...
Makefile Loading commit data...
README Loading commit data...