Skip to content
  • René Paris's avatar
    feat(doc): Add custom api-doc extension · abf24a99
    René Paris authored and Reinhard Biegel's avatar Reinhard Biegel committed
    This commits adds the directive `toctree-api` to sphinx, enhancing the
    regular toctree by a conditional `:api-doc:` entry. If `api_doc_build`
    is activated (= `cmake --DWITH_API_DOC=ON`), the api-doc extension
    (a) inits and configures the sphinx extensions `breathe` and `exhale` to
    generate the API doc and (b) inserts the api-doc into the toctree, where
    the key `:api-doc:` is found.
    Signed-off-by: René Paris's avatarRene Paris <>