Changeset 60508

Timestamp:

07/24/2025 02:45:00 PM (4 months ago)

Author:

SergeyBiryukov

Message:

Twenty Twelve: Use third-person singular verbs for function descriptions.

Reference: ​PHP Documentation Standards: Documenting Tips.

Props vladimiraus, mukesh27, SergeyBiryukov.
See #63692.

Location:

trunk/src/wp-content/themes/twentytwelve

Files:

• functions.php (modified) (11 diffs)
• inc/custom-header.php (modified) (2 diffs)

trunk/src/wp-content/themes/twentytwelve/functions.php

@@ -136 +136 @@
 
 /**
- * Add support for a custom header image.
+ * Adds support for a custom header image.
  */
 require get_template_directory() . '/inc/custom-header.php';
 
 /**
- * Register block patterns and pattern categories.
+ * Registers block patterns and pattern categories.
  *
  * @since Twenty Twelve 4.4
@@ -179 +179 @@
 
 /**
- * Enqueue scripts and styles for front end.
+ * Enqueues scripts and styles for front end.
  *
  * @since Twenty Twelve 1.0
@@ -225 +225 @@
 
 /**
- * Enqueue styles for the block-based editor.
+ * Enqueues styles for the block-based editor.
  *
  * @since Twenty Twelve 2.6
@@ -239 +239 @@
 
 /**
- * Add preconnect for Google Fonts.
+ * Adds preconnect for Google Fonts.
  *
  * @since Twenty Twelve 2.2
@@ -265 +265 @@
 
 /**
- * Filter TinyMCE CSS path to include hosted fonts.
+ * Filters TinyMCE CSS path to include hosted fonts.
  *
  * Adds additional stylesheets to the TinyMCE editor if needed.
@@ -294 +294 @@
 
 /**
- * Filter the page title.
+ * Filters the page title.
  *
  * Creates a nicely formatted and more specific title element text
@@ -332 +332 @@
 
 /**
- * Filter the page menu arguments.
+ * Filters the page menu arguments.
  *
  * Makes our wp_nav_menu() fallback -- wp_page_menu() -- show a home link.
@@ -347 +347 @@
 
 /**
- * Register sidebars.
+ * Registers sidebars.
  *
  * Registers our main widget area and the front page widget areas.
@@ -517 +517 @@
 if ( ! function_exists( 'twentytwelve_entry_meta' ) ) :
     /**
-     * Set up post entry meta.
+     * Sets up post entry meta.
      *
      * Prints HTML with meta information for current post: categories, tags, permalink, author, and date.
@@ -640 +640 @@
 
 /**
- * Register postMessage support.
- *
- * Add postMessage support for site title and description for the Customizer.
+ * Registers postMessage support.
+ *
+ * Adds postMessage support for site title and description for the Customizer.
  *
  * @since Twenty Twelve 1.0
@@ -701 +701 @@
 
 /**
- * Enqueue JavaScript postMessage handlers for the Customizer.
+ * Enqueues JavaScript postMessage handlers for the Customizer.
  *
  * Binds JS handlers to make the Customizer preview reload changes asynchronously.

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

@@ -1 +1 @@
 <?php
 /**
- * Implement an optional custom header for Twenty Twelve
+ * Implements an optional custom header for Twenty Twelve
  *
  * See https://codex.wordpress.org/Custom_Headers
@@ -11 +11 @@
 
 /**
- * Set up the WordPress core custom header arguments and settings.
+ * Sets up the WordPress core custom header arguments and settings.
  *
  * @uses add_theme_support() to register support for 3.4 and up.