Context Navigation

Changeset 60535

Timestamp:

08/02/2025 01:26:26 PM (6 months ago)

Author:

SergeyBiryukov

Message:

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

Props vladimiraus, mukesh27, SergeyBiryukov.
See #63692.

Location:

trunk/src/wp-content/themes/twentynineteen

Files:

-                      r60495
+                      r60535
 /**
  * Register widget area.
+ * Registers widget area.
+ *
  * @link https://developer.wordpress.org/themes/functionality/sidebars/#registering-a-sidebar
 …
 /**
  * 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.
 …
 /**
  * Fix skip link focus in IE11.
+ * Fixes skip link focus in IE11.
+ *
  * This does not enqueue the script because it is tiny and because it is only for IE11,
 …
 /**
  * Enqueue supplemental block editor styles.
+ * Enqueues supplemental block editor styles.
  */
 function twentynineteen_editor_customizer_styles() {
 …
 /**
  * Display custom color CSS in customizer and on frontend.
+ * Displays custom color CSS in customizer and on frontend.
  */
 function twentynineteen_colors_css_wrap() {
 …
 /**
  * Register block patterns and pattern categories.
+ * Registers block patterns and pattern categories.
+ *
  * @since Twenty Nineteen 3.0

r51155	r60535
13	13
14	14	/**
15		* Prevent switching to Twenty Nineteen on old versions of WordPress.
	15	* Prevents switching to Twenty Nineteen on old versions of WordPress.
16	16	*
17	17	* Switches to the default theme.

r57712	r60535
9	9
10	10	/**
11		* Generate the CSS for the current primary color.
	11	* Generates the CSS for the current primary color.
12	12	*/
13	13	function twentynineteen_custom_colors_css() {

-                      r60478
+                      r60535
 /**
  * Add postMessage support for site title and description for the Theme Customizer.
+ * Adds postMessage support for site title and description for the Theme Customizer.
+ *
  * @param WP_Customize_Manager $wp_customize Theme Customizer object.
 …
 /**
  * Render the site title for the selective refresh partial.
+ * Renders the site title for the selective refresh partial.
+ *
  * @return void
 …
 /**
  * Render the site tagline for the selective refresh partial.
+ * Renders the site tagline for the selective refresh partial.
+ *
  * @return void
 …
 /**
  * Bind JS handlers to instantly live-preview changes.
+ * Binds JS handlers to instantly live-preview changes.
  */
 function twentynineteen_customize_preview_js() {
 …
 /**
  * Load dynamic logic for the customizer controls area.
+ * Loads dynamic logic for the customizer controls area.
  */
 function twentynineteen_panels_js() {
 …
 /**
  * Sanitize custom color choice.
+ * Sanitizes custom color choice.
+ *
  * @param string $choice Whether image filter is active.

-                      r59103
+                      r60535
 /**
  * Display SVG icons in social links menu.
+ * Displays SVG icons in social links menu.
+ *
  * @param string   $item_output The menu item's starting HTML output.
 …
 /**
  * Add a dropdown icon to top-level menu items.
+ * Adds a dropdown icon to top-level menu items.
+ *
  * @param string   $item_output The menu item's starting HTML output.

-                      r55276
+                      r60535
 if ( ! function_exists( 'twentynineteen_comment_form' ) ) :
     /**
      * Documentation for function.
+     * Displays the comment form.
      */
     function twentynineteen_comment_form( $order ) {
 …
 if ( ! function_exists( 'twentynineteen_the_posts_navigation' ) ) :
     /**
      * Documentation for function.
+     * Displays the next and previous posts navigation.
      */
     function twentynineteen_the_posts_navigation() {
 …
 if ( ! function_exists( 'wp_body_open' ) ) :
     /**
      * Fire the wp_body_open action.
+     * Fires the wp_body_open action.
+     *
      * Added for backward compatibility to support pre-5.2.0 WordPress versions.

-                      r55972
+                      r60535
     /**
      * Add class.
+     * Adds class to an element.
+     *
      * @param {Object} el
 …
     /**
      * Delete class.
+     * Deletes class from an element.
+     *
      * @param {Object} el
 …
     /**
      * Has class?
+     * Determines whether an element has the given class.
+     *
      * @param {Object} el
 …
     /**
      * Toggle Aria Expanded state for screenreaders.
+     * Toggles Aria Expanded state for screenreaders.
+     *
      * @param {Object} ariaItem
 …
     /**
      * Open sub-menu.
+     * Opens sub-menu.
+     *
      * @param {Object} currentSubMenu
 …
     /**
      * Close sub-menu.
+     * Closes sub-menu.
+     *
      * @param {Object} currentSubMenu
 …
     /**
      * Find first ancestor of an element by selector.
+     * Finds first ancestor of an element by selector.
+     *
      * @param {Object} child
 …
     /**
      * Remove all off-canvas states.
+     * Removes all off-canvas states.
      */
     function removeAllFocusStates() {
 …
     /**
      * Toggle `focus` class to allow sub-menu access on touch screens.
+     * Toggles `focus` class to allow sub-menu access on touch screens.
      */
     function toggleSubmenuDisplay() {

Note: See TracChangeset for help on using the changeset viewer.