Media: Improve inline docs for wp_filter_content_tags().

azaozz · azaozz · commit 3e1083a37e0b · 2020-07-27T21:04:34.000Z
Props johnstonphilip. See #44427. git-svn-id: https://develop.svn.wordpress.org/trunk@48648 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php
@@ -1705,9 +1705,10 @@ function wp_lazy_loading_enabled( $tag_name, $context ) {
 }
 
 /**
- * Filters specific tags in post content and modifies their markup.
- *
- * This function adds `srcset`, `sizes`, and `loading` attributes to `img` HTML tags.
+ * Modifies specific HTML tags in post content to include new browser and HTML technologies
+ * that may not have existed at the time of post creation. These modifications currently include
+ * adding `srcset`, `sizes`, and `loading` attributes to `img` HTML tags. Future similar
+ * optimizations should be added/expected here.
  *
  * @since 5.5.0
  *

Original file line number	Diff line number	Diff line change
`@@ -1705,9 +1705,10 @@ function wp_lazy_loading_enabled( $tag_name, $context ) {`
`1705`	`1705`	`}`
`1706`	`1706`
`1707`	`1707`	`/**`
`1708`		`- * Filters specific tags in post content and modifies their markup.`
`1709`		`- *`
`1710`		- * This function adds `srcset`, `sizes`, and `loading` attributes to `img` HTML tags.
	`1708`	`+ * Modifies specific HTML tags in post content to include new browser and HTML technologies`
	`1709`	`+ * that may not have existed at the time of post creation. These modifications currently include`
	`1710`	+ * adding `srcset`, `sizes`, and `loading` attributes to `img` HTML tags. Future similar
	`1711`	`+ * optimizations should be added/expected here.`
`1711`	`1712`	`*`
`1712`	`1713`	`* @since 5.5.0`
`1713`	`1714`	`*`