Docs: Standardize on 'backward compatibility/compatible' nomenclature in core inline docs.

Also use 'back-compat' in some inline comments where backward compatibility is the subject and shorthand feels more natural.

Note: 'backwards compatibility/compatibile' can also be considered correct, though it's primary seen in regular use in British English.

Props ocean90.
Fixes #36835.

Built from https://develop.svn.wordpress.org/trunk@37431


git-svn-id: http://core.svn.wordpress.org/trunk@37397 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2016-05-13 18:41:31 +00:00
parent 1e40ba291e
commit b1804afeaf
51 changed files with 95 additions and 96 deletions

View File

@ -175,7 +175,7 @@ if ( isset($plugin_page) ) {
if ( ! $page_hook = get_plugin_page_hook($plugin_page, $the_parent) ) { if ( ! $page_hook = get_plugin_page_hook($plugin_page, $the_parent) ) {
$page_hook = get_plugin_page_hook($plugin_page, $plugin_page); $page_hook = get_plugin_page_hook($plugin_page, $plugin_page);
// Backwards compatibility for plugins using add_management_page(). // Back-compat for plugins using add_management_page().
if ( empty( $page_hook ) && 'edit.php' == $pagenow && '' != get_plugin_page_hook($plugin_page, 'tools.php') ) { if ( empty( $page_hook ) && 'edit.php' == $pagenow && '' != get_plugin_page_hook($plugin_page, 'tools.php') ) {
// There could be plugin specific params on the URL, so we need the whole query string // There could be plugin specific params on the URL, so we need the whole query string
if ( !empty($_SERVER[ 'QUERY_STRING' ]) ) if ( !empty($_SERVER[ 'QUERY_STRING' ]) )

View File

@ -2466,7 +2466,7 @@ function wp_ajax_save_attachment() {
} }
/** /**
* Ajax handler for saving backwards compatible attachment attributes. * Ajax handler for saving backward compatible attachment attributes.
* *
* @since 3.5.0 * @since 3.5.0
*/ */
@ -2552,7 +2552,7 @@ function wp_ajax_save_attachment_order() {
* Ajax handler for sending an attachment to the editor. * Ajax handler for sending an attachment to the editor.
* *
* Generates the HTML to send an attachment to the editor. * Generates the HTML to send an attachment to the editor.
* Backwards compatible with the media_send_to_editor filter * Backward compatible with the media_send_to_editor filter
* and the chain of filters that follow. * and the chain of filters that follow.
* *
* @since 3.5.0 * @since 3.5.0
@ -2617,7 +2617,7 @@ function wp_ajax_send_attachment_to_editor() {
* *
* Generates the HTML to send a non-image embed link to the editor. * Generates the HTML to send a non-image embed link to the editor.
* *
* Backwards compatible with the following filters: * Backward compatible with the following filters:
* - file_send_to_editor_url * - file_send_to_editor_url
* - audio_send_to_editor_url * - audio_send_to_editor_url
* - video_send_to_editor_url * - video_send_to_editor_url

View File

@ -166,7 +166,7 @@ class WP_List_Table {
} }
/** /**
* Make private properties readable for backwards compatibility. * Make private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -181,7 +181,7 @@ class WP_List_Table {
} }
/** /**
* Make private properties settable for backwards compatibility. * Make private properties settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -197,7 +197,7 @@ class WP_List_Table {
} }
/** /**
* Make private properties checkable for backwards compatibility. * Make private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -212,7 +212,7 @@ class WP_List_Table {
} }
/** /**
* Make private properties un-settable for backwards compatibility. * Make private properties un-settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -226,7 +226,7 @@ class WP_List_Table {
} }
/** /**
* Make private/protected methods readable for backwards compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -432,7 +432,7 @@ class WP_List_Table {
* @access protected * @access protected
* *
* @param string $which The location of the bulk actions: 'top' or 'bottom'. * @param string $which The location of the bulk actions: 'top' or 'bottom'.
* This is designated as optional for backwards-compatibility. * This is designated as optional for backward compatibility.
*/ */
protected function bulk_actions( $which = '' ) { protected function bulk_actions( $which = '' ) {
if ( is_null( $this->_actions ) ) { if ( is_null( $this->_actions ) ) {

View File

@ -418,9 +418,7 @@ final class WP_Screen {
} }
/** /**
* Sets the old string-based contextual help for the screen. * Sets the old string-based contextual help for the screen for backward compatibility.
*
* For backwards compatibility.
* *
* @since 3.3.0 * @since 3.3.0
* *
@ -722,7 +720,7 @@ final class WP_Screen {
/** /**
* Render the screen's help section. * Render the screen's help section.
* *
* This will trigger the deprecated filters for backwards compatibility. * This will trigger the deprecated filters for backward compatibility.
* *
* @since 3.3.0 * @since 3.3.0
* *

View File

@ -487,7 +487,7 @@ function is_plugin_active_for_network( $plugin ) {
* be activated only as a network wide plugin. The plugin would also work * be activated only as a network wide plugin. The plugin would also work
* when Multisite is not enabled. * when Multisite is not enabled.
* *
* Checks for "Site Wide Only: true" for backwards compatibility. * Checks for "Site Wide Only: true" for backward compatibility.
* *
* @since 3.0.0 * @since 3.0.0
* *

View File

@ -394,7 +394,7 @@ $document.ready( function() {
} }
/* /*
* The `.below-h2` class is here just for backwards compatibility with plugins * The `.below-h2` class is here just for backward compatibility with plugins
* that are (incorrectly) using it. Do not use. Use `.inline` instead. See #34570. * that are (incorrectly) using it. Do not use. Use `.inline` instead. See #34570.
*/ */
$( 'div.updated, div.error, div.notice' ).not( '.inline, .below-h2' ).insertAfter( $( '.wrap h1, .wrap h2' ).first() ); $( 'div.updated, div.error, div.notice' ).not( '.inline, .below-h2' ).insertAfter( $( '.wrap h1, .wrap h2' ).first() );

View File

@ -70,6 +70,6 @@ var passwordStrength;
} }
}; };
// Backwards compatibility. // Back-compat.
passwordStrength = wp.passwordStrength.meter; passwordStrength = wp.passwordStrength.meter;
})(jQuery); })(jQuery);

