docs: Add @return never to media_send_to_editor()

apermo · apermo · commit 4013816c617d · 2026-02-25T22:01:37.000+01:00
The function unconditionally calls exit, so the return
type should be documented as never.
diff --git a/src/wp-admin/includes/media.php b/src/wp-admin/includes/media.php
@@ -269,6 +269,7 @@ function _cleanup_image_add_caption( $matches ) {
  * @since 2.5.0
  *
  * @param string $html
+ * @return never
  */
 function media_send_to_editor( $html ) {
 	?>

Original file line number	Diff line number	Diff line change
`@@ -269,6 +269,7 @@ function _cleanup_image_add_caption( $matches ) {`
`269`	`269`	`* @since 2.5.0`
`270`	`270`	`*`
`271`	`271`	`* @param string $html`
	`272`	`+ * @return never`
`272`	`273`	`*/`
`273`	`274`	`function media_send_to_editor( $html ) {`
`274`	`275`	`?>`