Hi,
Unlike cgroup v1, cgroup v2 documentation is a rather lengthy single document
(Documentation/admin-guide/cgroup-v2.rst), although is not as long as KVM
API docs (Documentation/virt/kvm/api.rst). As such, it needs a roadmap for
allowing readers to easily navigate it: the toctree.
While plaintext (reST source) readers are delighted with already-existing,
manually-written toctree, readers in html format (including docs.kernel.org
visitors) don't get such luxury. Let's add reST toctree for them.
The first two patches ([1/4] and [2/4]) are section numbers preparation (just
as one would see the book toctree). Actual toctree generation is in [3/4],
and in the service of plaintext readers, also sync the manual toctree in
[4/4].
Enjoy!
Changes since v1 [1]:
* Drop unrelated cross-reference patch
* Keep the manual toctree, but fix it up to sync with actual sections
listing/automatic toctree (Jon)
[1]: https://lore.kernel.org/linux-doc/20250910072334.30688-1-bagasdotme@gmail.com/
Bagas Sanjaya (4):
Documentation: cgroup-v2: Use dot delimiter in manual toctree section
numbers
Documentation: cgroup-v2: Add section numbers
Documentation: cgroup-v2: Automatically-generate toctree
Documentation: cgroup-v2: Sync manual toctree
Documentation/admin-guide/cgroup-v2.rst | 447 ++++++++++++------------
1 file changed, 227 insertions(+), 220 deletions(-)
base-commit: cf9c2bbba2735831f1200227c7f13404b7d7908e
--
An old man doll... just what I always wanted! - Clara