Twenty Eleven: Improve documentation for twentyeleven_attachment_size filter.

Follow-up to [25625].

Props sabernhardt.
Fixes #63160.



git-svn-id: https://develop.svn.wordpress.org/trunk@60077 602fd350-edb4-49c9-b593-d223f7449a82

Author: audrasjb

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

@@ -93,14 +93,15 @@
 									<a href="<?php echo esc_url( $next_attachment_url ); ?>" title="<?php the_title_attribute(); ?>" rel="attachment">
 										<?php
 										/**
-										 * Filters the Twenty Eleven default attachment size.
+										 * Filters the width for Twenty Eleven's default attachment size.
+										 *
+										 * This edits the image width, and the image height is limited to 1024 pixels.
 										 *
 										 * @since Twenty Eleven 1.0
 										 *
-										 * @param int The height and width attachment size dimensions in pixels. Default 848.
+										 * @param int The width for the image attachment size in pixels. Default 848.
 										 */
 										$attachment_size = apply_filters( 'twentyeleven_attachment_size', 848 );
-										// Filterable image width with 1024px limit for image height.
 										echo wp_get_attachment_image( $post->ID, array( $attachment_size, 1024 ) );
 										?>
 									</a>