View File

@ -1,5 +1,5 @@
/** /**
* Distraction-Free Writing (wp-fullscreen) backwards compatibility stub. * Distraction-Free Writing (wp-fullscreen) backward compatibility stub.
* Todo: remove at the end of 2016. * Todo: remove at the end of 2016.
* *
* Original was deprecated in 4.1, removed in 4.3. * Original was deprecated in 4.1, removed in 4.3.

View File

@ -265,7 +265,7 @@ $_wp_real_parent_file['page-new.php'] = 'edit.php?post_type=page';
$_wp_real_parent_file['wpmu-admin.php'] = 'tools.php'; $_wp_real_parent_file['wpmu-admin.php'] = 'tools.php';
$_wp_real_parent_file['ms-admin.php'] = 'tools.php'; $_wp_real_parent_file['ms-admin.php'] = 'tools.php';
// ensure we're backwards compatible // Ensure backward compatibility.
$compat = array( $compat = array(
'index' => 'dashboard', 'index' => 'dashboard',
'edit' => 'posts', 'edit' => 'posts',

View File

@ -11,7 +11,7 @@
wp_reset_vars( array( 'action' ) ); wp_reset_vars( array( 'action' ) );
if ( isset( $_GET['updated'] ) && isset( $_GET['page'] ) ) { if ( isset( $_GET['updated'] ) && isset( $_GET['page'] ) ) {
// For backwards compat with plugins that don't use the Settings API and just set updated=1 in the redirect // For back-compat with plugins that don't use the Settings API and just set updated=1 in the redirect.
add_settings_error('general', 'settings_updated', __('Settings saved.'), 'updated'); add_settings_error('general', 'settings_updated', __('Settings saved.'), 'updated');
} }

View File

@ -118,8 +118,7 @@ include(ABSPATH . 'wp-admin/admin-header.php');
/** /**
* Filter the tabs shown on the Add Themes screen. * Filter the tabs shown on the Add Themes screen.
* *
* This filter is for backwards compatibility only, for the suppression * This filter is for backward compatibility only, for the suppression of the upload tab.
* of the upload tab.
* *
* @since 2.8.0 * @since 2.8.0
* *

View File

@ -45,7 +45,7 @@ function get_the_author($deprecated = '') {
* still use the old behavior will also pass the value from get_the_author(). * still use the old behavior will also pass the value from get_the_author().
* *
* The normal, expected behavior of this function is to echo the author and not * The normal, expected behavior of this function is to echo the author and not
* return it. However, backwards compatibility has to be maintained. * return it. However, backward compatibility has to be maintained.
* *
* @since 0.71 * @since 0.71
* @see get_the_author() * @see get_the_author()

View File

@ -344,7 +344,7 @@ class WP_Object_Cache {
private $multisite; private $multisite;
/** /**
* Makes private properties readable for backwards compatibility. * Makes private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -357,7 +357,7 @@ class WP_Object_Cache {
} }
/** /**
* Makes private properties settable for backwards compatibility. * Makes private properties settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -371,7 +371,7 @@ class WP_Object_Cache {
} }
/** /**
* Makes private properties checkable for backwards compatibility. * Makes private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -384,7 +384,7 @@ class WP_Object_Cache {
} }
/** /**
* Makes private properties un-settable for backwards compatibility. * Makes private properties un-settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public

View File

@ -10,7 +10,7 @@
* Retrieve list of category objects. * Retrieve list of category objects.
* *
* If you change the type to 'link' in the arguments, then the link categories * If you change the type to 'link' in the arguments, then the link categories
* will be returned instead. Also all categories will be updated to be backwards * will be returned instead. Also all categories will be updated to be backward
* compatible with pre-2.3 plugins and themes. * compatible with pre-2.3 plugins and themes.
* *
* @since 2.1.0 * @since 2.1.0
@ -77,7 +77,7 @@ function get_categories( $args = '' ) {
* If you look at get_term(), then both types will be passed through several * If you look at get_term(), then both types will be passed through several
* filters and finally sanitized based on the $filter parameter value. * filters and finally sanitized based on the $filter parameter value.
* *
* The category will converted to maintain backwards compatibility. * The category will converted to maintain backward compatibility.
* *
* @since 1.5.1 * @since 1.5.1
* *

View File

@ -3,7 +3,7 @@
## ##
## Certificate data from Mozilla as of: Wed Sep 16 08:58:11 2015 ## Certificate data from Mozilla as of: Wed Sep 16 08:58:11 2015
## Includes a WordPress Modification - We include the 'legacy' 1024bit certificates ## Includes a WordPress Modification - We include the 'legacy' 1024bit certificates
## for backwards compatibility. See https://core.trac.wordpress.org/ticket/34935#comment:10 ## for backward compatibility. See https://core.trac.wordpress.org/ticket/34935#comment:10
## ##
## This is a bundle of X.509 certificates of public Certificate Authorities ## This is a bundle of X.509 certificates of public Certificate Authorities
## (CA). These were automatically extracted from Mozilla's root certificates ## (CA). These were automatically extracted from Mozilla's root certificates

View File

@ -38,7 +38,7 @@ class WP_oEmbed {
public static $early_providers = array(); public static $early_providers = array();
/** /**
* A list of private/protected methods, used for backwards compatibility. * A list of private/protected methods, used for backward compatibility.
* *
* @since 4.2.0 * @since 4.2.0
* @access private * @access private
@ -192,7 +192,7 @@ class WP_oEmbed {
} }
/** /**
* Exposes private/protected methods for backwards compatibility. * Exposes private/protected methods for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public

View File

@ -125,7 +125,7 @@ class WP_Comment_Query {
public $max_num_pages = 0; public $max_num_pages = 0;
/** /**
* Make private/protected methods readable for backwards compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public

View File

@ -54,7 +54,8 @@ final class _WP_Editors {
* @type string $editor_class Extra classes to add to the editor textarea element. Default empty. * @type string $editor_class Extra classes to add to the editor textarea element. Default empty.
* @type bool $teeny Whether to output the minimal editor config. Examples include * @type bool $teeny Whether to output the minimal editor config. Examples include
* Press This and the Comment editor. Default false. * Press This and the Comment editor. Default false.
* @type bool $dfw Deprecated in 4.1. Since 4.3 used only to enqueue wp-fullscreen-stub.js for backwards compatibility. * @type bool $dfw Deprecated in 4.1. Since 4.3 used only to enqueue wp-fullscreen-stub.js
* for backward compatibility.
* @type bool|array $tinymce Whether to load TinyMCE. Can be used to pass settings directly to * @type bool|array $tinymce Whether to load TinyMCE. Can be used to pass settings directly to
* TinyMCE using an array. Default true. * TinyMCE using an array. Default true.
* @type bool|array $quicktags Whether to load Quicktags. Can be used to pass settings directly to * @type bool|array $quicktags Whether to load Quicktags. Can be used to pass settings directly to

View File

@ -144,7 +144,7 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response implements ArrayAccess
/** /**
* Check if an ArrayAccess offset exists. * Check if an ArrayAccess offset exists.
* *
* This is for backwards compatibility for array access. * This is for array access back-compat.
* *
* @param string|int $key Array offset. * @param string|int $key Array offset.
* @return bool True if the offset exists, false otherwise. * @return bool True if the offset exists, false otherwise.
@ -157,7 +157,7 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response implements ArrayAccess
/** /**
* Get an ArrayAccess value. * Get an ArrayAccess value.
* *
* This is for backwards compatibility for array access. * This is for array access back-compat.
* *
* @param string|int $key Array offset to get. * @param string|int $key Array offset to get.
* @return mixed Value if the key is a valid offset, null if invalid. * @return mixed Value if the key is a valid offset, null if invalid.
@ -189,7 +189,7 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response implements ArrayAccess
/** /**
* Set an ArrayAccess value. * Set an ArrayAccess value.
* *
* This is for backwards compatibility for array access. * This is for array access back-compat.
* *
* @param string|int $key Array offset to set. * @param string|int $key Array offset to set.
* @param mixed $value Value to set. * @param mixed $value Value to set.
@ -219,7 +219,7 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response implements ArrayAccess
/** /**
* Unset an ArrayAccess value. * Unset an ArrayAccess value.
* *
* This is for backwards compatibility for array access. * This is for array access back-compat.
* *
* @param string|int $key Array offset to remove. * @param string|int $key Array offset to remove.
*/ */

