Skip to content

Commit

Permalink
bpf: Reconfigure libbpf docs to remove unversioned API
Browse files Browse the repository at this point in the history
This removes the libbpf_api.rst file from the kernel documentation.
The intention for this file was to pull documentation from comments
above API functions in libbpf. However, due to limitations of the
kernel documentation system, this API documentation could not be
versioned, which is counterintuative to how users expect to use it.
There is also currently no doc comments, making this a blank page.

Once the kernel comment documentation is actually contributed, it
will still exist in the kernel repository, just in the code itself.

A seperate site is being spun up to generate documentaiton from those
comments in a way in which it can be versioned properly.

This also reconfigures the bpf documentation index page to make it
easier to sync to the previously mentioned documentaiton site.

Signed-off-by: Grant Seltzer <grantseltzer@gmail.com>
Signed-off-by: Andrii Nakryiko <andrii@kernel.org>
Link: https://lore.kernel.org/bpf/20210810020508.280639-1-grantseltzer@gmail.com
  • Loading branch information
grantseltzer authored and Andrii Nakryiko committed Aug 17, 2021
1 parent 3a4ce01 commit bb57164
Show file tree
Hide file tree
Showing 2 changed files with 1 addition and 36 deletions.
10 changes: 1 addition & 9 deletions Documentation/bpf/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,15 +15,7 @@ that goes into great technical depth about the BPF Architecture.
libbpf
======

Libbpf is a userspace library for loading and interacting with bpf programs.

.. toctree::
:maxdepth: 1

libbpf/libbpf
libbpf/libbpf_api
libbpf/libbpf_build
libbpf/libbpf_naming_convention
Documentation/bpf/libbpf/libbpf.rst is a userspace library for loading and interacting with bpf programs.

BPF Type Format (BTF)
=====================
Expand Down
27 changes: 0 additions & 27 deletions Documentation/bpf/libbpf/libbpf_api.rst

This file was deleted.

0 comments on commit bb57164

Please sign in to comment.