Missing PHPDoc $content param text in shortcode.php

[cais]

There appears to be no PHPDoc param text for the $content variable being passed to has_shortcode(). The attached patch uses the same text for $content as used in do_shortcode().

[DrewAPicture]

Hi cais, thanks for the patch.

I think if we're in there adding a missing parameter and description, we should probably also cover the description for $tag and the return value. Would you care to include those in your patch?

[SergeyBiryukov]

Notice some other inconsistencies, see 31048.2.patch​.

[cais]

Replying to DrewAPicture:

Hi cais, thanks for the patch.

I think if we're in there adding a missing parameter and description, we should probably also cover the description for $tag and the return value. Would you care to include those in your patch?

... looks like I wasn't quick enough. Sergey appears to have covered those.

[DrewAPicture]

In 31242:

Ensure both parameters and the return for has_shortcode() are fully documented.

Props cais, SergeyBiryukov
See #31048.

[DrewAPicture]

In 31243:

Add more complete documentation for parameters, globals, and return values to the DocBlocks for remove_shortcode(), shortcode_exists(), and do_shortcode().

Props SergeyBiryukov.
Fixes #31048.

[DrewAPicture]

In 31245:

Remove a stray period introduced in [31242].

Props SergeyBiryukov.
See #31048.