mirror of
https://github.com/WordPress/WordPress.git
synced 2024-12-23 01:27:36 +01:00
Docs: Fix third-person singular verbs in DocBlock summaries throughout WP_Rewrite
.
See #34218. Built from https://develop.svn.wordpress.org/trunk@34944 git-svn-id: http://core.svn.wordpress.org/trunk@34909 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
639371de09
commit
305ae14461
@ -367,7 +367,7 @@ class WP_Rewrite {
|
|||||||
public $feeds = array( 'feed', 'rdf', 'rss', 'rss2', 'atom' );
|
public $feeds = array( 'feed', 'rdf', 'rss', 'rss2', 'atom' );
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Whether permalinks are being used.
|
* Determines whether permalinks are being used.
|
||||||
*
|
*
|
||||||
* This can be either rewrite module or permalink in the HTTP query string.
|
* This can be either rewrite module or permalink in the HTTP query string.
|
||||||
*
|
*
|
||||||
@ -381,14 +381,14 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Whether permalinks are being used and rewrite module is not enabled.
|
* Determins whether permalinks are being used and rewrite module is not enabled.
|
||||||
*
|
*
|
||||||
* Means that permalink links are enabled and index.php is in the URL.
|
* Means that permalink links are enabled and index.php is in the URL.
|
||||||
*
|
*
|
||||||
* @since 1.5.0
|
* @since 1.5.0
|
||||||
* @access public
|
* @access public
|
||||||
*
|
*
|
||||||
* @return bool
|
* @return bool Whether permalink links are enabled and index.php is in the URL.
|
||||||
*/
|
*/
|
||||||
public function using_index_permalinks() {
|
public function using_index_permalinks() {
|
||||||
if ( empty( $this->permalink_structure ) ) {
|
if ( empty( $this->permalink_structure ) ) {
|
||||||
@ -399,21 +399,21 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Whether permalinks are being used and rewrite module is enabled.
|
* Determines whether permalinks are being used and rewrite module is enabled.
|
||||||
*
|
*
|
||||||
* Using permalinks and index.php is not in the URL.
|
* Using permalinks and index.php is not in the URL.
|
||||||
*
|
*
|
||||||
* @since 1.5.0
|
* @since 1.5.0
|
||||||
* @access public
|
* @access public
|
||||||
*
|
*
|
||||||
* @return bool
|
* @return bool Whether permalink links are enabled and index.php is NOT in the URL.
|
||||||
*/
|
*/
|
||||||
public function using_mod_rewrite_permalinks() {
|
public function using_mod_rewrite_permalinks() {
|
||||||
return $this->using_permalinks() && ! $this->using_index_permalinks();
|
return $this->using_permalinks() && ! $this->using_index_permalinks();
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Index for matches for usage in preg_*() functions.
|
* Indexes for matches for usage in preg_*() functions.
|
||||||
*
|
*
|
||||||
* The format of the string is, with empty matches property value, '$NUM'.
|
* The format of the string is, with empty matches property value, '$NUM'.
|
||||||
* The 'NUM' will be replaced with the value in the $number parameter. With
|
* The 'NUM' will be replaced with the value in the $number parameter. With
|
||||||
@ -441,7 +441,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve all page and attachments for pages URIs.
|
* Retrieves all page and attachments for pages URIs.
|
||||||
*
|
*
|
||||||
* The attachments are for those that have pages as parents and will be
|
* The attachments are for those that have pages as parents and will be
|
||||||
* retrieved.
|
* retrieved.
|
||||||
@ -449,7 +449,7 @@ class WP_Rewrite {
|
|||||||
* @since 2.5.0
|
* @since 2.5.0
|
||||||
* @access public
|
* @access public
|
||||||
*
|
*
|
||||||
* @global wpdb $wpdb
|
* @global wpdb $wpdb WordPress database abstraction object.
|
||||||
*
|
*
|
||||||
* @return array Array of page URIs as first element and attachment URIs as second element.
|
* @return array Array of page URIs as first element and attachment URIs as second element.
|
||||||
*/
|
*/
|
||||||
@ -488,12 +488,12 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve all of the rewrite rules for pages.
|
* Retrieves all of the rewrite rules for pages.
|
||||||
*
|
*
|
||||||
* @since 1.5.0
|
* @since 1.5.0
|
||||||
* @access public
|
* @access public
|
||||||
*
|
*
|
||||||
* @return array
|
* @return array Page rewrite rules.
|
||||||
*/
|
*/
|
||||||
public function page_rewrite_rules() {
|
public function page_rewrite_rules() {
|
||||||
// the extra .? at the beginning prevents clashes with other regular expressions in the rules array
|
// the extra .? at the beginning prevents clashes with other regular expressions in the rules array
|
||||||
@ -503,7 +503,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve date permalink structure, with year, month, and day.
|
* Retrieves date permalink structure, with year, month, and day.
|
||||||
*
|
*
|
||||||
* The permalink structure for the date, if not set already depends on the
|
* The permalink structure for the date, if not set already depends on the
|
||||||
* permalink structure. It can be one of three formats. The first is year,
|
* permalink structure. It can be one of three formats. The first is year,
|
||||||
@ -566,7 +566,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the year permalink structure without month and day.
|
* Retrieves the year permalink structure without month and day.
|
||||||
*
|
*
|
||||||
* Gets the date permalink structure and strips out the month and day
|
* Gets the date permalink structure and strips out the month and day
|
||||||
* permalink structures.
|
* permalink structures.
|
||||||
@ -590,7 +590,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the month permalink structure without day and with year.
|
* Retrieves the month permalink structure without day and with year.
|
||||||
*
|
*
|
||||||
* Gets the date permalink structure and strips out the day permalink
|
* Gets the date permalink structure and strips out the day permalink
|
||||||
* structures. Keeps the year permalink structure.
|
* structures. Keeps the year permalink structure.
|
||||||
@ -613,7 +613,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the day permalink structure with month and year.
|
* Retrieves the day permalink structure with month and year.
|
||||||
*
|
*
|
||||||
* Keeps date permalink structure with all year, month, and day.
|
* Keeps date permalink structure with all year, month, and day.
|
||||||
*
|
*
|
||||||
@ -627,7 +627,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the permalink structure for categories.
|
* Retrieves the permalink structure for categories.
|
||||||
*
|
*
|
||||||
* If the category_base property has no value, then the category structure
|
* If the category_base property has no value, then the category structure
|
||||||
* will have the front property value, followed by 'category', and finally
|
* will have the front property value, followed by 'category', and finally
|
||||||
@ -661,7 +661,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve extra permalink structure by name.
|
* Retrieves an extra permalink structure by name.
|
||||||
*
|
*
|
||||||
* @since 2.5.0
|
* @since 2.5.0
|
||||||
* @access public
|
* @access public
|
||||||
@ -680,7 +680,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the author permalink structure.
|
* Retrieves the author permalink structure.
|
||||||
*
|
*
|
||||||
* The permalink structure is front property, author base, and finally
|
* The permalink structure is front property, author base, and finally
|
||||||
* '/%author%'. Will set the author_structure property and then return it
|
* '/%author%'. Will set the author_structure property and then return it
|
||||||
@ -706,7 +706,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the search permalink structure.
|
* Retrieves the search permalink structure.
|
||||||
*
|
*
|
||||||
* The permalink structure is root property, search base, and finally
|
* The permalink structure is root property, search base, and finally
|
||||||
* '/%search%'. Will set the search_structure property and then return it
|
* '/%search%'. Will set the search_structure property and then return it
|
||||||
@ -732,7 +732,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the page permalink structure.
|
* Retrieves the page permalink structure.
|
||||||
*
|
*
|
||||||
* The permalink structure is root property, and '%pagename%'. Will set the
|
* The permalink structure is root property, and '%pagename%'. Will set the
|
||||||
* page_structure property and then return it without attempting to set the
|
* page_structure property and then return it without attempting to set the
|
||||||
@ -758,7 +758,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the feed permalink structure.
|
* Retrieves the feed permalink structure.
|
||||||
*
|
*
|
||||||
* The permalink structure is root property, feed base, and finally
|
* The permalink structure is root property, feed base, and finally
|
||||||
* '/%feed%'. Will set the feed_structure property and then return it
|
* '/%feed%'. Will set the feed_structure property and then return it
|
||||||
@ -784,7 +784,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the comment feed permalink structure.
|
* Retrieves the comment feed permalink structure.
|
||||||
*
|
*
|
||||||
* The permalink structure is root property, comment base property, feed
|
* The permalink structure is root property, comment base property, feed
|
||||||
* base and finally '/%feed%'. Will set the comment_feed_structure property
|
* base and finally '/%feed%'. Will set the comment_feed_structure property
|
||||||
@ -810,7 +810,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Add or update existing rewrite tags (e.g. %postname%).
|
* Adds or updates existing rewrite tags (e.g. %postname%).
|
||||||
*
|
*
|
||||||
* If the tag already exists, replace the existing pattern and query for
|
* If the tag already exists, replace the existing pattern and query for
|
||||||
* that tag, otherwise add the new tag.
|
* that tag, otherwise add the new tag.
|
||||||
@ -839,7 +839,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Generate rewrite rules from a permalink structure.
|
* Generates rewrite rules from a permalink structure.
|
||||||
*
|
*
|
||||||
* The main WP_Rewrite function for building the rewrite rule list. The
|
* The main WP_Rewrite function for building the rewrite rule list. The
|
||||||
* contents of the function is a mix of black magic and regular expressions,
|
* contents of the function is a mix of black magic and regular expressions,
|
||||||
@ -1142,7 +1142,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Generate Rewrite rules with permalink structure and walking directory only.
|
* Generates rewrite rules with permalink structure and walking directory only.
|
||||||
*
|
*
|
||||||
* Shorten version of WP_Rewrite::generate_rewrite_rules() that allows for shorter
|
* Shorten version of WP_Rewrite::generate_rewrite_rules() that allows for shorter
|
||||||
* list of parameters. See the method for longer description of what generating
|
* list of parameters. See the method for longer description of what generating
|
||||||
@ -1162,7 +1162,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Construct rewrite matches and queries from permalink structure.
|
* Constructs rewrite matches and queries from permalink structure.
|
||||||
*
|
*
|
||||||
* Runs the action 'generate_rewrite_rules' with the parameter that is an
|
* Runs the action 'generate_rewrite_rules' with the parameter that is an
|
||||||
* reference to the current WP_Rewrite instance to further manipulate the
|
* reference to the current WP_Rewrite instance to further manipulate the
|
||||||
@ -1368,7 +1368,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve the rewrite rules.
|
* Retrieves the rewrite rules.
|
||||||
*
|
*
|
||||||
* The difference between this method and WP_Rewrite::rewrite_rules() is that
|
* The difference between this method and WP_Rewrite::rewrite_rules() is that
|
||||||
* this method stores the rewrite rules in the 'rewrite_rules' option and retrieves
|
* this method stores the rewrite rules in the 'rewrite_rules' option and retrieves
|
||||||
@ -1392,7 +1392,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve mod_rewrite formatted rewrite rules to write to .htaccess.
|
* Retrieves mod_rewrite-formatted rewrite rules to write to .htaccess.
|
||||||
*
|
*
|
||||||
* Does not actually write to the .htaccess file, but creates the rules for
|
* Does not actually write to the .htaccess file, but creates the rules for
|
||||||
* the process that will.
|
* the process that will.
|
||||||
@ -1491,7 +1491,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve IIS7 URL Rewrite formatted rewrite rules to write to web.config file.
|
* Retrieves IIS7 URL Rewrite formatted rewrite rules to write to web.config file.
|
||||||
*
|
*
|
||||||
* Does not actually write to the web.config file, but creates the rules for
|
* Does not actually write to the web.config file, but creates the rules for
|
||||||
* the process that will.
|
* the process that will.
|
||||||
@ -1541,7 +1541,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Add a straight rewrite rule.
|
* Adds a straight rewrite rule.
|
||||||
*
|
*
|
||||||
* Any value in the $after parameter that isn't 'bottom' will be placed at
|
* Any value in the $after parameter that isn't 'bottom' will be placed at
|
||||||
* the top of the rules.
|
* the top of the rules.
|
||||||
@ -1579,7 +1579,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Add a rule that doesn't redirect to index.php.
|
* Adds a rule that doesn't redirect to index.php.
|
||||||
*
|
*
|
||||||
* Can redirect to any place.
|
* Can redirect to any place.
|
||||||
*
|
*
|
||||||
@ -1594,7 +1594,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Add an endpoint, like /trackback/.
|
* Adds an endpoint, like /trackback/.
|
||||||
*
|
*
|
||||||
* @since 2.1.0
|
* @since 2.1.0
|
||||||
* @since 3.9.0 $query_var parameter added.
|
* @since 3.9.0 $query_var parameter added.
|
||||||
@ -1625,7 +1625,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Add a new permalink structure.
|
* Adds a new permalink structure.
|
||||||
*
|
*
|
||||||
* A permalink structure (permastruct) is an abstract definition of a set of rewrite rules;
|
* A permalink structure (permastruct) is an abstract definition of a set of rewrite rules;
|
||||||
* it is an easy way of expressing a set of regular expressions that rewrite to a set of
|
* it is an easy way of expressing a set of regular expressions that rewrite to a set of
|
||||||
@ -1681,7 +1681,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Remove rewrite rules and then recreate rewrite rules.
|
* Removes rewrite rules and then recreate rewrite rules.
|
||||||
*
|
*
|
||||||
* Calls WP_Rewrite::wp_rewrite_rules() after removing the 'rewrite_rules' option.
|
* Calls WP_Rewrite::wp_rewrite_rules() after removing the 'rewrite_rules' option.
|
||||||
* If the function named 'save_mod_rewrite_rules' exists, it will be called.
|
* If the function named 'save_mod_rewrite_rules' exists, it will be called.
|
||||||
@ -1761,7 +1761,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set the main permalink structure for the blog.
|
* Sets the main permalink structure for the site.
|
||||||
*
|
*
|
||||||
* Will update the 'permalink_structure' option, if there is a difference
|
* Will update the 'permalink_structure' option, if there is a difference
|
||||||
* between the current permalink structure and the parameter value. Calls
|
* between the current permalink structure and the parameter value. Calls
|
||||||
@ -1794,7 +1794,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set the category base for the category permalink.
|
* Sets the category base for the category permalink.
|
||||||
*
|
*
|
||||||
* Will update the 'category_base' option, if there is a difference between
|
* Will update the 'category_base' option, if there is a difference between
|
||||||
* the current category base and the parameter value. Calls WP_Rewrite::init()
|
* the current category base and the parameter value. Calls WP_Rewrite::init()
|
||||||
@ -1813,7 +1813,7 @@ class WP_Rewrite {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set the tag base for the tag permalink.
|
* Sets the tag base for the tag permalink.
|
||||||
*
|
*
|
||||||
* Will update the 'tag_base' option, if there is a difference between the
|
* Will update the 'tag_base' option, if there is a difference between the
|
||||||
* current tag base and the parameter value. Calls WP_Rewrite::init() after
|
* current tag base and the parameter value. Calls WP_Rewrite::init() after
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
*
|
*
|
||||||
* @global string $wp_version
|
* @global string $wp_version
|
||||||
*/
|
*/
|
||||||
$wp_version = '4.4-alpha-34943';
|
$wp_version = '4.4-alpha-34944';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 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.
|
||||||
|
Loading…
Reference in New Issue
Block a user