View File

@ -415,7 +415,7 @@ class WP_Http_Streams {
/** /**
* Deprecated HTTP Transport method which used fsockopen. * Deprecated HTTP Transport method which used fsockopen.
* *
* This class is not used, and is included for backwards compatibility only. * This class is not used, and is included for backward compatibility only.
* All code should make use of WP_Http directly through its API. * All code should make use of WP_Http directly through its API.
* *
* @see WP_HTTP::request * @see WP_HTTP::request
@ -424,5 +424,5 @@ class WP_Http_Streams {
* @deprecated 3.7.0 Please use WP_HTTP::request() directly * @deprecated 3.7.0 Please use WP_HTTP::request() directly
*/ */
class WP_HTTP_Fsockopen extends WP_HTTP_Streams { class WP_HTTP_Fsockopen extends WP_HTTP_Streams {
// For backwards compatibility for users who are using the class directly. // For backward compatibility for users who are using the class directly.
} }

View File

@ -343,7 +343,7 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Use resizeImage() when it's available and a valid filter value is set. * Use resizeImage() when it's available and a valid filter value is set.
* Otherwise, fall back to the scaleImage() method for resizing, which * Otherwise, fall back to the scaleImage() method for resizing, which
* results in better image quality over resizeImage() with default filter * results in better image quality over resizeImage() with default filter
* settings and retains backwards compatibility with pre 4.5 functionality. * settings and retains backward compatibility with pre 4.5 functionality.
*/ */
if ( is_callable( array( $this->image, 'resizeImage' ) ) && $filter ) { if ( is_callable( array( $this->image, 'resizeImage' ) ) && $filter ) {
$this->image->setOption( 'filter:support', '2.0' ); $this->image->setOption( 'filter:support', '2.0' );

View File

@ -276,7 +276,7 @@ abstract class WP_Image_Editor {
} }
} }
// Allow 0, but squash to 1 due to identical images in GD, and for backwards compatibility. // Allow 0, but squash to 1 due to identical images in GD, and for backward compatibility.
if ( 0 === $quality ) { if ( 0 === $quality ) {
$quality = 1; $quality = 1;
} }

