From 52a3f01dd0d2cb26d60f7b2530d2f627b90498b2 Mon Sep 17 00:00:00 2001
From: "Stephen A. Bernhardt" <sabernhardt@yahoo.com>
Date: Tue, 2 Jun 2026 16:13:34 -0500
Subject: [PATCH 1/4] Update documentation for `gallery_style` and
 `use_default_gallery_style` filters

---
 src/wp-includes/media.php | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php
index d318a275a9607..04d7654a55561 100644
--- a/src/wp-includes/media.php
+++ b/src/wp-includes/media.php
@@ -2885,6 +2885,7 @@ function gallery_shortcode( $attr ) {
 	 * Filters whether to print default gallery styles.
 	 *
 	 * @since 3.1.0
+	 * @since 3.9.0 Set the default to false when the theme supports HTML5 galleries.
 	 *
 	 * @param bool $print Whether to print default gallery styles.
 	 *                    Defaults to false if the theme supports HTML5 galleries.
@@ -2916,9 +2917,16 @@ function gallery_shortcode( $attr ) {
 	$gallery_div = "<div id='$selector' class='gallery galleryid-{$id} gallery-columns-{$columns} gallery-size-{$size_class}'>";
 
 	/**
-	 * Filters the default gallery shortcode CSS styles.
+	 * Filters the gallery shortcode's default CSS styles and opening HTML div container.
+	 *
+	 * To remove the CSS entirely, use the `use_default_gallery_style` filter instead.
+	 * `add_filter( 'use_default_gallery_style', '__return_false' );`
 	 *
 	 * @since 2.5.0
+	 * @since 3.1.0 Added classes for number of columns and size to opening div.
+	 * @since 5.3.0 Changed the quotes around the `style` tag's type attribute from
+	 *              single to double.
+	 * @since 7.1.0 Removed the unnecessary type attribute.
 	 *
 	 * @param string $gallery_style Default CSS styles and opening HTML div container
 	 *                              for the gallery shortcode output.

From c6614f7a2c879a099538ce4a600280f77dc5ac4c Mon Sep 17 00:00:00 2001
From: "Stephen A. Bernhardt" <sabernhardt@yahoo.com>
Date: Tue, 2 Jun 2026 16:16:37 -0500
Subject: [PATCH 2/4] Fix version number

---
 src/wp-includes/media.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php
index 04d7654a55561..87c4ab247610d 100644
--- a/src/wp-includes/media.php
+++ b/src/wp-includes/media.php
@@ -2926,7 +2926,7 @@ function gallery_shortcode( $attr ) {
 	 * @since 3.1.0 Added classes for number of columns and size to opening div.
 	 * @since 5.3.0 Changed the quotes around the `style` tag's type attribute from
 	 *              single to double.
-	 * @since 7.1.0 Removed the unnecessary type attribute.
+	 * @since 7.0.0 Removed the unnecessary type attribute.
 	 *
 	 * @param string $gallery_style Default CSS styles and opening HTML div container
 	 *                              for the gallery shortcode output.

From 732754f95194bafa6a764524be22c4897f08b737 Mon Sep 17 00:00:00 2001
From: "Stephen A. Bernhardt" <sabernhardt@yahoo.com>
Date: Tue, 2 Jun 2026 16:34:06 -0500
Subject: [PATCH 3/4] Emphasize the more important change from r46164

---
 src/wp-includes/media.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php
index 87c4ab247610d..0eadedcaccb89 100644
--- a/src/wp-includes/media.php
+++ b/src/wp-includes/media.php
@@ -2924,9 +2924,10 @@ function gallery_shortcode( $attr ) {
 	 *
 	 * @since 2.5.0
 	 * @since 3.1.0 Added classes for number of columns and size to opening div.
-	 * @since 5.3.0 Changed the quotes around the `style` tag's type attribute from
-	 *              single to double.
-	 * @since 7.0.0 Removed the unnecessary type attribute.
+	 * @since 5.3.0 Removed the `type` attribute for `style` tags when the theme
+	 *              supports HTML5 style, and changed the quotes from single to
+	 *              double for other themes.
+	 * @since 7.0.0 Removed the `type` attribute for any theme.
 	 *
 	 * @param string $gallery_style Default CSS styles and opening HTML div container
 	 *                              for the gallery shortcode output.

From 7f73d7393600c7a6721a25726a9a1b689f8b55c8 Mon Sep 17 00:00:00 2001
From: Weston Ruter <weston@ruter.net>
Date: Wed, 3 Jun 2026 13:23:42 +0200
Subject: [PATCH 4/4] Improve formatting of code block

---
 src/wp-includes/media.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php
index 0eadedcaccb89..eb28db81d6ce9 100644
--- a/src/wp-includes/media.php
+++ b/src/wp-includes/media.php
@@ -2919,8 +2919,9 @@ function gallery_shortcode( $attr ) {
 	/**
 	 * Filters the gallery shortcode's default CSS styles and opening HTML div container.
 	 *
-	 * To remove the CSS entirely, use the `use_default_gallery_style` filter instead.
-	 * `add_filter( 'use_default_gallery_style', '__return_false' );`
+	 * To remove the CSS entirely, use the `use_default_gallery_style` filter instead:
+	 *
+	 *     add_filter( 'use_default_gallery_style', '__return_false' );
 	 *
 	 * @since 2.5.0
 	 * @since 3.1.0 Added classes for number of columns and size to opening div.