tools: bpftool: Log info-level messages when building bpftool man pages

Browse source

To build man pages for bpftool (and for eBPF helper functions), rst2man
can log different levels of information. Let's make it log all levels
to keep the RST files clean.

Doing so, rst2man complains about double colons, used for literal
blocks, that look like underlines for section titles. Let's add the
necessary blank lines.

v2:
- Use "--verbose" instead of "-r 1" (same behaviour but more readable).
- Pass it through a RST2MAN_OPTS variable so we can easily pass other
  options too.

Signed-off-by: Quentin Monnet <quentin@isovalent.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
Acked-by: Andrii Nakryiko <andriin@fb.com>
Link: https://lore.kernel.org/bpf/20200909162251.15498-2-quentin@isovalent.com

...

This commit is contained in:

Quentin Monnet 2020-09-09 17:22:50 +01:00 • committed by Alexei Starovoitov

parent e9091bb77f

commit 16f3ddfbad

4 changed files with 12 additions and 1 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download patch file Download diff file Expand all files Collapse all files

3

tools/bpf/bpftool/Documentation/Makefile

View file

3

tools/bpf/bpftool/Documentation/bpftool-btf.rst

View file

4

tools/bpf/bpftool/Documentation/bpftool-gen.rst

View file

3

tools/bpf/bpftool/Documentation/bpftool-map.rst

View file