View File

@ -1743,7 +1743,7 @@ class WP_Rewrite {
* } * }
*/ */
public function add_permastruct( $name, $struct, $args = array() ) { public function add_permastruct( $name, $struct, $args = array() ) {
// Backwards compatibility for the old parameters: $with_front and $ep_mask. // Back-compat for the old parameters: $with_front and $ep_mask.
if ( ! is_array( $args ) ) if ( ! is_array( $args ) )
$args = array( 'with_front' => $args ); $args = array( 'with_front' => $args );
if ( func_num_args() == 4 ) if ( func_num_args() == 4 )

View File

@ -79,7 +79,7 @@ class WP_Roles {
} }
/** /**
* Make private/protected methods readable for backwards compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public

View File

@ -447,8 +447,10 @@ final class WP_Theme implements ArrayAccess {
switch ( $offset ) { switch ( $offset ) {
case 'Name' : case 'Name' :
case 'Title' : case 'Title' :
// See note above about using translated data. get() is not ideal. /*
// It is only for backwards compatibility. Use display(). * See note above about using translated data. get() is not ideal.
* It is only for backward compatibility. Use display().
*/
return $this->get('Name'); return $this->get('Name');
case 'Author' : case 'Author' :
return $this->display( 'Author'); return $this->display( 'Author');

View File

@ -736,7 +736,7 @@ class WP_User_Query {
} }
/** /**
* Make private properties readable for backwards compatibility. * Make private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -751,7 +751,7 @@ class WP_User_Query {
} }
/** /**
* Make private properties settable for backwards compatibility. * Make private properties settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -767,7 +767,7 @@ class WP_User_Query {
} }
/** /**
* Make private properties checkable for backwards compatibility. * Make private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -782,7 +782,7 @@ class WP_User_Query {
} }
/** /**
* Make private properties un-settable for backwards compatibility. * Make private properties un-settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -796,7 +796,7 @@ class WP_User_Query {
} }
/** /**
* Make private/protected methods readable for backwards compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public

View File

@ -242,7 +242,7 @@ class WP_User {
} }
/** /**
* Makes private/protected methods readable for backwards compatibility. * Makes private/protected methods readable for backward compatibility.
* *
* @since 4.3.0 * @since 4.3.0
* @access public * @access public

View File

@ -139,7 +139,7 @@ class Walker {
//display this element //display this element
$this->has_children = ! empty( $children_elements[ $id ] ); $this->has_children = ! empty( $children_elements[ $id ] );
if ( isset( $args[0] ) && is_array( $args[0] ) ) { if ( isset( $args[0] ) && is_array( $args[0] ) ) {
$args[0]['has_children'] = $this->has_children; // Backwards compatibility. $args[0]['has_children'] = $this->has_children; // Back-compat.
} }
$cb_args = array_merge( array(&$output, $element, $depth), $args); $cb_args = array_merge( array(&$output, $element, $depth), $args);
@ -386,7 +386,7 @@ class Walker {
* *
* @since 2.7.0 * @since 2.7.0
* @access public * @access public
* *
* @param array $elements Elements to list. * @param array $elements Elements to list.
* @return int Number of root elements. * @return int Number of root elements.
*/ */

