Commenting

Author: dmsnell

src/wp-includes/media.php

@@ -5346,17 +5346,18 @@ function get_post_galleries( $post, $html = true, $max_galleries = PHP_INT_MAX )
 
 		// New Gallery block format as an array.
 		if ( $has_inner_blocks ) {
-			// There are inner blocks and this is the first one; the loop above aborted at its opening.
-
 			/**
+			 * There are inner blocks and this is the first one;
+			 * the loop above aborted at its opening, so initially the processor
+			 * is paused on the opening delimiter of the first inner block.
+			 *
 			 * @todo Could avoid computation by tracking seen ids and only looking up the
 			 *       attachment url if the id hasn’t already been resolved.
 			 */
-
 			do {
 				// Examine only the direct children of the gallery block.
 				if ( $processor->get_depth() === $gallery_depth + 1 ) {
-					/** @var @todo Perfect use-case for lazy parsing here — only the `id` is wanted. */
+					/** @todo Perfect use-case for lazy parsing here — only the `id` is wanted. */
 					$id = $processor->allocate_and_return_parsed_attributes()['id'] ?? null;
 					if ( isset( $id ) ) {
 						$ids[] = $id;