Docs: Add proper @param and @return tags for capital_P_dangit().

Props timplunkett.
Fixes #34863.

git-svn-id: https://develop.svn.wordpress.org/trunk@35803 602fd350-edb4-49c9-b593-d223f7449a82

src/wp-includes/formatting.php

@@ -4302,6 +4302,9 @@ function wp_basename( $path, $suffix = '' ) {
  * @since 3.0.0
  *
  * @staticvar string|false $dblq
+ *
+ * @param string $text The text to be modified.
+ * @return string The modified text.
  */
 function capital_P_dangit( $text ) {
 	// Simple replacement for titles