<!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>[46232] trunk/src: Docs: Docblock corrections and improvements, mostly related to various `pre_*` filters.</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 { white-space: pre-line; 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/46232">46232</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/46232","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>johnbillion</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2019-09-21 17:40:58 +0000 (Sat, 21 Sep 2019)</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: Docblock corrections and improvements, mostly related to various `pre_*` filters.
See <a href="https://core.trac.wordpress.org/ticket/47110">#47110</a></pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunksrcwpadminincludesfilephp">trunk/src/wp-admin/includes/file.php</a></li>
<li><a href="#trunksrcwpadminincludesthemephp">trunk/src/wp-admin/includes/theme.php</a></li>
<li><a href="#trunksrcwpincludesblocksphp">trunk/src/wp-includes/blocks.php</a></li>
<li><a href="#trunksrcwpincludesclasshttpphp">trunk/src/wp-includes/class-http.php</a></li>
<li><a href="#trunksrcwpincludesclasswphttpproxyphp">trunk/src/wp-includes/class-wp-http-proxy.php</a></li>
<li><a href="#trunksrcwpincludesclasswpxmlrpcserverphp">trunk/src/wp-includes/class-wp-xmlrpc-server.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="#trunksrcwpincludesformattingphp">trunk/src/wp-includes/formatting.php</a></li>
<li><a href="#trunksrcwpincludesl10nphp">trunk/src/wp-includes/l10n.php</a></li>
<li><a href="#trunksrcwpincludeslinktemplatephp">trunk/src/wp-includes/link-template.php</a></li>
<li><a href="#trunksrcwpincludesmsfunctionsphp">trunk/src/wp-includes/ms-functions.php</a></li>
<li><a href="#trunksrcwpincludesmsloadphp">trunk/src/wp-includes/ms-load.php</a></li>
<li><a href="#trunksrcwpincludespluggablephp">trunk/src/wp-includes/pluggable.php</a></li>
<li><a href="#trunksrcwpincludespostphp">trunk/src/wp-includes/post.php</a></li>
<li><a href="#trunksrcwpincludesshortcodesphp">trunk/src/wp-includes/shortcodes.php</a></li>
<li><a href="#trunksrcwpincludestaxonomyphp">trunk/src/wp-includes/taxonomy.php</a></li>
<li><a href="#trunksrcwpincludeswpdbphp">trunk/src/wp-includes/wp-db.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunksrcwpadminincludesfilephp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-admin/includes/file.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-admin/includes/file.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-admin/includes/file.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -852,10 +852,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.9.0
</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 string $move_new_file If null (default) move the file after the upload.
- * @param string $file An array of data for a single file.
- * @param string $new_file Filename of the newly-uploaded file.
- * @param string $type File type.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param mixed $move_new_file If null (default) move the file after the upload.
+ * @param string[] $file An array of data for a single file.
+ * @param string $new_file Filename of the newly-uploaded file.
+ * @param string $type File type.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $move_new_file = apply_filters( 'pre_move_uploaded_file', null, $file, $new_file, $type );
</span><span class="cx" style="display: block; padding: 0 10px">
</span></span></pre></div>
<a id="trunksrcwpadminincludesthemephp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-admin/includes/theme.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-admin/includes/theme.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-admin/includes/theme.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -686,7 +686,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.8.0
</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 array $prepared_themes Array of themes.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array $prepared_themes Array of theme data.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $prepared_themes = apply_filters( 'wp_prepare_themes_for_js', $prepared_themes );
</span><span class="cx" style="display: block; padding: 0 10px"> $prepared_themes = array_values( $prepared_themes );
</span></span></pre></div>
<a id="trunksrcwpincludesblocksphp"></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/blocks.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/blocks.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/blocks.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -225,8 +225,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.1.0
</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 string $pre_render The pre-rendered content. Default null.
- * @param array $block The block being rendered.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|null $pre_render The pre-rendered content. Default null.
+ * @param array $block The block being rendered.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $pre_render = apply_filters( 'pre_render_block', null, $block );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( ! is_null( $pre_render ) ) {
</span></span></pre></div>
<a id="trunksrcwpincludesclasshttpphp"></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-http.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-http.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/class-http.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -251,8 +251,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 2.9.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param false|array|WP_Error $preempt Whether to preempt an HTTP request's return value. Default false.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param array $parsed_args HTTP request arguments.
- * @param string $url The request URL.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array $parsed_args HTTP request arguments.
+ * @param string $url The request URL.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $pre = apply_filters( 'pre_http_request', false, $parsed_args, $url );
</span><span class="cx" style="display: block; padding: 0 10px">
</span></span></pre></div>
<a id="trunksrcwpincludesclasswphttpproxyphp"></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-http-proxy.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-http-proxy.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/class-wp-http-proxy.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -152,9 +152,9 @@
</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">- * Whether URL should be sent through the proxy server.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Determines whether the request should be sent through a proxy.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * We want to keep localhost and the site URL from being sent through the proxy server, because
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * We want to keep localhost and the site URL from being sent through the proxy, because
</ins><span class="cx" style="display: block; padding: 0 10px"> * some proxies can not handle this. We also have the constant available for defining other
</span><span class="cx" style="display: block; padding: 0 10px"> * hosts that won't be sent through the proxy.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -181,7 +181,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> $home = parse_url( get_option( 'siteurl' ) );
</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">- * Filters whether to preempt sending the request through the proxy server.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Filters whether to preempt sending the request through the proxy.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * Returning false will bypass the proxy; returning true will send
</span><span class="cx" style="display: block; padding: 0 10px"> * the request through the proxy. Returning null bypasses the filter.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -188,10 +188,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.5.0
</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 null $override Whether to override the request result. Default null.
- * @param string $uri URL to check.
- * @param array $check Associative array result of parsing the URI.
- * @param array $home Associative array result of parsing the site URL.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param bool|null $override Whether to override the request result. Default null.
+ * @param string $uri URL to check.
+ * @param array $check Associative array result of parsing the request URI.
+ * @param array $home Associative array result of parsing the site URL.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $result = apply_filters( 'pre_http_send_through_proxy', null, $uri, $check, $home );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( ! is_null( $result ) ) {
</span></span></pre></div>
<a id="trunksrcwpincludesclasswpxmlrpcserverphp"></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-xmlrpc-server.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-xmlrpc-server.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/class-wp-xmlrpc-server.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -286,8 +286,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.5.0
</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 string $error The XML-RPC error message.
- * @param WP_User $user WP_User object.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $error The XML-RPC error message.
+ * @param WP_Error $user WP_Error object.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $this->error = apply_filters( 'xmlrpc_login_error', $this->error, $user );
</span><span class="cx" style="display: block; padding: 0 10px"> return false;
</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 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/comment.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -820,8 +820,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.9.0 Returning a WP_Error value from the filter will shortcircuit comment insertion and
</span><span class="cx" style="display: block; padding: 0 10px"> * allow skipping further processing.
</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 bool|string|WP_Error $approved The approval status. Accepts 1, 0, 'spam' or WP_Error.
- * @param array $commentdata Comment data.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param int|string|WP_Error $approved The approval status. Accepts 1, 0, 'spam' or WP_Error.
+ * @param array $commentdata Comment data.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $approved = apply_filters( 'pre_comment_approved', $approved, $commentdata );
</span><span class="cx" style="display: block; padding: 0 10px"> return $approved;
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2488,7 +2488,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @global wpdb $wpdb WordPress database abstraction object.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param int $post_id Post ID
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return bool True on success, false on '0' $post_id or if post with ID does not exist.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return bool True on success, false if the post does not exist.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function wp_update_comment_count_now( $post_id ) {
</span><span class="cx" style="display: block; padding: 0 10px"> global $wpdb;
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2512,9 +2512,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.5.0
</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 int $new The new comment count. Default null.
- * @param int $old The old comment count.
- * @param int $post_id Post ID.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param int|null $new The new comment count. Default null.
+ * @param int $old The old comment count.
+ * @param int $post_id Post ID.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $new = apply_filters( 'pre_wp_update_comment_count_now', null, $old, $post_id );
</span><span class="cx" style="display: block; padding: 0 10px">
</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 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/cron.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -392,10 +392,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * {@see 'pre_clear_scheduled_hook'} filter added to short-circuit the function.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $hook Action hook, the execution of which will be unscheduled.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param array $args Optional. Arguments that were to be passed to the hook's callback function.
- * @return bool|int On success an integer indicating number of events unscheduled (0 indicates no
- * events were registered with the hook and arguments combination), false if
- * unscheduling one or more events fail.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array $args Optional. Arguments that were to be passed to the hook's callback function.
+ * @return false|int On success an integer indicating number of events unscheduled (0 indicates no
+ * events were registered with the hook and arguments combination), false if
+ * unscheduling one or more events fail.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function wp_clear_scheduled_hook( $hook, $args = array() ) {
</span><span class="cx" style="display: block; padding: 0 10px"> // Backward compatibility
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -417,9 +417,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.1.0
</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 null|array $pre Value to return instead. Default null to continue unscheduling the event.
- * @param string $hook Action hook, the execution of which will be unscheduled.
- * @param array $args Arguments to pass to the hook's callback function.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param null|int|false $pre Value to return instead. Default null to continue unscheduling the event.
+ * @param string $hook Action hook, the execution of which will be unscheduled.
+ * @param array $args Arguments to pass to the hook's callback function.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $pre = apply_filters( 'pre_clear_scheduled_hook', null, $hook, $args );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $pre ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -461,8 +461,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.1.0 Return value added to indicate success or failure.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $hook Action hook, the execution of which will be unscheduled.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return bool|int On success an integer indicating number of events unscheduled (0 indicates no
- * events were registered on the hook), false if unscheduling fails.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return false|int On success an integer indicating number of events unscheduled (0 indicates no
+ * events were registered on the hook), false if unscheduling fails.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function wp_unschedule_hook( $hook ) {
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -477,8 +477,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.1.0
</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 null|array $pre Value to return instead. Default null to continue unscheduling the hook.
- * @param string $hook Action hook, the execution of which will be unscheduled.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param null|int|false $pre Value to return instead. Default null to continue unscheduling the hook.
+ * @param string $hook Action hook, the execution of which will be unscheduled.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $pre = apply_filters( 'pre_unschedule_hook', null, $hook );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $pre ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -528,7 +528,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Although not passed to a callback, these arguments are used to uniquely identify the
</span><span class="cx" style="display: block; padding: 0 10px"> * event, so they should be the same as those used when originally scheduling the event.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param int|null $timestamp Optional. Unix timestamp (UTC) of the event. If not specified, the next scheduled event is returned.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return bool|object The event object. False if the event does not exist.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return false|object The event object. False if the event does not exist.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function wp_get_scheduled_event( $hook, $args = array(), $timestamp = null ) {
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -542,11 +542,11 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.1.0
</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 null|bool $pre Value to return instead. Default null to continue retrieving the event.
- * @param string $hook Action hook of the event.
- * @param array $args Array containing each separate argument to pass to the hook's callback function.
- * Although not passed to a callback, these arguments are used to uniquely identify the
- * event.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param null|false|object $pre Value to return instead. Default null to continue retrieving the event.
+ * @param string $hook Action hook of the event.
+ * @param array $args Array containing each separate argument to pass to the hook's callback function.
+ * Although not passed to a callback, these arguments are used to uniquely identify
+ * the event.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param int|null $timestamp Unix timestamp (UTC) of the event. Null to retrieve next scheduled event.
</span><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $pre = apply_filters( 'pre_get_scheduled_event', null, $hook, $args, $timestamp );
</span></span></pre></div>
<a id="trunksrcwpincludesformattingphp"></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/formatting.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/formatting.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/formatting.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3836,8 +3836,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.3.0
</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 null $converted_text The text to be converted. Default null.
- * @param string $text The text prior to entity conversion.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|null $converted_text The text to be converted. Default null.
+ * @param string $text The text prior to entity conversion.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $filtered = apply_filters( 'pre_ent2ncr', null, $text );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $filtered ) {
</span></span></pre></div>
<a id="trunksrcwpincludesl10nphp"></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/l10n.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/l10n.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/l10n.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1053,10 +1053,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.0.2
</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 string|false $translations JSON-encoded translation data. Default null.
- * @param string|false $file Path to the translation file to load. False if there isn't one.
- * @param string $handle Name of the script to register a translation domain to.
- * @param string $domain The text domain.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|false|null $translations JSON-encoded translation data. Default null.
+ * @param string|false $file Path to the translation file to load. False if there isn't one.
+ * @param string $handle Name of the script to register a translation domain to.
+ * @param string $domain The text domain.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $translations = apply_filters( 'pre_load_script_translations', null, $file, $handle, $domain );
</span><span class="cx" style="display: block; padding: 0 10px">
</span></span></pre></div>
<a id="trunksrcwpincludeslinktemplatephp"></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/link-template.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/link-template.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/link-template.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3997,8 +3997,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.2.0
</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 mixed $id_or_email The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash,
- * user email, WP_User object, WP_Post object, or WP_Comment object.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+ * user email, WP_User object, WP_Post object, or WP_Comment object.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param array $args {
</span><span class="cx" style="display: block; padding: 0 10px"> * Optional. Arguments to return instead of the default arguments.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4020,7 +4020,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * plus a "found_avatar" guess. Pass as a reference. Default null.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $extra_attr HTML attributes to insert in the IMG element. Is not sanitized. Default empty.
</span><span class="cx" style="display: block; padding: 0 10px"> * }
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array $processed_args {
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return array {
</ins><span class="cx" style="display: block; padding: 0 10px"> * Along with the arguments passed in `$args`, this will contain a couple of extra arguments.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @type bool $found_avatar True if we were able to find an avatar for this user,
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4101,9 +4101,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.2.0
</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 array $args Arguments passed to get_avatar_data(), after processing.
- * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash,
- * user email, WP_User object, WP_Post object, or WP_Comment object.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array $args Arguments passed to get_avatar_data(), after processing.
+ * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+ * user email, WP_User object, WP_Post object, or WP_Comment object.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $args = apply_filters( 'pre_get_avatar_data', $args, $id_or_email );
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4193,7 +4193,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.2.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $url The URL of the avatar.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash,
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
</ins><span class="cx" style="display: block; padding: 0 10px"> * user email, WP_User object, WP_Post object, or WP_Comment object.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param array $args Arguments passed to get_avatar_data(), after processing.
</span><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4204,9 +4204,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.2.0
</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 array $args Arguments passed to get_avatar_data(), after processing.
- * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash,
- * user email, WP_User object, WP_Post object, or WP_Comment object.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array $args Arguments passed to get_avatar_data(), after processing.
+ * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user ID, Gravatar MD5 hash,
+ * user email, WP_User object, WP_Post object, or WP_Comment object.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> return apply_filters( 'get_avatar_data', $args, $id_or_email );
</span><span class="cx" style="display: block; padding: 0 10px"> }
</span></span></pre></div>
<a id="trunksrcwpincludesmsfunctionsphp"></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/ms-functions.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/ms-functions.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/ms-functions.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2426,19 +2426,19 @@
</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">- * Returns the space used by the current blog.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Returns the space used by the current site.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.5.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return int Used space in megabytes
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return int Used space in megabytes.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function get_space_used() {
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Filters the amount of storage space used by the current site.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Filters the amount of storage space used by the current site, in megabytes.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.5.0
</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 int|bool $space_used The amount of used space, in megabytes. Default false.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param int|false $space_used The amount of used space, in megabytes. Default false.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $space_used = apply_filters( 'pre_get_space_used', false );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( false === $space_used ) {
</span></span></pre></div>
<a id="trunksrcwpincludesmsloadphp"></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/ms-load.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/ms-load.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/ms-load.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -203,12 +203,12 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.9.0
</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 null|bool|WP_Site $site Site value to return by path.
- * @param string $domain The requested domain.
- * @param string $path The requested path, in full.
- * @param int|null $segments The suggested number of paths to consult.
- * Default null, meaning the entire path was to be consulted.
- * @param array $paths The paths to search for, based on $path and $segments.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param null|false|WP_Site $site Site value to return by path.
+ * @param string $domain The requested domain.
+ * @param string $path The requested path, in full.
+ * @param int|null $segments The suggested number of paths to consult.
+ * Default null, meaning the entire path was to be consulted.
+ * @param array $paths The paths to search for, based on $path and $segments.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $pre = apply_filters( 'pre_get_site_by_path', null, $domain, $path, $segments, $paths );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $pre ) {
</span></span></pre></div>
<a id="trunksrcwpincludespluggablephp"></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/pluggable.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/pluggable.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/pluggable.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2608,10 +2608,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.2.0
</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 string $avatar HTML for the user's avatar. Default null.
- * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash,
- * user email, WP_User object, WP_Post object, or WP_Comment object.
- * @param array $args Arguments passed to get_avatar_url(), after processing.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|null $avatar HTML for the user's avatar. Default null.
+ * @param mixed $id_or_email The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash,
+ * user email, WP_User object, WP_Post object, or WP_Comment object.
+ * @param array $args Arguments passed to get_avatar_url(), after processing.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $avatar = apply_filters( 'pre_get_avatar', null, $id_or_email, $args );
</span><span class="cx" style="display: block; padding: 0 10px">
</span></span></pre></div>
<a id="trunksrcwpincludespostphp"></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/post.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/post.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/post.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2935,9 +2935,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.4.0
</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 bool $delete Whether to go forward with deletion.
- * @param WP_Post $post Post object.
- * @param bool $force_delete Whether to bypass the trash.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param bool|null $delete Whether to go forward with deletion.
+ * @param WP_Post $post Post object.
+ * @param bool $force_delete Whether to bypass the trash.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $check = apply_filters( 'pre_delete_post', null, $post, $force_delete );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $check ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3104,8 +3104,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.9.0
</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 bool $trash Whether to go forward with trashing.
- * @param WP_Post $post Post object.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param bool|null $trash Whether to go forward with trashing.
+ * @param WP_Post $post Post object.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $check = apply_filters( 'pre_trash_post', null, $post );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $check ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3173,8 +3173,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.9.0
</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 bool $untrash Whether to go forward with untrashing.
- * @param WP_Post $post Post object.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param bool|null $untrash Whether to go forward with untrashing.
+ * @param WP_Post $post Post object.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $check = apply_filters( 'pre_untrash_post', null, $post );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $check ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4284,12 +4284,12 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.1.0
</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 string $override_slug Short-circuit return value.
- * @param string $slug The desired slug (post_name).
- * @param int $post_ID Post ID.
- * @param string $post_status The post status.
- * @param string $post_type Post type.
- * @param int $post_parent Post parent ID.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|null $override_slug Short-circuit return value.
+ * @param string $slug The desired slug (post_name).
+ * @param int $post_ID Post ID.
+ * @param string $post_status The post status.
+ * @param string $post_type Post type.
+ * @param int $post_parent Post parent ID.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $override_slug = apply_filters( 'pre_wp_unique_post_slug', null, $slug, $post_ID, $post_status, $post_type, $post_parent );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $override_slug ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6351,7 +6351,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">- * Retrieve the date that the last post was published.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Retrieves the most recent time that a post on the site was published.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * The server timezone is the default and is the difference between GMT and
</span><span class="cx" style="display: block; padding: 0 10px"> * server time. The 'blog' value is the date when the last post was posted. The
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6362,8 +6362,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $timezone Optional. The timezone for the timestamp. Accepts 'server', 'blog', or 'gmt'.
</span><span class="cx" style="display: block; padding: 0 10px"> * 'server' uses the server's internal timezone.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * 'blog' uses the `post_modified` field, which proxies to the timezone set for the site.
- * 'gmt' uses the `post_modified_gmt` field.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * 'blog' uses the `post_date` field, which proxies to the timezone set for the site.
+ * 'gmt' uses the `post_date_gmt` field.
</ins><span class="cx" style="display: block; padding: 0 10px"> * Default 'server'.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $post_type Optional. The post type to check. Default 'any'.
</span><span class="cx" style="display: block; padding: 0 10px"> * @return string The date of the last post.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6370,7 +6370,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function get_lastpostdate( $timezone = 'server', $post_type = 'any' ) {
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Filters the date the last post was published.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Filters the most recent time that a post on the site was published.
</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 class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6382,7 +6382,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">- * Get the timestamp of the last time any post was modified.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Get the most recent time that a post on the site was modified.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * The server timezone is the default and is the difference between GMT and
</span><span class="cx" style="display: block; padding: 0 10px"> * server time. The 'blog' value is just when the last post was modified. The
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6395,7 +6395,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * for information on accepted values.
</span><span class="cx" style="display: block; padding: 0 10px"> * Default 'server'.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $post_type Optional. The post type to check. Default 'any'.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return string The timestamp.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return string The timestamp in 'Y-m-d H:i:s' format.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function get_lastpostmodified( $timezone = 'server', $post_type = 'any' ) {
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6403,11 +6403,11 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.4.0
</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 string $lastpostmodified Date the last post was modified.
- * Returning anything other than false will short-circuit the function.
- * @param string $timezone Location to use for getting the post modified date.
- * See get_lastpostdate() for accepted `$timezone` values.
- * @param string $post_type The post type to check.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|false $lastpostmodified The most recent time that a post was modified, in 'Y-m-d H:i:s' format, or
+ * false. Returning anything other than false will short-circuit the function.
+ * @param string $timezone Location to use for getting the post modified date.
+ * See get_lastpostdate() for accepted `$timezone` values.
+ * @param string $post_type The post type to check.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $lastpostmodified = apply_filters( 'pre_get_lastpostmodified', false, $timezone, $post_type );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( false !== $lastpostmodified ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6422,11 +6422,11 @@
</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">- * Filters the date the last post was modified.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Filters the most recent time that a post was modified.
</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><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param string $lastpostmodified Date the last post was modified.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $lastpostmodified The most recent time that a post was modified, in 'Y-m-d H:i:s' format.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param string $timezone Location to use for getting the post modified date.
</span><span class="cx" style="display: block; padding: 0 10px"> * See get_lastpostdate() for accepted `$timezone` values.
</span><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6434,7 +6434,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">- * Get the timestamp of the last time any post was modified or published.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Gets the timestamp of the last time any post was modified or published.
</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"> * @since 4.4.0 The `$post_type` argument was added.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -6446,7 +6446,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * for information on accepted values.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $field Post field to check. Accepts 'date' or 'modified'.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $post_type Optional. The post type to check. Default 'any'.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return string|false The timestamp.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return string|false The timestamp in 'Y-m-d H:i:s' format, or false on error.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function _get_last_post_time( $timezone, $field, $post_type = 'any' ) {
</span><span class="cx" style="display: block; padding: 0 10px"> global $wpdb;
</span></span></pre></div>
<a id="trunksrcwpincludesshortcodesphp"></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/shortcodes.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/shortcodes.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/shortcodes.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -305,12 +305,12 @@
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="cx" style="display: block; padding: 0 10px"> * Filters whether to call a shortcode callback.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Passing a truthy value to the filter will effectively short-circuit the
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Returning a non-false value from filter will short-circuit the
</ins><span class="cx" style="display: block; padding: 0 10px"> * shortcode generation process, returning that value instead.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.7.0
</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 bool|string $return Short-circuit return value. Either false or the value to replace the shortcode with.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param false|string $return Short-circuit return value. Either false or the value to replace the shortcode with.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param string $tag Shortcode name.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param array|string $attr Shortcode attributes array or empty string.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param array $m Regular expression match array.
</span></span></pre></div>
<a id="trunksrcwpincludestaxonomyphp"></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/taxonomy.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/taxonomy.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/taxonomy.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1358,7 +1358,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @global wpdb $wpdb WordPress database abstraction object.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param int|string $term The term to check. Accepts term ID, slug, or name.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param string $taxonomy The taxonomy name to use
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $taxonomy Optional. The taxonomy name to use.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param int $parent Optional. ID of parent term under which to confine the exists search.
</span><span class="cx" style="display: block; padding: 0 10px"> * @return mixed Returns null if the term does not exist. Returns the term ID
</span><span class="cx" style="display: block; padding: 0 10px"> * if no taxonomy is specified and the term ID exists. Returns
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2097,7 +2097,7 @@
</span><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><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param string $term The term to add or update.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $term The term name to add or update.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param string $taxonomy The taxonomy to which to add the term.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param array|string $args {
</span><span class="cx" style="display: block; padding: 0 10px"> * Optional. Array or string of arguments for inserting a term.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2117,13 +2117,14 @@
</span><span class="cx" style="display: block; padding: 0 10px"> if ( ! taxonomy_exists( $taxonomy ) ) {
</span><span class="cx" style="display: block; padding: 0 10px"> return new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) );
</span><span class="cx" style="display: block; padding: 0 10px"> }
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+
</ins><span class="cx" style="display: block; padding: 0 10px"> /**
</span><span class="cx" style="display: block; padding: 0 10px"> * Filters a term before it is sanitized and inserted into the database.
</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="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param string $term The term to add or update.
- * @param string $taxonomy Taxonomy slug.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|WP_Error $term The term name to add or update, or a WP_Error object if there's an error.
+ * @param string $taxonomy Taxonomy slug.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $term = apply_filters( 'pre_insert_term', $term, $taxonomy );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( is_wp_error( $term ) ) {
</span></span></pre></div>
<a id="trunksrcwpincludeswpdbphp"></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/wp-db.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/wp-db.php 2019-09-21 16:05:13 UTC (rev 46231)
+++ trunk/src/wp-includes/wp-db.php 2019-09-21 17:40:58 UTC (rev 46232)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2703,8 +2703,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.2.0
</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 string $charset The character set to use. Default null.
- * @param string $table The name of the table being checked.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|null $charset The character set to use. Default null.
+ * @param string $table The name of the table being checked.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $charset = apply_filters( 'pre_get_table_charset', null, $table );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $charset ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2807,9 +2807,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.2.0
</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 string $charset The character set to use. Default null.
- * @param string $table The name of the table being checked.
- * @param string $column The name of the column being checked.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string|null $charset The character set to use. Default null.
+ * @param string $table The name of the table being checked.
+ * @param string $column The name of the column being checked.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $charset = apply_filters( 'pre_get_col_charset', null, $table, $column );
</span><span class="cx" style="display: block; padding: 0 10px"> if ( null !== $charset ) {
</span></span></pre>
</div>
</div>
</body>
</html>