Ticket #33756: 33756.diff

src/wp-includes/formatting.php

@@ -1440 +1440 @@
 }
 
 /**
- * Sanitizes a title, or returns a fallback title.
+ * Sanitizes a string for use as a slug in a URL.
  *
  * Specifically, HTML and PHP tags are stripped. Further actions can be added
- * via the plugin API. If $title is empty and $fallback_title is set, the latter
- * will be used.
+ * via the plugin API.
  *
+ * If the sanitized version of $title is empty, $fallback_title will be returned.
+ *
  * @since 1.0.0
  *
  * @param string $title          The string to be sanitized.
@@ -1491 +1492 @@
 }
 
 /**
- * Sanitizes a title, replacing whitespace and a few other characters with dashes.
+ * Sanitizes a string. Output is limited to to alphanumeric characters,
+ * underscore (_) and dash (-).
  *
- * Limits the output to alphanumeric characters, underscore (_) and dash (-).
- * Whitespace becomes a dash.
+ * Various characters (including whitespace) are convered to dashes.
  *
  * @since 1.2.0
  *
@@ -1520 +1521 @@
         }
 
         $title = strtolower($title);
-        $title = preg_replace('/&.+?;/', '', $title); // kill entities
+        // Remove HTML entities.
+        $title = preg_replace('/&.+?;/', '', $title);
         $title = str_replace('.', '-', $title);
 
         if ( 'save' == $context ) {