Changeset 60533 for trunk/src/wp-content/themes/twentyseventeen/functions.php

Timestamp:

08/01/2025 11:27:03 AM (9 months ago)

Author:

SergeyBiryukov

Message:

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

Reference: ​PHP Documentation Standards: Documenting Tips.

Props vladimiraus, mukesh27, SergeyBiryukov.
See #63692.

File:

• trunk/src/wp-content/themes/twentyseventeen/functions.php (modified) (11 diffs)

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

@@ -245 +245 @@
 
 /**
- * Set the content width in pixels, based on the theme's design and stylesheet.
+ * Sets the content width in pixels, based on the theme's design and stylesheet.
  *
  * Priority 0 to make it available to lower priority callbacks.
@@ -285 +285 @@
 if ( ! function_exists( 'twentyseventeen_fonts_url' ) ) :
     /**
-     * Register custom fonts.
+     * Registers custom fonts.
      *
      * @since Twenty Seventeen 1.0
@@ -310 +310 @@
 
 /**
- * Add preconnect for Google Fonts.
+ * Adds preconnect for Google Fonts.
  *
  * @since Twenty Seventeen 1.0
@@ -332 +332 @@
 
 /**
- * Register widget area.
+ * Registers widget area.
  *
  * @link https://developer.wordpress.org/themes/functionality/sidebars/#registering-a-sidebar
@@ -412 +412 @@
 
 /**
- * Add a pingback url auto-discovery header for singularly identifiable articles.
+ * Adds a pingback url auto-discovery header for singularly identifiable articles.
  */
 function twentyseventeen_pingback_header() {
@@ -422 +422 @@
 
 /**
- * Display custom color CSS.
+ * Displays custom color CSS.
  */
 function twentyseventeen_colors_css_wrap() {
@@ -552 +552 @@
 
 /**
- * Add custom image sizes attribute to enhance responsive image functionality
+ * Adds custom image sizes attribute to enhance responsive image functionality
  * for content images.
  *
@@ -599 +599 @@
 
 /**
- * Add custom image sizes attribute to enhance responsive image functionality
+ * Adds custom image sizes attribute to enhance responsive image functionality
  * for post thumbnails.
  *
@@ -623 +623 @@
 
 /**
- * Use front-page.php when Front page displays is set to a static page.
+ * Uses front-page.php when Front page displays is set to a static page.
  *
  * @since Twenty Seventeen 1.0
@@ -693 +693 @@
 
 /**
- * Show the featured image below the header on single posts and pages, unless the
- * page is the front page.
- *
- * Use the filter `twentyseventeen_should_show_featured_image` in a child theme or
+ * Shows the featured image below the header on single posts and pages, unless
+ * the page is the front page.
+ *
+ * Uses the filter `twentyseventeen_should_show_featured_image` in a child theme or
  * plugin to change when the image is shown. This example prevents the image
  * from showing:
@@ -750 +750 @@
 
 /**
- * Register block patterns and pattern categories.
+ * Registers block patterns and pattern categories.
  *
  * @since Twenty Seventeen 3.8