diff --git a/src/wp-includes/capabilities.php b/src/wp-includes/capabilities.php
index 68047d8b67..5066188d32 100644
--- a/src/wp-includes/capabilities.php
+++ b/src/wp-includes/capabilities.php
@@ -1474,10 +1474,13 @@ function user_can( $user, $capability ) {
 }
 
 /**
- * Retrieve the global WP_Roles instance, instantiate if necessary
+ * Retrieve the global WP_Roles instance, instantiate if necessary.
  *
- * @global WP_Roles $wp_roles
- * @return WP_Roles global instance
+ * @since 4.3.0
+ *
+ * @global WP_Roles $wp_roles WP_Roles global instance.
+ *
+ * @return WP_Roles WP_Roles global instance if not already instantiated.
  */
 function wp_roles() {
 	global $wp_roles;