diff --git a/include/epoxy/egl.h b/include/epoxy/egl.h
index adfe2c7..7b30a04 100644
--- a/include/epoxy/egl.h
+++ b/include/epoxy/egl.h
@@ -23,13 +23,8 @@
 
 /** @file egl.h
  *
- * Provides an implementation of a EGL dispatch layer using a hidden
- * vtable.
- *
- * This is a lower performance path than ifuncs when they are
- * available, but it is required if you might have multiple return
- * values for GetProcAddress/dlsym()ed functions (for example, if you
- * unload libGL.so.1).
+ * Provides an implementation of an EGL dispatch layer using global
+ * function pointers
  */
 
 #ifndef __EPOXY_EGL_H
diff --git a/include/epoxy/gl.h b/include/epoxy/gl.h
index 82e143f..8e0d2d1 100644
--- a/include/epoxy/gl.h
+++ b/include/epoxy/gl.h
@@ -23,15 +23,8 @@
 
 /** @file gl.h
  *
- * Provides an implementation of a GL dispatch layer using a hidden
- * vtable.
- *
- * This is a lower performance path than ifuncs when they are
- * available, but it is required if you might have multiple return
- * values for GetProcAddress/dlsym()ed functions.  That is the case if
- * you're using WGL (which can return different function pointers per
- * context), or if you dlclose() and re-dlopen() libGL (which means
- * you'll get different dynamically allocated dispatch stubs).
+ * Provides an implementation of a GL dispatch layer using either
+ * global function pointers or a hidden vtable.
  */
 
 #ifndef __EPOXY_GL_H
diff --git a/include/epoxy/glx.h b/include/epoxy/glx.h
index 09ecf25..9dc2d8f 100644
--- a/include/epoxy/glx.h
+++ b/include/epoxy/glx.h
@@ -23,13 +23,8 @@
 
 /** @file glx.h
  *
- * Provides an implementation of a GLX dispatch layer using a hidden
- * vtable.
- *
- * This is a lower performance path than ifuncs when they are
- * available, but it is required if you might have multiple return
- * values for GetProcAddress/dlsym()ed functions (for example, if you
- * unload libGL.so.1).
+ * Provides an implementation of a GLX dispatch layer using global
+ * function pointers.
  */
 
 #ifndef __EPOXY_GLX_H