diff --git a/include/glx_extinit.h b/include/glx_extinit.h
index 42895e1dcd..20737a18a0 100644
--- a/include/glx_extinit.h
+++ b/include/glx_extinit.h
@@ -42,6 +42,11 @@ struct __GLXprovider {
 extern __GLXprovider __glXDRISWRastProvider;
 
 void GlxPushProvider(__GLXprovider * provider);
+
+/**
+ * @brief xorgGlxCreateVendor adds default glx vendor callback
+ * @warning this function need to be called once, because it installs `catch-all` style which always succeed
+ */
 void xorgGlxCreateVendor(void);
 
 #else /* GLXEXT */