<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[37542] trunk/src/wp-includes: Docs: Apply inline `@see` tags to hooks referenced in DocBlocks in a variety of wp-includes/* files.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta" style="font-size: 105%">
<dt style="float: left; width: 6em; font-weight: bold">Revision</dt> <dd><a style="font-weight: bold" href="https://core.trac.wordpress.org/changeset/37542">37542</a><script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","description":"Review this Commit","action":{"@type":"ViewAction","url":"https://core.trac.wordpress.org/changeset/37542","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>DrewAPicture</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2016-05-23 18:58:48 +0000 (Mon, 23 May 2016)</dd>
</dl>
<pre style='padding-left: 1em; margin: 2em 0; border-left: 2px solid #ccc; line-height: 1.25; font-size: 105%; font-family: sans-serif'>Docs: Apply inline `@see` tags to hooks referenced in DocBlocks in a variety of wp-includes/* files.
Applying these specially-crafted `@see` tags allows the Code Reference parser to recognize and link these elements as actions and filters.
See <a href="https://core.trac.wordpress.org/ticket/36921">#36921</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunksrcwpincludesadminbarphp">trunk/src/wp-includes/admin-bar.php</a></li>
<li><a href="#trunksrcwpincludesbookmarkphp">trunk/src/wp-includes/bookmark.php</a></li>
<li><a href="#trunksrcwpincludescategorytemplatephp">trunk/src/wp-includes/category-template.php</a></li>
<li><a href="#trunksrcwpincludesclasswpphp">trunk/src/wp-includes/class-wp.php</a></li>
<li><a href="#trunksrcwpincludescommenttemplatephp">trunk/src/wp-includes/comment-template.php</a></li>
<li><a href="#trunksrcwpincludescommentphp">trunk/src/wp-includes/comment.php</a></li>
<li><a href="#trunksrcwpincludescronphp">trunk/src/wp-includes/cron.php</a></li>
<li><a href="#trunksrcwpincludesdeprecatedphp">trunk/src/wp-includes/deprecated.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunksrcwpincludesadminbarphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/admin-bar.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/admin-bar.php 2016-05-23 18:56:06 UTC (rev 37541)
+++ trunk/src/wp-includes/admin-bar.php 2016-05-23 18:58:48 UTC (rev 37542)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -11,7 +11,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Instantiate the admin bar object and set it up as a global for access elsewhere.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * UNHOOKING THIS FUNCTION WILL NOT PROPERLY REMOVE THE ADMIN BAR.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * For that, use show_admin_bar(false) or the 'show_admin_bar' filter.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * For that, use show_admin_bar(false) or the {@see 'show_admin_bar'} filter.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.1.0
</span><span class="cx" style="display: block; padding: 0 10px"> * @access private
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -51,14 +51,16 @@
</span><span class="cx" style="display: block; padding: 0 10px"> }
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Render the admin bar to the page based on the $wp_admin_bar->menu member var.
- * This is called very late on the footer actions so that it will render after anything else being
- * added to the footer.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Renders the admin bar to the page based on the $wp_admin_bar->menu member var.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * It includes the action "admin_bar_menu" which should be used to hook in and
- * add new menus to the admin bar. That way you can be sure that you are adding at most optimal point,
- * right before the admin bar is rendered. This also gives you access to the $post global, among others.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * This is called very late on the footer actions so that it will render after
+ * anything else being added to the footer.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * It includes the {@see 'admin_bar_menu'} action which should be used to hook in and
+ * add new menus to the admin bar. That way you can be sure that you are adding at most
+ * optimal point, right before the admin bar is rendered. This also gives you access to
+ * the `$post` global, among others.
+ *
</ins><span class="cx" style="display: block; padding: 0 10px"> * @since 3.1.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @global WP_Admin_Bar $wp_admin_bar
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -872,9 +874,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> }
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Set the display status of the admin bar.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Sets the display status of the admin bar.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * This can be called immediately upon plugin load. It does not need to be called from a function hooked to the init action.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * This can be called immediately upon plugin load. It does not need to be called
+ * from a function hooked to the {@see 'init'} action.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.1.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span></span></pre></div>
<a id="trunksrcwpincludesbookmarkphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/bookmark.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/bookmark.php 2016-05-23 18:56:06 UTC (rev 37541)
+++ trunk/src/wp-includes/bookmark.php 2016-05-23 18:58:48 UTC (rev 37542)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -329,7 +329,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> }
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Sanitizes a bookmark field
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Sanitizes a bookmark field.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Sanitizes the bookmark fields based on what the field name is. If the field
</span><span class="cx" style="display: block; padding: 0 10px"> * has a strict value set, then it will be tested for that, else a more generic
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -337,11 +337,11 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * $context is 'raw' then the value is immediately return.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Hooks exist for the more generic cases. With the 'edit' context, the
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * 'edit_$field' filter will be called and passed the $value and $bookmark_id
- * respectively. With the 'db' context, the 'pre_$field' filter is called and
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * {@see 'edit_$field'} filter will be called and passed the `$value` and `$bookmark_id`
+ * respectively. With the 'db' context, the {@see 'pre_$field'} filter is called and
</ins><span class="cx" style="display: block; padding: 0 10px"> * passed the value. The 'display' context is the final context and has the
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * $field has the filter name and is passed the $value, $bookmark_id, and
- * $context respectively.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * `$field` has the filter name and is passed the `$value`, `$bookmark_id`, and
+ * `$context`, respectively.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 2.3.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span></span></pre></div>
<a id="trunksrcwpincludescategorytemplatephp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/category-template.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/category-template.php 2016-05-23 18:56:06 UTC (rev 37541)
+++ trunk/src/wp-includes/category-template.php 2016-05-23 18:58:48 UTC (rev 37542)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -777,7 +777,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * 'format' argument will format the tags in a UL HTML list. The array value for
</span><span class="cx" style="display: block; padding: 0 10px"> * the 'format' argument will return in PHP array type format.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * The 'tag_cloud_sort' filter allows you to override the sorting.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The {@see 'tag_cloud_sort'} filter allows you to override the sorting.
</ins><span class="cx" style="display: block; padding: 0 10px"> * Passed to the filter: $tags array and $args array, has to return the $tags array
</span><span class="cx" style="display: block; padding: 0 10px"> * after sorting it.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span></span></pre></div>
<a id="trunksrcwpincludesclasswpphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/class-wp.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp.php 2016-05-23 18:56:06 UTC (rev 37541)
+++ trunk/src/wp-includes/class-wp.php 2016-05-23 18:58:48 UTC (rev 37542)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -513,8 +513,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="cx" style="display: block; padding: 0 10px"> * Sets the query string property based off of the query variable property.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * The 'query_string' filter is deprecated, but still works. Plugins should
- * use the 'request' filter instead.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The {@see 'query_string'} filter is deprecated, but still works. Plugins should
+ * use the {@see 'request'} filter instead.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 2.0.0
</span><span class="cx" style="display: block; padding: 0 10px"> * @access public
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -711,7 +711,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="cx" style="display: block; padding: 0 10px"> * Sets up all of the variables required by the WordPress environment.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * The action 'wp' has one parameter that references the WP object. It
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The action {@see 'wp'} has one parameter that references the WP object. It
</ins><span class="cx" style="display: block; padding: 0 10px"> * allows for accessing the properties and methods to further manipulate the
</span><span class="cx" style="display: block; padding: 0 10px"> * object.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span></span></pre></div>
<a id="trunksrcwpincludescommenttemplatephp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/comment-template.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/comment-template.php 2016-05-23 18:56:06 UTC (rev 37541)
+++ trunk/src/wp-includes/comment-template.php 2016-05-23 18:58:48 UTC (rev 37542)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1239,10 +1239,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * the post does not have comments.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Uses the WordPress database object to query for the comments. The comments
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * are passed through the 'comments_array' filter hook with the list of comments
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * are passed through the {@see 'comments_array'} filter hook with the list of comments
</ins><span class="cx" style="display: block; padding: 0 10px"> * and the post ID respectively.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * The $file path is passed through a filter hook called, 'comments_template'
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The `$file` path is passed through a filter hook called {@see 'comments_template'},
</ins><span class="cx" style="display: block; padding: 0 10px"> * which includes the TEMPLATEPATH and $file combined. Tries the $filtered path
</span><span class="cx" style="display: block; padding: 0 10px"> * first and if it fails it will require the default comment template from the
</span><span class="cx" style="display: block; padding: 0 10px"> * default theme. If either does not exist, then the WordPress process will be
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2069,13 +2069,13 @@
</span><span class="cx" style="display: block; padding: 0 10px"> }
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Output a complete commenting form for use within a template.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Outputs a complete commenting form for use within a template.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Most strings and form fields may be controlled through the $args array passed
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * into the function, while you may also choose to use the comment_form_default_fields
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * into the function, while you may also choose to use the {@see 'comment_form_default_fields'}
</ins><span class="cx" style="display: block; padding: 0 10px"> * filter to modify the array of default fields if you'd just like to add a new
</span><span class="cx" style="display: block; padding: 0 10px"> * one or remove a single field. All fields are also individually passed through
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * a filter of the form comment_form_field_$name where $name is the key used
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * a filter of the {@see 'form comment_form_field_$name'} where $name is the key used
</ins><span class="cx" style="display: block; padding: 0 10px"> * in the array of fields.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.0.0
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2091,7 +2091,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Optional. Default arguments and form fields to override.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @type array $fields {
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Default comment fields, filterable by default via the 'comment_form_default_fields' hook.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Default comment fields, filterable by default via the {@see 'comment_form_default_fields'} hook.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $author Comment author field HTML.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $email Comment author email field HTML.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2208,7 +2208,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="cx" style="display: block; padding: 0 10px"> * Filters the comment form default arguments.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Use 'comment_form_default_fields' to filter the comment fields.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Use {@see 'comment_form_default_fields'} to filter the comment fields.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.0.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span></span></pre></div>
<a id="trunksrcwpincludescommentphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/comment.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/comment.php 2016-05-23 18:56:06 UTC (rev 37541)
+++ trunk/src/wp-includes/comment.php 2016-05-23 18:58:48 UTC (rev 37542)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1409,14 +1409,12 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Calls hooks for comment status transitions. If the new comment status is not the same
</span><span class="cx" style="display: block; padding: 0 10px"> * as the previous comment status, then two hooks will be ran, the first is
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * 'transition_comment_status' with new status, old status, and comment data. The
- * next action called is 'comment_OLDSTATUS_to_NEWSTATUS' the NEWSTATUS is the
- * $new_status parameter and the OLDSTATUS is $old_status parameter; it has the
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * {@see 'transition_comment_status'} with new status, old status, and comment data. The
+ * next action called is {@see comment_$old_status_to_$new_status'}. It has the
</ins><span class="cx" style="display: block; padding: 0 10px"> * comment data.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * The final action will run whether or not the comment statuses are the same. The
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * action is named 'comment_NEWSTATUS_COMMENTTYPE', NEWSTATUS is from the $new_status
- * parameter and COMMENTTYPE is comment_type comment data.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * action is named {@see 'comment_$new_status_$comment->comment_type'}.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 2.7.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1700,12 +1698,13 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Adds a new comment to the database.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Filters new comment to ensure that the fields are sanitized and valid before
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * inserting comment into database. Calls 'comment_post' action with comment ID
- * and whether comment is approved by WordPress. Also has 'preprocess_comment'
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * inserting comment into database. Calls {@see 'comment_post'} action with comment ID
+ * and whether comment is approved by WordPress. Also has {@see 'preprocess_comment'}
</ins><span class="cx" style="display: block; padding: 0 10px"> * filter for processing the comment data before the function handles it.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * We use REMOTE_ADDR here directly. If you are behind a proxy, you should ensure
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * We use `REMOTE_ADDR` here directly. If you are behind a proxy, you should ensure
</ins><span class="cx" style="display: block; padding: 0 10px"> * that it is properly set, such as in wp-config.php, for your environment.
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ *
</ins><span class="cx" style="display: block; padding: 0 10px"> * See {@link https://core.trac.wordpress.org/ticket/9235}
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 1.5.0
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1891,7 +1890,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="cx" style="display: block; padding: 0 10px"> * Sets the status of a comment.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * The 'wp_set_comment_status' action is called after the comment is handled.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The {@see 'wp_set_comment_status'} action is called after the comment is handled.
</ins><span class="cx" style="display: block; padding: 0 10px"> * If the comment status is not in the list, then false is returned.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 1.0.0
</span></span></pre></div>
<a id="trunksrcwpincludescronphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/cron.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/cron.php 2016-05-23 18:56:06 UTC (rev 37541)
+++ trunk/src/wp-includes/cron.php 2016-05-23 18:58:48 UTC (rev 37542)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -62,7 +62,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * visits your WordPress site, if the scheduled time has passed.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Valid values for the recurrence are hourly, daily and twicedaily. These can
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * be extended using the cron_schedules filter in wp_get_schedules().
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * be extended using the {@see 'cron_schedules'} filter in wp_get_schedules().
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Use wp_next_scheduled() to prevent duplicates
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -363,7 +363,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Retrieve supported and filtered Cron recurrences.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * The supported recurrences are 'hourly' and 'daily'. A plugin may add more by
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * hooking into the 'cron_schedules' filter. The filter accepts an array of
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * hooking into the {@see 'cron_schedules'} filter. The filter accepts an array of
</ins><span class="cx" style="display: block; padding: 0 10px"> * arrays. The outer array has a key that is the name of the schedule or for
</span><span class="cx" style="display: block; padding: 0 10px"> * example 'weekly'. The value is an array with two keys, one is 'interval' and
</span><span class="cx" style="display: block; padding: 0 10px"> * the other is 'display'.
</span></span></pre></div>
<a id="trunksrcwpincludesdeprecatedphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/deprecated.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/deprecated.php 2016-05-23 18:56:06 UTC (rev 37541)
+++ trunk/src/wp-includes/deprecated.php 2016-05-23 18:58:48 UTC (rev 37542)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2020,7 +2020,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $url The URL to be cleaned.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param array $protocols Optional. An array of acceptable protocols.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $context Optional. How the URL will be used. Default is 'display'.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return string The cleaned $url after the 'clean_url' filter is applied.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return string The cleaned $url after the {@see 'clean_url'} filter is applied.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function clean_url( $url, $protocols = null, $context = 'display' ) {
</span><span class="cx" style="display: block; padding: 0 10px"> if ( $context == 'db' )
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2033,7 +2033,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="cx" style="display: block; padding: 0 10px"> * Escape single quotes, specialchar double quotes, and fix line endings.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * The filter 'js_escape' is also applied by esc_js()
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The filter {@see 'js_escape'} is also applied by esc_js().
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 2.0.4
</span><span class="cx" style="display: block; padding: 0 10px"> * @deprecated 2.8.0 Use esc_js()
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2968,7 +2968,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @deprecated 3.4.0 Use add_theme_support()
</span><span class="cx" style="display: block; padding: 0 10px"> * @see add_theme_support()
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param callable $wp_head_callback Call on 'wp_head' action.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param callable $wp_head_callback Call on the {@see 'wp_head'} action.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param callable $admin_head_callback Call on custom header administration screen.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param callable $admin_preview_callback Output a custom header image div on the custom header administration screen. Optional.
</span><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3004,7 +3004,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @deprecated 3.4.0 Use add_theme_support()
</span><span class="cx" style="display: block; padding: 0 10px"> * @see add_theme_support()
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param callable $wp_head_callback Call on 'wp_head' action.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param callable $wp_head_callback Call on the {@see 'wp_head'} action.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param callable $admin_head_callback Call on custom background administration screen.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param callable $admin_preview_callback Output a custom background image div on the custom background administration screen. Optional.
</span><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3524,7 +3524,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="cx" style="display: block; padding: 0 10px"> * Formats text for the rich text editor.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * The filter 'richedit_pre' is applied here. If $text is empty the filter will
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The {@see 'richedit_pre'} filter is applied here. If $text is empty the filter will
</ins><span class="cx" style="display: block; padding: 0 10px"> * be applied to an empty string.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 2.0.0
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3567,7 +3567,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Formats text for the HTML editor.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Unless $output is empty it will pass through htmlspecialchars before the
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * 'htmledit_pre' filter is applied.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * {@see 'htmledit_pre'} filter is applied.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 2.5.0
</span><span class="cx" style="display: block; padding: 0 10px"> * @deprecated 4.3.0 Use format_for_editor()
</span></span></pre>
</div>
</div>
</body>
</html>