Misleading function description for check_upload_mimes

[Cimmo]

The description for check_upload_mimes is misleading.
Specifically "This function is used to filter that list against..." for that list seems talks about what returned by get_allowed_mime_types() but this is not true, since there is no call to get_allowed_mime_types() in the code.

Instead filter $mimes input array against the filetype whitelist provided by Multisite.
Please fix the description.

/**
 * Check an array of MIME types against a whitelist.
 *
 * WordPress ships with a set of allowed upload filetypes,
 * which is defined in wp-includes/functions.php in
 * get_allowed_mime_types(). This function is used to filter
 * that list against the filetype whitelist provided by Multisite
 * Super Admins at wp-admin/network/settings.php.
 *
 * @since MU
 *
 * @param array $mimes
 * @return array
 */
function check_upload_mimes( $mimes ) {

[SergeyBiryukov]

Related: #20997

The description appears to be correct.

check_upload_mimes() is hooked to upload_mimes filter, which is used in get_allowed_mime_types():
​http://core.trac.wordpress.org/browser/tags/3.4.1/wp-includes/ms-default-filters.php#L46
​http://core.trac.wordpress.org/browser/tags/3.4.1/wp-includes/functions.php#L1755

[Cimmo]

Oh ok, wasn't clear enough since I couldn't find documentation on codex, probably because nobody really needs to call it from their plug-in.