diff --git a/src/wp-includes/functions.php b/src/wp-includes/functions.php index 4ed285d405..63bc4bcb1d 100644 --- a/src/wp-includes/functions.php +++ b/src/wp-includes/functions.php @@ -2449,11 +2449,12 @@ function _wp_upload_dir( $time = null ) { * Get a filename that is sanitized and unique for the given directory. * * If the filename is not unique, then a number will be added to the filename - * before the extension, and will continue adding numbers until the filename is - * unique. + * before the extension, and will continue adding numbers until the filename + * is unique. * - * The callback is passed three parameters, the first one is the directory, the - * second is the filename, and the third is the extension. + * The callback function allows the caller to use their own method to create + * unique file names. If defined, the callback should take three arguments: + * - directory, base filename, and extension - and return a unique filename. * * @since 2.5.0 *