third_party_libbpf/docs
Dave Tucker 842c5b7bff bpf, docs: Fix ordering of bpf documentation
This commit fixes the display of the BPF documentation in the sidebar
when rendered as HTML.

Before this patch, the sidebar would render as follows for some
sections:

| BPF Documentation
  |- BPF Type Format (BTF)
    |- BPF Type Format (BTF)

This was due to creating a heading in index.rst followed by
a sphinx toctree, where the file referenced carries the same
title as the section heading.

To fix this I applied a pattern that has been established in other
subfolders of Documentation:

1. Re-wrote index.rst to have a single toctree
2. Split the sections out in to their own files

Additionally maps.rst and programs.rst make use of a glob pattern to
include map_* or prog_* rst files in their toctree, meaning future map
or program type documentation will be automatically included.

Signed-off-by: Dave Tucker <dave@dtucker.co.uk>
Signed-off-by: Daniel Borkmann <daniel@iogearbox.net>
Link: https://lore.kernel.org/bpf/1a1eed800e7b9dc13b458de113a489641519b0cc.1636749493.git.dave@dtucker.co.uk
2021-11-23 23:04:18 -08:00
..
sphinx Fix path to Doxygen source code input 2021-08-18 12:28:09 -07:00
.gitignore docs: reconfigure libbpf documentation syncing 2021-08-16 22:30:23 -07:00
api.rst Add enum to be displayed in documentation 2021-09-16 11:39:22 -07:00
conf.py docs: reconfigure libbpf documentation syncing 2021-08-16 22:30:23 -07:00
index.rst bpf, docs: Fix ordering of bpf documentation 2021-11-23 23:04:18 -08:00
libbpf_build.rst docs: initial set of libbpf docs 2021-08-16 22:37:57 -07:00
libbpf_naming_convention.rst libbpf: Add API documentation convention guidelines 2021-10-06 14:40:18 -07:00