Bad link in doc caused by docblock typo

[Camwynsp]

In ​https://developer.wordpress.org/reference/functions/_deprecated_function/#description

The link to ​https://developer.wordpress.org/reference/hooks/deprecated_function_run/ is malformed, instead sending you to ​https://developer.wordpress.org/reference/functions/%e2%80%98hook-deprecated_function_run%e2%80%99 (bad link)

It looks like the docblock text formatting caused it to do so.
See: ​https://github.com/WordPress/wordpress-develop/blob/6.0.2/src/wp-includes/functions.php#L5332 (hook is inside the quotes)

[kebbet]

This seems to be an issue on the developer.wordpress.org side of things, since all links for deprecated functions no longer links correct pages. The ´ characters are used to format the links on developer.wordpress.org.

See e.g. ​https://developer.wordpress.org/reference/hooks/edit_category_form_pre/

[davidbaumwald]

@Camwynsp Thanks for the ticket and welcome to WordPress core Trac!!

This indeed does need to be fixed. This seems to trace back to r37543. Let's resolve this in 6.1.

[SergeyBiryukov]

Hi there, thanks for the ticket!

Just to clarify a bit for others looking at the ticket (I misread it initially), the {@see 'hook_name'} format itself is fine and is used in many other places in core.

There appear to be two disctinct issues here:

1. The hook in question has a hook word inside the quotes:

   There is a {@see 'hook deprecated_function_run'}
   

   That should be fixed, as noted in comment:3:

   There is a hook {@see 'deprecated_function_run'}
   

2. Something weird is going on with hook links in general on the developer.wordpress.org side too, as noted in comment:1. That is unrelated to this particular hook and needs more investigation.

[hilayt24]

Hi @Camwynsp, Thanks for the ticket. @SergeyBiryukov I added the patch for the 1st issue.

[hilayt24]

The hook is now outside the brackets.

[davidbaumwald]

In 54292:

Docs: Correct @see reference to deprecated_function_run in the _deprecated_function docblock.

In the docblock for _deprecated_function, there is a @see reference to the deprecated_function_run hook run inside _deprecated_function. However, the @see reference includes the word "hook" inside the quotes which is generating a bad link at ​https://developer.wordpress.org/reference/functions/_deprecated_function/.

This change simply moves the word "hook" outside the @see reference to correct the link parsing on ​https://developer.wordpress.org.

Props Camwynsp, kebbet, SergeyBiryukov, hilayt24.
Fixes #56625.