--- a/wp/wp-includes/class-wp-list-util.php	Tue Dec 15 15:52:01 2020 +0100
+++ b/wp/wp-includes/class-wp-list-util.php	Wed Sep 21 18:19:35 2022 +0200
@@ -77,6 +77,13 @@
 	/**
 	 * Filters the list, based on a set of key => value arguments.
 	 *
+	 * Retrieves the objects from the list that match the given arguments.
+	 * Key represents property name, and value represents property value.
+	 *
+	 * If an object has more properties than those specified in arguments,
+	 * that will not disqualify it. When using the 'AND' operator,
+	 * any missing properties will disqualify it.
+	 *
 	 * @since 4.7.0
 	 *
 	 * @param array  $args     Optional. An array of key => value arguments to match