Inline doc for `wp_set_comment_status` hook is wrong

[henry.wright]

Taken from the wp_set_comment_status() function definition in comment.php

Fires immediately before transitioning a comment's status from one to another in the database.

This is wrong. The database update has already happened when the wp_set_comment_status hook is fired.

[SergeyBiryukov]

Thanks for the ticket!

Looking at the code, this appears to refer to wp_transition_comment_status() called immediately after​.

However, wp_transition_comment_status() only calls the related hooks, the database update has indeed already occurred earlier at this point, so the comment should be corrected to clarify that.

[davidbaumwald]

Updated docs

[SergeyBiryukov]

In 49111:

Docs: Correct description for wp_set_comment_status hook.

The action fires immediately after transitioning a comment's status from one to another in the database and removing the comment from the object cache, but prior to all status transition hooks.

Props davidbaumwald, henry.wright.
Fixes #51481.