Fix a broken link for esc_like() in the wpdb->prepare() DocBlock

[DrewAPicture]

As reported by @timhavinga, the esc_like() reference in the fourth paragraph of the DocBlock description for wpdb->prepare() is invalid. It should point to to the wpdb->esc_like() method, vs a (nonexistent) standalone function.

The DocBlock description for a function, class, method, or hook corresponds to the Description section of the reference article for that element when it's parsed from source. So to reference a class method in a DocBlock with an inline @see tag, the format is {@see Class_Name::method_name()}

Current docs:

<?php
 * ...
 *
 * Literal percentage signs (%) in the query string must be written as %%. Percentage wildcards (for example,
 * to use in LIKE syntax) must be passed via a substitution argument containing the complete LIKE string, these
 * cannot be inserted directly in the query string. Also see {@see esc_like()}.
 *
 * ...
 */
public function prepare( $query, $args ) {
...

[DrewAPicture]

Note: I've manually fixed the link in the Code Reference on a temporary basis pending a fix against the 5.1 milestone once trunk development reopens.

[antaltettinger]

Corrected with link to the requested Description section in the WordPress Codex

[DrewAPicture]

Hi @antaltettinger, thanks for the patch. Unfortunately, it's not quite the fix we need.

Based on the second paragraph of the ticket description, all we really need to do is update the inline @see tag to match the {@see Class_Name::method_name()} syntax.

---

Assigning to mark the good-first-bug ticket as "claimed".

[antaltettinger]

Corrected to include text with the requested format.

[antaltettinger]

Hi @DrewAPicture! Thank you very much for your quick reply. I have modified and uploaded the (hopefully) correct file. Thanks for the support, it's my first time to contribute on Track so it's testing waters for me.

[DrewAPicture]

Hi @antaltettinger, that's exactly what I was looking for. Looks great!

Trunk development is still closed, but we'll get this one merged, probably as part of the 5.1 release when that opens back up again.

Thanks for the patch!

[DrewAPicture]

In 44330:

Docs: Update an inline @see reference in the DocBlock for wpdb::prepare() to reference wpdb::esc_like() the method instead of esc_like() the nonexistent function.

Props antaltettinger.
Fixes #45204.

[SergeyBiryukov]

In 44901:

Docs: Remove unnecessary @see tag in wpdb::prepare().

The tag is only necessary for hooks. For functions and methods, autolinking is handled automatically on developer.wordpress.org.

Props mbelchev, ocean90, johannadevos.
Fixes #44585. See #45204.