Docs: Add missing @return descriptions in bundled themes.

Adds missing descriptions to  tags and adds missing  tags in various files across Twenty Fourteen, Twenty Seventeen, Twenty Nineteen, Twenty Twenty, and Twenty Twenty-One to comply with WordPress PHP Documentation Standards.

Author: huzaifaalmesbah

src/wp-content/themes/twentyfourteen/functions.php

@@ -315,7 +315,7 @@ function twentyfourteen_widgets_init() {
 	 * @since Twenty Fourteen 1.0
 	 * @since Twenty Fourteen 3.6 Replaced Google URL with self-hosted fonts.
 	 *
-	 * @return string
+	 * @return string Fonts URL for the theme.
 	 */
 	function twentyfourteen_font_url() {
 		$font_url = '';
@@ -755,6 +755,8 @@ function twentyfourteen_register_block_patterns() {
  * `is_customize_preview` function was introduced.
  *
  * @global WP_Customize_Manager $wp_customize Customizer object.
+ *
+ * @return bool True if the site is being previewed in the Customizer, false otherwise.
  */
 if ( ! function_exists( 'is_customize_preview' ) ) :
 	function is_customize_preview() {

src/wp-content/themes/twentyfourteen/inc/widgets.php

@@ -26,7 +26,7 @@ class Twenty_Fourteen_Ephemera_Widget extends WP_Widget {
 	 *
 	 * @since Twenty Fourteen 1.0
 	 *
-	 * @return Twenty_Fourteen_Ephemera_Widget
+	 * @return Twenty_Fourteen_Ephemera_Widget Widget instance.
 	 */
 	public function __construct() {
 		parent::__construct(

src/wp-content/themes/twentynineteen/classes/class-twentynineteen-svg-icons.php

@@ -27,6 +27,7 @@ class TwentyNineteen_SVG_Icons {
 	 * @param string $group The group of icons ('ui' or 'social').
 	 * @param string $icon  The specific icon to retrieve.
 	 * @param int    $size  The desired width and height for the SVG icon.
+	 * @return string|null SVG code for the icon, or null if not found.
 	 */
 	public static function get_svg( $group, $icon, $size ) {
 		if ( 'ui' === $group ) {
@@ -51,6 +52,7 @@ public static function get_svg( $group, $icon, $size ) {
 	 *
 	 * @param string $uri  The URL of the social network link.
 	 * @param int    $size The desired width and height for the SVG icon.
+	 * @return string|null SVG code for the social link icon, or null if not found.
 	 */
 	public static function get_social_link_svg( $uri, $size ) {
 		static $regex_map; // Only compute regex map once, for performance.

src/wp-content/themes/twentynineteen/functions.php

@@ -182,6 +182,8 @@ function twentynineteen_setup() {
 	 * Added for backward compatibility to support pre-6.0.0 WordPress versions.
 	 *
 	 * @since 6.0.0
+	 *
+	 * @return string List item separator.
 	 */
 	function wp_get_list_item_separator() {
 		/* translators: Used between list items, there is a space after the comma. */

src/wp-content/themes/twentynineteen/inc/customizer.php

@@ -142,7 +142,7 @@ function twentynineteen_panels_js() {
  * Sanitizes custom color choice.
  *
  * @param string $choice Whether image filter is active.
- * @return string
+ * @return string Sanitized color option.
  */
 function twentynineteen_sanitize_color_option( $choice ) {
 	$valid = array(

src/wp-content/themes/twentynineteen/inc/template-functions.php

@@ -11,7 +11,7 @@
  * Adds custom classes to the array of body classes.
  *
  * @param array $classes Classes for the body element.
- * @return array
+ * @return array The filtered body class list.
  */
 function twentynineteen_body_classes( $classes ) {
 

src/wp-content/themes/twentyseventeen/inc/template-functions.php

@@ -11,7 +11,7 @@
  * Adds custom classes to the array of body classes.
  *
  * @param array $classes Classes for the body element.
- * @return array
+ * @return array Filtered body classes with theme-specific additions.
  */
 function twentyseventeen_body_classes( $classes ) {
 	// Add class of group-blog to blogs with more than 1 published author.

src/wp-content/themes/twentyseventeen/inc/template-tags.php

@@ -184,7 +184,7 @@ function twentyseventeen_front_page_section( $partial = null, $id = 0 ) {
 /**
  * Returns true if a blog has more than 1 category.
  *
- * @return bool
+ * @return bool True if the blog has more than 1 category, false otherwise.
  */
 function twentyseventeen_categorized_blog() {
 	$category_count = get_transient( 'twentyseventeen_categories' );

src/wp-content/themes/twentytwenty/classes/class-twentytwenty-customize.php

@@ -459,7 +459,7 @@ public static function sanitize_select( $input, $setting ) {
 		 * @since Twenty Twenty 1.0
 		 *
 		 * @param bool $checked Whether or not a box is checked.
-		 * @return bool
+		 * @return bool True if the checkbox is checked, false otherwise.
 		 */
 		public static function sanitize_checkbox( $checked ) {
 			return ( ( isset( $checked ) && true === $checked ) ? true : false );

src/wp-content/themes/twentytwenty/functions.php

@@ -304,7 +304,7 @@ function twentytwenty_menus() {
  * @since Twenty Twenty 1.0
  *
  * @param string $html The HTML output from get_custom_logo() (core function).
- * @return string
+ * @return string Custom logo HTML with retina support.
  */
 function twentytwenty_get_custom_logo( $html ) {
 
@@ -635,7 +635,7 @@ function twentytwenty_block_editor_settings() {
  * Overwrite default more tag with styling and screen reader markup.
  *
  * @param string $html The default output HTML for the more tag.
- * @return string
+ * @return string The filtered HTML of the more tag, wrapped in a wrapper div.
  */
 function twentytwenty_read_more_tag( $html ) {
 	return preg_replace( '/<a(.*)>(.*)<\/a>/iU', sprintf( '<div class="read-more-button-wrap"><a$1><span class="faux-button">$2</span> <span class="screen-reader-text">"%1$s"</span></a></div>', get_the_title( get_the_ID() ) ), $html );
@@ -736,7 +736,7 @@ function twentytwenty_get_color_for_area( $area = 'content', $context = 'text' )
  *
  * @since Twenty Twenty 1.0
  *
- * @return array
+ * @return array Customizer color variables for the preview.
  */
 function twentytwenty_get_customizer_color_vars() {
 	$colors = array(
@@ -755,7 +755,7 @@ function twentytwenty_get_customizer_color_vars() {
  *
  * @since Twenty Twenty 1.0
  *
- * @return array
+ * @return array Elements to apply custom colors to.
  */
 function twentytwenty_get_elements_array() {