diff --git a/docs/reference/libs/Makefile.am b/docs/reference/libs/Makefile.am
index 05f1c79584..f3584b1038 100644
--- a/docs/reference/libs/Makefile.am
+++ b/docs/reference/libs/Makefile.am
@@ -72,7 +72,6 @@ IGNORE_HFILES = \
 	gstvaapiutils.h \
 	gstvaapiutils_glx.h \
 	gstvaapiutils_x11.h \
-	gstvaapivalue.h \
 	$(NULL)
 
 EXTRA_HFILES = \
diff --git a/docs/reference/libs/libs-sections.txt b/docs/reference/libs/libs-sections.txt
index c5bd0a402a..63a2eddb51 100644
--- a/docs/reference/libs/libs-sections.txt
+++ b/docs/reference/libs/libs-sections.txt
@@ -132,9 +132,6 @@ GST_VAAPI_WINDOW_GLX_GET_CLASS
 
 <SECTION>
 <FILE>gstvaapidisplay</FILE>
-GST_VAAPI_DISPLAY_VADISPLAY
-GST_VAAPI_DISPLAY_LOCK
-GST_VAAPI_DISPLAY_UNLOCK
 <TITLE>GstVaapiDisplay</TITLE>
 GstVaapiDisplay
 GstVaapiDisplayClass
diff --git a/gst-libs/gst/vaapi/gstvaapidecoder.h b/gst-libs/gst/vaapi/gstvaapidecoder.h
index e7bc5ca66f..fbffdd8e08 100644
--- a/gst-libs/gst/vaapi/gstvaapidecoder.h
+++ b/gst-libs/gst/vaapi/gstvaapidecoder.h
@@ -95,7 +95,6 @@ struct _GstVaapiDecoder {
 
 /**
  * GstVaapiDecoderClass:
- * @decode: decode one frame.
  *
  * A VA decoder base class.
  */
diff --git a/gst-libs/gst/vaapi/gstvaapisurfaceproxy.h b/gst-libs/gst/vaapi/gstvaapisurfaceproxy.h
index 1ccb81592d..364244e23b 100644
--- a/gst-libs/gst/vaapi/gstvaapisurfaceproxy.h
+++ b/gst-libs/gst/vaapi/gstvaapisurfaceproxy.h
@@ -77,8 +77,6 @@ typedef struct _GstVaapiSurfaceProxyClass       GstVaapiSurfaceProxyClass;
 
 /**
  * GstVaapiSurfaceProxy:
- * @surface: a #GstVaapiSurface
- * @context: the #GstVaapiContext to which the @surface is bound
  *
  * A wrapper around a VA surface and context.
  */