Docs: Add missing @return descriptions in bundled themes.

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

@@ -988,7 +988,9 @@ function twentyeleven_skip_link() {
 	 *
 	 * Added for backward compatibility to support pre-6.0.0 WordPress versions.
 	 *
-	 * @since 6.0.0
+	 * @since Twenty Eleven 4.1
+	 *
+	 * @return string Locale-specific 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/twentyfifteen/functions.php

@@ -366,7 +366,7 @@ function twentyfifteen_widgets_init() {
 	 * @since Twenty Fifteen 1.0
 	 * @since Twenty Fifteen 3.4 Replaced Google URL with self-hosted fonts.
 	 *
-	 * @return string Fonts URL for the theme.
+	 * @return string Font stylesheet URL or empty string if disabled.
 	 */
 	function twentyfifteen_fonts_url() {
 		$fonts_url = '';

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 Font stylesheet URL or empty string if disabled.
 	 */
 	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 Whether the site is being previewed in the Customizer.
  */
 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

@@ -181,7 +181,9 @@ function twentynineteen_setup() {
 	 *
 	 * Added for backward compatibility to support pre-6.0.0 WordPress versions.
 	 *
-	 * @since 6.0.0
+	 * @since Twenty Nineteen 2.3
+	 *
+	 * @return string Locale-specific 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 string[] The filtered body class list.
  */
 function twentynineteen_body_classes( $classes ) {
 

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

@@ -289,7 +289,7 @@ function twentyseventeen_content_width() {
 	 * @since Twenty Seventeen 1.0
 	 * @since Twenty Seventeen 3.2 Replaced Google URL with self-hosted fonts.
 	 *
-	 * @return string Fonts URL for the theme.
+	 * @return string Font stylesheet URL or empty string if disabled.
 	 */
 	function twentyseventeen_fonts_url() {
 		$fonts_url = '';
@@ -681,7 +681,9 @@ function twentyseventeen_unique_id( $prefix = '' ) {
 	 *
 	 * Added for backward compatibility to support pre-6.0.0 WordPress versions.
 	 *
-	 * @since 6.0.0
+	 * @since Twenty Seventeen 3.0
+	 *
+	 * @return string Locale-specific 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/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 string[] 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 Whether the blog has more than 1 category.
  */
 function twentyseventeen_categorized_blog() {
 	$category_count = get_transient( 'twentyseventeen_categories' );

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

@@ -334,7 +334,7 @@ function twentysixteen_widgets_init() {
 	 * @since Twenty Sixteen 1.0
 	 * @since Twenty Sixteen 2.9 Replaced Google URL with self-hosted fonts.
 	 *
-	 * @return string Fonts URL for the theme.
+	 * @return string Font stylesheet URL or empty string if disabled.
 	 */
 	function twentysixteen_fonts_url() {
 		$fonts_url = '';

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

@@ -270,7 +270,7 @@ function twentythirteen_setup() {
 	 * @since Twenty Thirteen 1.0
 	 * @since Twenty Thirteen 3.8 Replaced Google URL with self-hosted fonts.
 	 *
-	 * @return string Font stylesheet or empty string if disabled.
+	 * @return string Font stylesheet URL or empty string if disabled.
 	 */
 	function twentythirteen_fonts_url() {
 		$fonts_url = '';
@@ -473,7 +473,9 @@ function twentythirteen_widgets_init() {
 	 *
 	 * Added for backward compatibility to support pre-6.0.0 WordPress versions.
 	 *
-	 * @since 6.0.0
+	 * @since Twenty Thirteen 3.7
+	 *
+	 * @return string Locale-specific 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/twentytwelve/functions.php

@@ -160,7 +160,7 @@ function twentytwelve_register_block_patterns() {
 	 * @since Twenty Twelve 1.2
 	 * @since Twenty Twelve 3.9 Replaced Google URL with self-hosted font.
 	 *
-	 * @return string Font stylesheet or empty string if disabled.
+	 * @return string Font stylesheet URL or empty string if disabled.
 	 */
 	function twentytwelve_get_font_url() {
 		$font_url = '';
@@ -396,7 +396,9 @@ function twentytwelve_widgets_init() {
 	 *
 	 * Added for backward compatibility to support pre-6.0.0 WordPress versions.
 	 *
-	 * @since 6.0.0
+	 * @since Twenty Twelve 3.7
+	 *
+	 * @return string Locale-specific 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/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 Whether the checkbox is checked.
 		 */
 		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" resolution applied if enabled.
  */
 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 the read more link wrapped in a `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() {
 

src/wp-content/themes/twentytwenty/inc/custom-css.php

@@ -20,6 +20,7 @@
 	 * @param string $prefix   The CSS prefix.
 	 * @param string $suffix   The CSS suffix.
 	 * @param bool   $display  Print the styles.
+	 * @return string Generated CSS.
 	 */
 	function twentytwenty_generate_css( $selector, $style, $value, $prefix = '', $suffix = '', $display = true ) {
 
@@ -54,6 +55,7 @@ function twentytwenty_generate_css( $selector, $style, $value, $prefix = '', $su
 	 * @since Twenty Twenty 1.0
 	 *
 	 * @param string $type Whether to return CSS for the "front-end", "block-editor", or "classic-editor".
+	 * @return string CSS styles built from Customizer options.
 	 */
 	function twentytwenty_get_customizer_css( $type = 'front-end' ) {
 

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

@@ -148,7 +148,7 @@ function twentytwenty_site_description( $display = true ) {
  * @since Twenty Twenty 1.0
  *
  * @param object $comment Comment data.
- * @return bool
+ * @return bool Whether the comment is by the post author.
  */
 function twentytwenty_is_comment_by_post_author( $comment = null ) {
 
@@ -249,6 +249,7 @@ function twentytwenty_edit_post_link( $link, $post_id, $text ) {
  *
  * @param int    $post_id  The ID of the post.
  * @param string $location The location where the meta is shown.
+ * @return string Post meta HTML.
  */
 function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) {
 

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

@@ -655,7 +655,9 @@ function twentytwentyone_add_ie_class() {
 	 *
 	 * Added for backward compatibility to support pre-6.0.0 WordPress versions.
 	 *
-	 * @since 6.0.0
+	 * @since Twenty Twenty-One 1.6
+	 *
+	 * @return string Locale-specific 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/twentytwentyone/inc/custom-css.php

@@ -18,7 +18,7 @@
  * @param string $prefix   The CSS prefix.
  * @param string $suffix   The CSS suffix.
  * @param bool   $display  Print the styles.
- * @return string
+ * @return string Generated CSS.
  */
 function twenty_twenty_one_generate_css( $selector, $style, $value, $prefix = '', $suffix = '', $display = true ) {
 

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

@@ -13,7 +13,7 @@
  * @since Twenty Twenty-One 1.0
  *
  * @param array $classes Classes for the body element.
- * @return array
+ * @return string[] Body classes with theme-specific additions.
  */
 function twenty_twenty_one_body_classes( $classes ) {
 
@@ -43,7 +43,7 @@ function twenty_twenty_one_body_classes( $classes ) {
  * @since Twenty Twenty-One 1.0
  *
  * @param array $classes An array of CSS classes.
- * @return array
+ * @return string[] Post classes with 'entry' class added.
  */
 function twenty_twenty_one_post_classes( $classes ) {
 	$classes[] = 'entry';
@@ -91,7 +91,7 @@ function twenty_twenty_one_supports_js() {
  * @since Twenty Twenty-One 1.0
  *
  * @param array $defaults The form defaults.
- * @return array
+ * @return array Comment form defaults with adjusted textarea height.
  */
 function twenty_twenty_one_comment_form_defaults( $defaults ) {
 
@@ -200,7 +200,7 @@ function twenty_twenty_one_post_title( $title ) {
  * @param string $group The icon group.
  * @param string $icon  The icon.
  * @param int    $size  The icon size in pixels.
- * @return string
+ * @return string SVG code for the requested icon.
  */
 function twenty_twenty_one_get_icon_svg( $group, $icon, $size = 24 ) {
 	return Twenty_Twenty_One_SVG_Icons::get_svg( $group, $icon, $size );
@@ -212,7 +212,7 @@ function twenty_twenty_one_get_icon_svg( $group, $icon, $size = 24 ) {
  * @since Twenty Twenty-One 1.0
  *
  * @param string $calendar_output The generated HTML of the calendar.
- * @return string
+ * @return string Calendar HTML with SVG navigation arrows.
  */
 function twenty_twenty_one_change_calendar_nav_arrows( $calendar_output ) {
 	$calendar_output = str_replace( '« ', is_rtl() ? twenty_twenty_one_get_icon_svg( 'ui', 'arrow_right' ) : twenty_twenty_one_get_icon_svg( 'ui', 'arrow_left' ), $calendar_output );
@@ -229,7 +229,7 @@ function twenty_twenty_one_change_calendar_nav_arrows( $calendar_output ) {
  * @since Twenty Twenty-One 1.0
  *
  * @param string $type Whether to return CSS for the "front-end", "block-editor", or "classic-editor".
- * @return string
+ * @return string CSS styles for non-Latin languages based on the site locale.
  */
 function twenty_twenty_one_get_non_latin_css( $type = 'front-end' ) {