View File

@ -171,7 +171,7 @@ class wp_xmlrpc_server extends IXR_Server {
} }
/** /**
* Make private/protected methods readable for backwards compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public

View File

@ -704,7 +704,7 @@ function get_comment_link( $comment = null, $args = array() ) {
$comment = get_comment($comment); $comment = get_comment($comment);
// Backwards compat // Back-compat.
if ( ! is_array( $args ) ) { if ( ! is_array( $args ) ) {
$args = array( 'page' => $args ); $args = array( 'page' => $args );
} }

View File

@ -8,7 +8,7 @@ buttons in the following files are updated.
WordPress-style Buttons WordPress-style Buttons
======================= =======================
Create a button by adding the `.button` class to an element. For backwards Create a button by adding the `.button` class to an element. For backward
compatibility, we support several other classes (such as `.button-secondary`), compatibility, we support several other classes (such as `.button-secondary`),
but these will *not* work with the stackable classes described below. but these will *not* work with the stackable classes described below.

View File

@ -8,7 +8,7 @@ buttons in the following files are updated.
WordPress-style Buttons WordPress-style Buttons
======================= =======================
Create a button by adding the `.button` class to an element. For backwards Create a button by adding the `.button` class to an element. For backward
compatibility, we support several other classes (such as `.button-secondary`), compatibility, we support several other classes (such as `.button-secondary`),
but these will *not* work with the stackable classes described below. but these will *not* work with the stackable classes described below.

View File

@ -2061,7 +2061,7 @@ function js_escape( $text ) {
*/ */
function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) { function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
_deprecated_function( __FUNCTION__, '2.8', 'esc_html()' ); _deprecated_function( __FUNCTION__, '2.8', 'esc_html()' );
if ( func_num_args() > 1 ) { // Maintain backwards compat for people passing additional args if ( func_num_args() > 1 ) { // Maintain back-compat for people passing additional arguments.
$args = func_get_args(); $args = func_get_args();
return call_user_func_array( '_wp_specialchars', $args ); return call_user_func_array( '_wp_specialchars', $args );
} else { } else {
@ -2085,14 +2085,14 @@ function attribute_escape( $text ) {
} }
/** /**
* Register widget for sidebar with backwards compatibility. * Register widget for sidebar with backward compatibility.
* *
* Allows $name to be an array that accepts either three elements to grab the * Allows $name to be an array that accepts either three elements to grab the
* first element and the third for the name or just uses the first element of * first element and the third for the name or just uses the first element of
* the array for the name. * the array for the name.
* *
* Passes to {@link wp_register_sidebar_widget()} after argument list and * Passes to wp_register_sidebar_widget() after argument list and backward
* backwards compatibility is complete. * compatibility is complete.
* *
* @since 2.2.0 * @since 2.2.0
* @deprecated 2.8.0 Use wp_register_sidebar_widget() * @deprecated 2.8.0 Use wp_register_sidebar_widget()

View File

@ -934,7 +934,7 @@ function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = fals
$string = @htmlspecialchars( $string, $quote_style, $charset, $double_encode ); $string = @htmlspecialchars( $string, $quote_style, $charset, $double_encode );
// Backwards compatibility // Back-compat.
if ( 'single' === $_quote_style ) if ( 'single' === $_quote_style )
$string = str_replace( "'", ''', $string ); $string = str_replace( "'", ''', $string );

View File

@ -1849,7 +1849,8 @@ function wp_get_upload_dir() {
* @uses _wp_upload_dir() * @uses _wp_upload_dir()
* *
* @param string $time Optional. Time formatted in 'yyyy/mm'. Default null. * @param string $time Optional. Time formatted in 'yyyy/mm'. Default null.
* @param bool $create_dir Optional. Whether to check and create the uploads directory. Default true (backwards compatible). * @param bool $create_dir Optional. Whether to check and create the uploads directory.
* Default true for backward compatibility.
* @param bool $refresh_cache Optional. Whether to refresh the cache. Default false. * @param bool $refresh_cache Optional. Whether to refresh the cache. Default false.
* @return array See above for description. * @return array See above for description.
*/ */

View File

@ -1074,7 +1074,7 @@ function _wp_render_title_tag() {
* or the page title. However, it is mostly common sense to have the blog title * or the page title. However, it is mostly common sense to have the blog title
* to the right with most browsers supporting tabs. You can achieve this by * to the right with most browsers supporting tabs. You can achieve this by
* using the seplocation parameter and setting the value to 'right'. This change * using the seplocation parameter and setting the value to 'right'. This change
* was introduced around 2.5.0, in case backwards compatibility of themes is * was introduced around 2.5.0, in case backward compatibility of themes is
* important. * important.
* *
* @since 1.0.0 * @since 1.0.0

View File

@ -96,8 +96,7 @@ window.wp = window.wp || {};
// Use with PHP's wp_send_json_success() and wp_send_json_error() // Use with PHP's wp_send_json_success() and wp_send_json_error()
deferred.jqXHR = $.ajax( options ).done( function( response ) { deferred.jqXHR = $.ajax( options ).done( function( response ) {
// Treat a response of `1` as successful for backwards // Treat a response of 1 as successful for backward compatibility with existing handlers.
// compatibility with existing handlers.
if ( response === '1' || response === 1 ) if ( response === '1' || response === 1 )
response = { success: true }; response = { success: true };

View File

@ -331,7 +331,7 @@ function wp_set_lang_dir() {
*/ */
define( 'WP_LANG_DIR', WP_CONTENT_DIR . '/languages' ); define( 'WP_LANG_DIR', WP_CONTENT_DIR . '/languages' );
if ( !defined( 'LANGDIR' ) ) { if ( !defined( 'LANGDIR' ) ) {
// Old static relative path maintained for limited backwards compatibility - won't work in some cases // Old static relative path maintained for limited backward compatibility - won't work in some cases.
define( 'LANGDIR', 'wp-content/languages' ); define( 'LANGDIR', 'wp-content/languages' );
} }
} else { } else {
@ -344,7 +344,7 @@ function wp_set_lang_dir() {
*/ */
define( 'WP_LANG_DIR', ABSPATH . WPINC . '/languages' ); define( 'WP_LANG_DIR', ABSPATH . WPINC . '/languages' );
if ( !defined( 'LANGDIR' ) ) { if ( !defined( 'LANGDIR' ) ) {
// Old relative path maintained for backwards compatibility // Old relative path maintained for backward compatibility.
define( 'LANGDIR', WPINC . '/languages' ); define( 'LANGDIR', WPINC . '/languages' );
} }
} }

View File

@ -332,9 +332,11 @@ class WP_Locale {
} }
/** /**
* Global variables are deprecated. For backwards compatibility only. * Global variables are deprecated.
* *
* @deprecated For backwards compatibility only. * For backward compatibility only.
*
* @deprecated For backward compatibility only.
* @access private * @access private
* *
* @global array $weekday * @global array $weekday

View File

@ -4123,7 +4123,7 @@ class WP_Query {
} }
/** /**
* Make private properties readable for backwards compatibility. * Make private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -4138,7 +4138,7 @@ class WP_Query {
} }
/** /**
* Make private properties checkable for backwards compatibility. * Make private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -4153,7 +4153,7 @@ class WP_Query {
} }
/** /**
* Make private/protected methods readable for backwards compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public

View File

@ -293,7 +293,7 @@ class WP_REST_Response extends WP_HTTP_Response {
* *
* Well-behaved clients should expand and normalise these back to their * Well-behaved clients should expand and normalise these back to their
* full URI relation, however some naive clients may not resolve these * full URI relation, however some naive clients may not resolve these
* correctly, so adding new CURIEs may break backwards compatibility. * correctly, so adding new CURIEs may break backward compatibility.
* *
* @since 4.5.0 * @since 4.5.0
* *

View File

@ -202,7 +202,7 @@ function remove_rewrite_tag( $tag ) {
function add_permastruct( $name, $struct, $args = array() ) { function add_permastruct( $name, $struct, $args = array() ) {
global $wp_rewrite; global $wp_rewrite;
// backwards compatibility for the old parameters: $with_front and $ep_mask // Back-compat for the old parameters: $with_front and $ep_mask.
if ( ! is_array( $args ) ) if ( ! is_array( $args ) )
$args = array( 'with_front' => $args ); $args = array( 'with_front' => $args );
if ( func_num_args() == 4 ) if ( func_num_args() == 4 )

View File

@ -14,7 +14,7 @@
* Creates the initial taxonomies. * Creates the initial taxonomies.
* *
* This function fires twice: in wp-settings.php before plugins are loaded (for * This function fires twice: in wp-settings.php before plugins are loaded (for
* backwards compatibility reasons), and again on the {@see 'init'} action. We must * backward compatibility reasons), and again on the {@see 'init'} action. We must
* avoid registering rewrite rules before the {@see 'init'} action. * avoid registering rewrite rules before the {@see 'init'} action.
* *
* @since 2.8.0 * @since 2.8.0
@ -2197,7 +2197,7 @@ function wp_count_terms( $taxonomy, $args = array() ) {
$defaults = array('hide_empty' => false); $defaults = array('hide_empty' => false);
$args = wp_parse_args($args, $defaults); $args = wp_parse_args($args, $defaults);
// backwards compatibility // backward compatibility
if ( isset($args['ignore_empty']) ) { if ( isset($args['ignore_empty']) ) {
$args['hide_empty'] = $args['ignore_empty']; $args['hide_empty'] = $args['ignore_empty'];
unset($args['ignore_empty']); unset($args['ignore_empty']);

View File

@ -4,7 +4,7 @@
* @subpackage Theme_Compat * @subpackage Theme_Compat
* @deprecated 3.0 * @deprecated 3.0
* *
* This file is here for Backwards compatibility with old themes and will be removed in a future version * This file is here for backward compatibility with old themes and will be removed in a future version
* *
*/ */
_deprecated_file( _deprecated_file(

View File

@ -4,8 +4,7 @@
* @subpackage Theme_Compat * @subpackage Theme_Compat
* @deprecated 3.0 * @deprecated 3.0
* *
* This file is here for Backwards compatibility with old themes and will be removed in a future version * This file is here for backward compatibility with old themes and will be removed in a future version
*
*/ */
_deprecated_file( _deprecated_file(
/* translators: %s: template name */ /* translators: %s: template name */

View File

@ -4,8 +4,7 @@
* @subpackage Theme_Compat * @subpackage Theme_Compat
* @deprecated 3.0 * @deprecated 3.0
* *
* This file is here for Backwards compatibility with old themes and will be removed in a future version * This file is here for backward compatibility with old themes and will be removed in a future version.
*
*/ */
_deprecated_file( _deprecated_file(
/* translators: %s: template name */ /* translators: %s: template name */

View File

@ -4,8 +4,7 @@
* @subpackage Theme_Compat * @subpackage Theme_Compat
* @deprecated 3.0 * @deprecated 3.0
* *
* This file is here for Backwards compatibility with old themes and will be removed in a future version * This file is here for backward compatibility with old themes and will be removed in a future version.
*
*/ */
_deprecated_file( _deprecated_file(
/* translators: %s: template name */ /* translators: %s: template name */

View File

@ -664,7 +664,7 @@ function locale_stylesheet() {
* Switches the theme. * Switches the theme.
* *
* Accepts one argument: $stylesheet of the theme. It also accepts an additional function signature * Accepts one argument: $stylesheet of the theme. It also accepts an additional function signature
* of two arguments: $template then $stylesheet. This is for backwards compatibility. * of two arguments: $template then $stylesheet. This is for backward compatibility.
* *
* @since 2.5.0 * @since 2.5.0
* *
@ -1634,7 +1634,7 @@ function add_theme_support( $feature ) {
// the constant is always accurate (and is not defined later, overriding our value). // the constant is always accurate (and is not defined later, overriding our value).
// As stated above, the first value wins. // As stated above, the first value wins.
// Once we get to wp_loaded (just-in-time), define any constants we haven't already. // Once we get to wp_loaded (just-in-time), define any constants we haven't already.
// Constants are lame. Don't reference them. This is just for backwards compatibility. // Constants are lame. Don't reference them. This is just for backward compatibility.
if ( defined( 'NO_HEADER_TEXT' ) ) if ( defined( 'NO_HEADER_TEXT' ) )
$args[0]['header-text'] = ! NO_HEADER_TEXT; $args[0]['header-text'] = ! NO_HEADER_TEXT;

View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '4.6-alpha-37430'; $wp_version = '4.6-alpha-37431';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.

View File

@ -685,7 +685,7 @@ class wpdb {
} }
/** /**
* Magic function, for backwards compatibility. * Magic function, for backward compatibility.
* *
* @since 3.5.0 * @since 3.5.0
* *
@ -705,7 +705,7 @@ class wpdb {
} }
/** /**
* Magic function, for backwards compatibility. * Magic function, for backward compatibility.
* *
* @since 3.5.0 * @since 3.5.0
* *
@ -718,7 +718,7 @@ class wpdb {
} }
/** /**
* Magic function, for backwards compatibility. * Magic function, for backward compatibility.
* *
* @since 3.5.0 * @since 3.5.0
* *

View File

@ -458,7 +458,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
} }
/** /**
* Make private properties readable for backwards compatibility. * Make private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -473,7 +473,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
} }
/** /**
* Make private properties settable for backwards compatibility. * Make private properties settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -489,7 +489,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
} }
/** /**
* Make private properties checkable for backwards compatibility. * Make private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public
@ -504,7 +504,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
} }
/** /**
* Make private properties un-settable for backwards compatibility. * Make private properties un-settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public * @access public