docs: adjust to recent hawkmoth/RTD changes

Ensure we stay compatible with the recent changes to hawkmoth and RTD.

Signed-off-by: David Rheinsberg <[email protected]>

Author: dvdhrm

.readthedocs.yaml renamed to src/docs/.readthedocs.yaml

@@ -5,7 +5,7 @@ version: 2
 build:
   apt_packages:
   - "clang"
-  os: "ubuntu-22.04"
+  os: "ubuntu-lts-latest"
   tools:
     python: "3"
 
@@ -14,7 +14,6 @@ formats: "all"
 python:
   install:
   - requirements: "src/docs/requirements.txt"
-  system_packages: true
 
 sphinx:
   configuration: "src/docs/conf.py"

src/docs/conf.py

@@ -25,8 +25,8 @@
 exclude_patterns = []
 
 extensions = [
+    'capidocs.kerneldoc',
     'hawkmoth',
-    'hawkmoth.ext.transformations',
 ]
 
 # Hawkmoth Options
@@ -37,10 +37,6 @@
 
 hawkmoth_root = os.path.abspath('..')
 
-cautodoc_transformations = {
-    'kerneldoc': capidocs.kerneldoc.hawkmoth_converter,
-}
-
 # HTML Options
 
 html_theme = 'sphinx_rtd_theme'

src/docs/requirements.txt

@@ -1,3 +1,3 @@
-c-apidocs>=0.0.2
+c-apidocs>=1.0.0
 clang>=6
-hawkmoth>=0.7
+hawkmoth>=0.20