Commit 0f885ef9c3 for wordpress.org

commit 0f885ef9c3284287301a8337d3f93349b166cca9
Author: wildworks <wildworks@git.wordpress.org>
Date:   Sat Sep 5 10:23:49 2026 +0000

    Bundled Themes: Document the parameters of five template functions.

    Adds missing `@param`/`@return` tags to five Twenty Nineteen and Twenty Twelve functions.

    Developed in: https://github.com/WordPress/wordpress-develop/pull/12792

    Props bejignesh, mukesh27, wildworks.
    See #65860.

    Built from https://develop.svn.wordpress.org/trunk@63498


    git-svn-id: http://core.svn.wordpress.org/trunk@62674 1a063a9b-81f0-0310-95a4-ce76da25c4cd

diff --git a/wp-content/themes/twentynineteen/inc/template-tags.php b/wp-content/themes/twentynineteen/inc/template-tags.php
index c884a71621..99bb2b8602 100644
--- a/wp-content/themes/twentynineteen/inc/template-tags.php
+++ b/wp-content/themes/twentynineteen/inc/template-tags.php
@@ -170,6 +170,11 @@ endif;
 if ( ! function_exists( 'twentynineteen_get_user_avatar_markup' ) ) :
 	/**
 	 * Returns the HTML markup to generate a user avatar.
+	 *
+	 * @param mixed $id_or_email Optional. The avatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+	 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
+	 *                           Default null, which uses the current user ID.
+	 * @return string HTML markup for the user avatar.
 	 */
 	function twentynineteen_get_user_avatar_markup( $id_or_email = null ) {

@@ -184,6 +189,9 @@ endif;
 if ( ! function_exists( 'twentynineteen_discussion_avatars_list' ) ) :
 	/**
 	 * Displays a list of avatars involved in a discussion for a given post.
+	 *
+	 * @param array $comment_authors Comment authors to display avatars for. Each entry is a user ID,
+	 *                               or an email address for authors without an account.
 	 */
 	function twentynineteen_discussion_avatars_list( $comment_authors ) {
 		if ( empty( $comment_authors ) ) {
@@ -203,6 +211,10 @@ endif;
 if ( ! function_exists( 'twentynineteen_comment_form' ) ) :
 	/**
 	 * Displays the comment form.
+	 *
+	 * @param bool|string $order Whether to display the form. Accepts 'asc' or 'desc' to display it only
+	 *                           when the value matches the 'comment_order' option, or true to always
+	 *                           display it.
 	 */
 	function twentynineteen_comment_form( $order ) {
 		if ( true === $order || strtolower( $order ) === strtolower( get_option( 'comment_order', 'asc' ) ) ) {
diff --git a/wp-content/themes/twentytwelve/functions.php b/wp-content/themes/twentytwelve/functions.php
index a6c3300bb4..65e93c3387 100644
--- a/wp-content/themes/twentytwelve/functions.php
+++ b/wp-content/themes/twentytwelve/functions.php
@@ -344,6 +344,10 @@ add_filter( 'wp_title', 'twentytwelve_wp_title', 10, 2 );
  * Makes our wp_nav_menu() fallback -- wp_page_menu() -- show a home link.
  *
  * @since Twenty Twelve 1.0
+ *
+ * @param array $args An array of page menu arguments. See wp_page_menu() for information
+ *                    on accepted arguments.
+ * @return array Filtered page menu arguments.
  */
 function twentytwelve_page_menu_args( $args ) {
 	if ( ! isset( $args['show_home'] ) ) {
@@ -422,6 +426,8 @@ if ( ! function_exists( 'twentytwelve_content_nav' ) ) :
 	 * @since Twenty Twelve 1.0
 	 *
 	 * @global WP_Query $wp_query WordPress Query object.
+	 *
+	 * @param string $html_id The HTML id attribute for the navigation element.
 	 */
 	function twentytwelve_content_nav( $html_id ) {
 		global $wp_query;
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 7a75751891..923616dac9 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '7.2-alpha-63497';
+$wp_version = '7.2-alpha-63498';

 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.