Docblock for wp_insert_link is inaccurate or function is missing functionality

[dshanske]

Aware that the function is not actively maintained, but it references that link_updated can be set using the function.

The function adds 'link_url', 'link_name', 'link_image', 'link_target', 'link_description', 'link_visible', 'link_owner', 'link_rating', 'link_rel', 'link_notes', and 'link_rss' to the database.

That misses link_updated, which the function says it provides.

There are two paths to resolution. We can note it in documentation or just simply fix it. Either seem to be a valid path.

[SergeyBiryukov]

Hi there, thanks for the ticket!

The documentation was added in [49487] / #50853.

Looks like the link_updated field is unused since [13744] / #12437, so I think we can remove it from the documentation. It was never updated via wp_insert_link() anyway, only via the wp-admin/update-links.php file removed in [13744].

Removed documentation for link_updated field from Docblock of wp_insert_link()

Trac ticket: https://core.trac.wordpress.org/ticket/54880

[SergeyBiryukov]

In 52659:

General: Remove inaccurate reference to the link_updated field from the wp_insert_link() DocBlock.

The link_updated field is unused as of WordPress 3.0 and was never updated via wp_insert_link(), only via the wp-admin/update-links.php file removed in [13744].

Follow-up to [13744], [49487].

Props dshanske, dharm1025, SergeyBiryukov.
Fixes #54880.

Thanks for the PR! Merged in https://core.trac.wordpress.org/changeset/52659.