Changeset 21617 for trunk/wp-content/themes/twentytwelve/inc/custom-header.php

Timestamp:

08/25/2012 04:53:32 PM (12 years ago)

Author:

lancewillett

Message:

Twenty Twelve: review and clarify code commenting and documentation. Props jorbin and obenland. See #21675.

File:

• trunk/wp-content/themes/twentytwelve/inc/custom-header.php (modified) (3 diffs)

trunk/wp-content/themes/twentytwelve/inc/custom-header.php

@@ -1 +1 @@
 <?php
 /**
- * Implement an optional custom header for Twenty Twelve.
- * http://codex.wordpress.org/Custom_Headers
+ * Implements an optional custom header for Twenty Twelve.
+ * See http://codex.wordpress.org/Custom_Headers
  *
  * @package WordPress
@@ -10 +10 @@
 
 /**
- * Set up the WordPress core custom header arguments and settings.
- * Use add_theme_support() to register support for 3.4 and up.
+ * Sets up the WordPress core custom header arguments and settings.
  *
- * @uses twentytwelve_header_style()
- * @uses twentytwelve_admin_header_style()
- * @uses twentytwelve_admin_header_image()
+ * @uses add_theme_support() to register support for 3.4 and up.
+ * @uses twentytwelve_header_style() to style front-end.
+ * @uses twentytwelve_admin_header_style() to style wp-admin form.
+ * @uses twentytwelve_admin_header_image() to add custom markup to wp-admin form.
  *
  * @since Twenty Twelve 1.0
@@ -127 +127 @@
 
 /**
- * Custom header image markup displayed on the Appearance > Header admin panel.
+ * Outputs markup to be displayed on the Appearance > Header admin panel.
+ * This callback overrides the default markup displayed there.
  *
  * @since Twenty Twelve 1.0