doc/lib: add warning about potential doc inaccuracies

diff --git a/doc/lib.rst b/doc/lib.rst
index ae935d356a9452872786b5b32156ad7f6778fe5c..101767fe5add31818b3b8da8fcd41923b0611c99 100644 (file)
--- a/doc/lib.rst
+++ b/doc/lib.rst
@@ -7,6 +7,10 @@
 API reference
 =============
 
+.. warning:: This section is generated with doxygen and breathe. Due to their
+   limitations, some symbols may be incorrectly described or missing entirely.
+   For exhaustive and accurate reference, refer to the header files instead.
+
 .. contents::
    :depth: 1
    :local: