WordPress.org
Get WordPress

Make WordPress Core

Changeset 60513


Ignore:
Timestamp:
07/25/2025 05:01:20 PM (6 months ago)
Author:
SergeyBiryukov
Message:

Twenty Eleven: Use third-person singular verbs for some more function descriptions.

Reference: ​PHP Documentation Standards: Documenting Tips.

Follow-up to [60506], [60507].

See #63692.

Location:
trunk/src/wp-content/themes/twentyeleven
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-content/themes/twentyeleven/functions.php

    r60506 r60513  
    5353if ( ! function_exists( 'twentyeleven_setup' ) ) :
    5454    /**
    55      * Set up theme defaults and registers support for various WordPress features.
     55     * Sets up theme defaults and registers support for various WordPress features.
    5656     *
    5757     * Note that this function is hooked into the after_setup_theme hook, which runs
    … …  
    412412if ( ! function_exists( 'twentyeleven_admin_header_image' ) ) :
    413413    /**
    414      * Custom header image markup displayed on the Appearance > Header admin panel.
     414     * Displays custom header image markup on the Appearance > Header admin panel.
    415415     *
    416416     * Referenced via add_theme_support('custom-header') in twentyeleven_setup().
    … …  
    443443if ( ! function_exists( 'twentyeleven_header_image' ) ) :
    444444    /**
    445      * Custom header image markup displayed.
     445     * Displays custom header image markup.
    446446     *
    447447     * @since Twenty Eleven 4.5
    … …  
    492492if ( ! function_exists( 'twentyeleven_continue_reading_link' ) ) :
    493493    /**
    494      * Return a "Continue Reading" link for excerpts
     494     * Returns a "Continue Reading" link for excerpts.
    495495     *
    496496     * @since Twenty Eleven 1.0
    … …  
    504504
    505505/**
    506  * Replace "[...]" in the Read More link with an ellipsis.
     506 * Replaces "[...]" in the Read More link with an ellipsis.
    507507 *
    508508 * The "[...]" is appended to automatically generated excerpts.
    … …  
    655655
    656656/**
    657  * Return the first link from the post content. If none found, the
     657 * Returns the first link from the post content. If none found, the
    658658 * post permalink is used as a fallback.
    659659 *
    … …  
    677677
    678678/**
    679  * Return the URL for the first link found in the post content.
     679 * Returns the URL for the first link found in the post content.
    680680 *
    681681 * @since Twenty Eleven 1.0
    … …  
    692692
    693693/**
    694  * Count the number of footer sidebars to enable dynamic classes for the footer.
     694 * Counts the number of footer sidebars to enable dynamic classes for the footer.
    695695 *
    696696 * @since Twenty Eleven 1.0
    … …  
    829829if ( ! function_exists( 'twentyeleven_posted_on' ) ) :
    830830    /**
    831      * Print HTML with meta information for the current post-date/time and author.
     831     * Prints HTML with meta information for the current post-date/time and author.
    832832     *
    833833     * Create your own twentyeleven_posted_on to override in a child theme
    … …  
    941941if ( ! function_exists( 'wp_body_open' ) ) :
    942942    /**
    943      * Fire the wp_body_open action.
     943     * Fires the wp_body_open action.
    944944     *
    945945     * Added for backward compatibility to support pre-5.2.0 WordPress versions.
    … …  
    958958
    959959/**
    960  * Include a skip to content link at the top of the page so that users can bypass the menu.
     960 * Includes a skip to content link at the top of the page so that users can bypass the menu.
    961961 *
    962962 * @since Twenty Eleven 3.4

  • trunk/src/wp-content/themes/twentyeleven/inc/theme-options.php

    r60506 r60513  
    99
    1010/**
    11  * Properly enqueue styles and scripts for our theme options page.
     11 * Properly enqueues styles and scripts for our theme options page.
    1212 *
    1313 * This function is attached to the admin_enqueue_scripts action hook.
    … …  
    6666
    6767/**
    68  * Change the capability required to save the 'twentyeleven_options' options group.
     68 * Changes the capability required to save the 'twentyeleven_options' options group.
    6969 *
    7070 * @see twentyeleven_theme_options_init()     First parameter to register_setting() is the name of the options group.
    … …  
    142142
    143143/**
    144  * Return an array of color schemes registered for Twenty Eleven.
     144 * Returns an array of color schemes registered for Twenty Eleven.
    145145 *
    146146 * @since Twenty Eleven 1.0
    … …  
    173173
    174174/**
    175  * Return an array of layout options registered for Twenty Eleven.
     175 * Returns an array of layout options registered for Twenty Eleven.
    176176 *
    177177 * @since Twenty Eleven 1.0
    … …  
    207207
    208208/**
    209  * Return the default options for Twenty Eleven.
     209 * Returns the default options for Twenty Eleven.
    210210 *
    211211 * @since Twenty Eleven 1.0
    … …  
    235235
    236236/**
    237  * Return the default link color for Twenty Eleven, based on color scheme.
     237 * Returns the default link color for Twenty Eleven, based on color scheme.
    238238 *
    239239 * @since Twenty Eleven 1.0
    … …  
    258258
    259259/**
    260  * Return the options array for Twenty Eleven.
     260 * Returns the options array for Twenty Eleven.
    261261 *
    262262 * @since Twenty Eleven 1.0
    … …  
    267267
    268268/**
    269  * Render the Color Scheme setting field.
     269 * Renders the Color Scheme setting field.
    270270 *
    271271 * @since Twenty Eleven 1.3
    … …  
    291291
    292292/**
    293  * Render the Link Color setting field.
     293 * Renders the Link Color setting field.
    294294 *
    295295 * @since Twenty Eleven 1.3
    … …  
    313313
    314314/**
    315  * Render the Layout setting field.
     315 * Renders the Layout setting field.
    316316 *
    317317 * @since Twenty Eleven 1.3
    … …  
    335335
    336336/**
    337  * Render the theme options page for Twenty Eleven.
     337 * Renders the theme options page for Twenty Eleven.
    338338 *
    339339 * @since Twenty Eleven 1.2
    … …  
    363363
    364364/**
    365  * Sanitize and validate form input.
     365 * Sanitizes and validates form input.
    366366 *
    367367 * Accepts an array, return a sanitized array.
    … …  
    641641
    642642/**
    643  * Render the site title for the selective refresh partial.
     643 * Renders the site title for the selective refresh partial.
    644644 *
    645645 * @since Twenty Eleven 2.4
    … …  
    654654
    655655/**
    656  * Render the site tagline for the selective refresh partial.
     656 * Renders the site tagline for the selective refresh partial.
    657657 *
    658658 * @since Twenty Eleven 2.4
    … …  
    667667
    668668/**
    669  * Bind JS handlers to make Customizer preview reload changes asynchronously.
     669 * Binds JS handlers to make Customizer preview reload changes asynchronously.
    670670 *
    671671 * Used with blogname and blogdescription.

  • trunk/src/wp-content/themes/twentyeleven/inc/widgets.php

    r60506 r60513  
    151151
    152152    /**
    153      * Update widget settings.
     153     * Updates widget settings.
    154154     *
    155155     * Deals with the settings when they are saved by the admin. Here is
    … …  
    173173
    174174    /**
    175      * Flush widget cache.
     175     * Flushes widget cache.
    176176     *
    177177     * @since Twenty Eleven 1.0
Note: See TracChangeset for help on using the changeset viewer.