Clarify that tag_escape() returns santiized value not escaped value

westonruter · westonruter · commit 7c015b45ef4c · 2025-11-18T21:20:57.000-08:00
diff --git a/src/wp-includes/formatting.php b/src/wp-includes/formatting.php
@@ -4809,7 +4809,7 @@ static function ( $matches ) {
  * @since 6.5.5 Allow hyphens in tag names (i.e. custom elements).
  *
  * @param string $tag_name
- * @return string Escaped tag name.
+ * @return string Sanitized tag name.
  */
 function tag_escape( $tag_name ) {
 	$safe_tag = strtolower( preg_replace( '/[^a-zA-Z0-9-_:]/', '', $tag_name ) );

Original file line number	Diff line number	Diff line change
`@@ -4809,7 +4809,7 @@ static function ( $matches ) {`
`4809`	`4809`	`* @since 6.5.5 Allow hyphens in tag names (i.e. custom elements).`
`4810`	`4810`	`*`
`4811`	`4811`	`* @param string $tag_name`
`4812`		`- * @return string Escaped tag name.`
	`4812`	`+ * @return string Sanitized tag name.`
`4813`	`4813`	`*/`
`4814`	`4814`	`function tag_escape( $tag_name ) {`
`4815`	`4815`	`$safe_tag = strtolower( preg_replace( '/[^a-zA-Z0-9-_:]/', '', $tag_name ) );`