<!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>[55694] trunk/src: Docs: All sorts of improvements and corrections to function and hook docs.</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/55694">55694</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/55694","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>2023-04-27 23:13:36 +0000 (Thu, 27 Apr 2023)</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: All sorts of improvements and corrections to function and hook docs.

See <a href="https://core.trac.wordpress.org/ticket/57840">#57840</a></pre>

<h3>Modified Paths</h3>

<ul>

<li><a href="#trunksrcwpadminincludesmsphp">trunk/src/wp-admin/includes/ms.php</a></li>

<li><a href="#trunksrcwpadminincludesuserphp">trunk/src/wp-admin/includes/user.php</a></li>

<li><a href="#trunksrcwpincludesblocktemplateutilsphp">trunk/src/wp-includes/block-template-utils.php</a></li>

<li><a href="#trunksrcwpincludesclasswpposttypephp">trunk/src/wp-includes/class-wp-post-type.php</a></li>

<li><a href="#trunksrcwpincludesclasswptaxonomyphp">trunk/src/wp-includes/class-wp-taxonomy.php</a></li>

<li><a href="#trunksrcwpincludesclasswpthemejsonresolverphp">trunk/src/wp-includes/class-wp-theme-json-resolver.php</a></li>

<li><a href="#trunksrcwpincludesclasswpdbphp">trunk/src/wp-includes/class-wpdb.php</a></li>

<li><a href="#trunksrcwpincludeshttpphp">trunk/src/wp-includes/http.php</a></li>

<li><a href="#trunksrcwpincludespluginphp">trunk/src/wp-includes/plugin.php</a></li>

<li><a href="#trunksrcwpincludesposttemplatephp">trunk/src/wp-includes/post-template.php</a></li>

<li><a href="#trunksrcwpincludespostphp">trunk/src/wp-includes/post.php</a></li>

<li><a href="#trunksrcwpincludesthemephp">trunk/src/wp-includes/theme.php</a></li>

</ul>

</div>

<div id="patch">

<h3>Diff</h3>

<a id="trunksrcwpadminincludesmsphp"></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/ms.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-admin/includes/ms.php        2023-04-27 22:27:51 UTC (rev 55693)

+++ trunk/src/wp-admin/includes/ms.php  2023-04-27 23:13:36 UTC (rev 55694)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -130,12 +130,17 @@

</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"> /**

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Deletes a user from the network and remove from all sites.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Deletes a user and all of their posts from the network.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * This function:

+ *

+ * - Deletes all posts (of all post types) authored by the user on all sites on the network

+ * - Deletes all links owned by the user on all sites on the network

+ * - Removes the user from all sites on the network

+ * - Deletes the user from the database

+ *

</ins><span class="cx" style="display: block; padding: 0 10px">  * @since 3.0.0

</span><span class="cx" style="display: block; padding: 0 10px">  *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @todo Merge with wp_delete_user()?

- *

</del><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 class="cx" style="display: block; padding: 0 10px">  * @param int $id The user ID.

</span></span></pre></div>

<a id="trunksrcwpadminincludesuserphp"></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/user.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-admin/includes/user.php      2023-04-27 22:27:51 UTC (rev 55693)

+++ trunk/src/wp-admin/includes/user.php        2023-04-27 23:13:36 UTC (rev 55694)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -324,18 +324,21 @@

</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"> /**

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Remove user and optionally reassign posts and links to another user.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Delete user and optionally reassign posts and links to another user.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * If the $reassign parameter is not assigned to a User ID, then all posts will

- * be deleted of that user. The action {@see 'delete_user'} that is passed the User ID

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Note that on a Multisite installation the user only gets removed from the site

+ * and does not get deleted from the database.

+ *

+ * If the `$reassign` parameter is not assigned to a user ID, then all posts will

+ * be deleted of that user. The action {@see 'delete_user'} that is passed the user ID

</ins><span class="cx" style="display: block; padding: 0 10px">  * being deleted will be run after the posts are either reassigned or deleted.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * The user meta will also be deleted that are for that User ID.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The user meta will also be deleted that are for that user ID.

</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">  *

<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">  *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param int $id User ID.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param int $id       User ID.

</ins><span class="cx" style="display: block; padding: 0 10px">  * @param int $reassign Optional. Reassign posts and links to new User ID.

<span class="cx" style="display: block; padding: 0 10px">  * @return bool True when finished.

</span><span class="cx" style="display: block; padding: 0 10px">  */

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -361,8 +364,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">        /**

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * Fires immediately before a user is deleted from the database.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * Fires immediately before a user is deleted from the site.

</ins><span class="cx" style="display: block; padding: 0 10px">          *

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * Note that on a Multisite installation the user only gets removed from the site

+        * and does not get deleted from the database.

+        *

</ins><span class="cx" style="display: block; padding: 0 10px">          * @since 2.0.0

<span class="cx" style="display: block; padding: 0 10px">         * @since 5.5.0 Added the `$user` parameter.

</span><span class="cx" style="display: block; padding: 0 10px">         *

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -440,8 +446,12 @@

</span><span class="cx" style="display: block; padding: 0 10px">        clean_user_cache( $user );

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">        /**

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * Fires immediately after a user is deleted from the database.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * Fires immediately after a user is deleted from the site.

</ins><span class="cx" style="display: block; padding: 0 10px">          *

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * Note that on a Multisite installation the user may not have been deleted from

+        * the database depending on whether `wp_delete_user()` or `wpmu_delete_user()`

+        * was called.

+        *

</ins><span class="cx" style="display: block; padding: 0 10px">          * @since 2.9.0

<span class="cx" style="display: block; padding: 0 10px">         * @since 5.5.0 Added the `$user` parameter.

</span><span class="cx" style="display: block; padding: 0 10px">         *

</span></span></pre></div>

<a id="trunksrcwpincludesblocktemplateutilsphp"></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/block-template-utils.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/block-template-utils.php    2023-04-27 22:27:51 UTC (rev 55693)

+++ trunk/src/wp-includes/block-template-utils.php      2023-04-27 23:13:36 UTC (rev 55694)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -299,7 +299,7 @@

</span><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  *     @type array  $slug__in     List of slugs to include.

<span class="cx" style="display: block; padding: 0 10px">  *     @type array  $slug__not_in List of slugs to skip.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- *     @type string $area         A 'wp_template_part_area' taxonomy value to filter by (for wp_template_part template type only).

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ *     @type string $area         A 'wp_template_part_area' taxonomy value to filter by (for 'wp_template_part' template type only).

</ins><span class="cx" style="display: block; padding: 0 10px">  *     @type string $post_type    Post type to get the templates for.

</span><span class="cx" style="display: block; padding: 0 10px">  * }

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -755,7 +755,7 @@

</span><span class="cx" style="display: block; padding: 0 10px">  * @access private

</span><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  * @param WP_Post $post Template post.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return WP_Block_Template|WP_Error Template.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return WP_Block_Template|WP_Error Template or error object.

</ins><span class="cx" style="display: block; padding: 0 10px">  */

</span><span class="cx" style="display: block; padding: 0 10px"> function _build_block_template_result_from_post( $post ) {

</span><span class="cx" style="display: block; padding: 0 10px">        $default_template_types = get_default_block_template_types();

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1055,9 +1055,9 @@

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @since 5.8.0

</span><span class="cx" style="display: block; padding: 0 10px">  *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param string $id            Template unique identifier (example: theme_slug//template_slug).

- * @param string $template_type Optional. Template type: `'wp_template'` or '`wp_template_part'`.

- *                              Default `'wp_template'`.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $id            Template unique identifier (example: 'theme_slug//template_slug').

+ * @param string $template_type Optional. Template type: 'wp_template' or 'wp_template_part'.

+ *                              Default 'wp_template'.

</ins><span class="cx" style="display: block; padding: 0 10px">  * @return WP_Block_Template|null Template.

</span><span class="cx" style="display: block; padding: 0 10px">  */

</span><span class="cx" style="display: block; padding: 0 10px"> function get_block_template( $id, $template_type = 'wp_template' ) {

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1070,8 +1070,8 @@

</span><span class="cx" style="display: block; padding: 0 10px">         *

</span><span class="cx" style="display: block; padding: 0 10px">         * @param WP_Block_Template|null $block_template Return block template object to short-circuit the default query,

<span class="cx" style="display: block; padding: 0 10px">         *                                               or null to allow WP to run its normal queries.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @param string                 $id             Template unique identifier (example: theme_slug//template_slug).

-        * @param string                 $template_type  Template type: `'wp_template'` or '`wp_template_part'`.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @param string                 $id             Template unique identifier (example: 'theme_slug//template_slug').

+        * @param string                 $template_type  Template type: 'wp_template' or 'wp_template_part'.

</ins><span class="cx" style="display: block; padding: 0 10px">          */

</span><span class="cx" style="display: block; padding: 0 10px">        $block_template = apply_filters( 'pre_get_block_template', null, $id, $template_type );

</span><span class="cx" style="display: block; padding: 0 10px">        if ( ! is_null( $block_template ) ) {

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1116,8 +1116,8 @@

</span><span class="cx" style="display: block; padding: 0 10px">         * @since 5.9.0

</span><span class="cx" style="display: block; padding: 0 10px">         *

<span class="cx" style="display: block; padding: 0 10px">         * @param WP_Block_Template|null $block_template The found block template, or null if there isn't one.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @param string                 $id             Template unique identifier (example: theme_slug//template_slug).

-        * @param array                  $template_type  Template type: `'wp_template'` or '`wp_template_part'`.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @param string                 $id             Template unique identifier (example: 'theme_slug//template_slug').

+        * @param array                  $template_type  Template type: 'wp_template' or 'wp_template_part'.

</ins><span class="cx" style="display: block; padding: 0 10px">          */

</span><span class="cx" style="display: block; padding: 0 10px">        return apply_filters( 'get_block_template', $block_template, $id, $template_type );

</span><span class="cx" style="display: block; padding: 0 10px"> }

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1129,9 +1129,9 @@

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @since 5.9.0

</span><span class="cx" style="display: block; padding: 0 10px">  *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param string $id            Template unique identifier (example: theme_slug//template_slug).

- * @param string $template_type Optional. Template type: `'wp_template'` or '`wp_template_part'`.

- *                              Default `'wp_template'`.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $id            Template unique identifier (example: 'theme_slug//template_slug').

+ * @param string $template_type Optional. Template type: 'wp_template' or 'wp_template_part'.

+ *                              Default 'wp_template'.

</ins><span class="cx" style="display: block; padding: 0 10px">  * @return WP_Block_Template|null The found block template, or null if there isn't one.

</span><span class="cx" style="display: block; padding: 0 10px">  */

</span><span class="cx" style="display: block; padding: 0 10px"> function get_block_file_template( $id, $template_type = 'wp_template' ) {

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1144,8 +1144,8 @@

</span><span class="cx" style="display: block; padding: 0 10px">         *

</span><span class="cx" style="display: block; padding: 0 10px">         * @param WP_Block_Template|null $block_template Return block template object to short-circuit the default query,

<span class="cx" style="display: block; padding: 0 10px">         *                                               or null to allow WP to run its normal queries.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @param string                 $id             Template unique identifier (example: theme_slug//template_slug).

-        * @param string                 $template_type  Template type: `'wp_template'` or '`wp_template_part'`.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @param string                 $id             Template unique identifier (example: 'theme_slug//template_slug').

+        * @param string                 $template_type  Template type: 'wp_template' or 'wp_template_part'.

</ins><span class="cx" style="display: block; padding: 0 10px">          */

</span><span class="cx" style="display: block; padding: 0 10px">        $block_template = apply_filters( 'pre_get_block_file_template', null, $id, $template_type );

</span><span class="cx" style="display: block; padding: 0 10px">        if ( ! is_null( $block_template ) ) {

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1178,8 +1178,8 @@

</span><span class="cx" style="display: block; padding: 0 10px">         * @since 5.9.0

</span><span class="cx" style="display: block; padding: 0 10px">         *

<span class="cx" style="display: block; padding: 0 10px">         * @param WP_Block_Template|null $block_template The found block template, or null if there is none.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @param string                 $id             Template unique identifier (example: theme_slug//template_slug).

-        * @param string                 $template_type  Template type: `'wp_template'` or '`wp_template_part'`.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @param string                 $id             Template unique identifier (example: 'theme_slug//template_slug').

+        * @param string                 $template_type  Template type: 'wp_template' or 'wp_template_part'.

</ins><span class="cx" style="display: block; padding: 0 10px">          */

</span><span class="cx" style="display: block; padding: 0 10px">        return apply_filters( 'get_block_file_template', $block_template, $id, $template_type );

</span><span class="cx" style="display: block; padding: 0 10px"> }

</span></span></pre></div>

<a id="trunksrcwpincludesclasswpposttypephp"></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-post-type.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-post-type.php      2023-04-27 22:27:51 UTC (rev 55693)

+++ trunk/src/wp-includes/class-wp-post-type.php        2023-04-27 23:13:36 UTC (rev 55694)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -410,6 +410,7 @@

</span><span class="cx" style="display: block; padding: 0 10px">         *

<span class="cx" style="display: block; padding: 0 10px">         * @param string       $post_type Post type key.

<span class="cx" style="display: block; padding: 0 10px">         * @param array|string $args      Optional. Array or string of arguments for registering a post type.

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         *                                See register_post_type() for information on accepted arguments.

</ins><span class="cx" style="display: block; padding: 0 10px">          *                                Default empty array.

</span><span class="cx" style="display: block; padding: 0 10px">         */

</span><span class="cx" style="display: block; padding: 0 10px">        public function __construct( $post_type, $args = array() ) {

</span></span></pre></div>

<a id="trunksrcwpincludesclasswptaxonomyphp"></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-taxonomy.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-taxonomy.php       2023-04-27 22:27:51 UTC (rev 55693)

+++ trunk/src/wp-includes/class-wp-taxonomy.php 2023-04-27 23:13:36 UTC (rev 55694)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -281,6 +281,7 @@

<span class="cx" style="display: block; padding: 0 10px">         * @param string       $taxonomy    Taxonomy key, must not exceed 32 characters.

<span class="cx" style="display: block; padding: 0 10px">         * @param array|string $object_type Name of the object type for the taxonomy object.

<span class="cx" style="display: block; padding: 0 10px">         * @param array|string $args        Optional. Array or query string of arguments for registering a taxonomy.

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         *                                  See register_taxonomy() for information on accepted arguments.

</ins><span class="cx" style="display: block; padding: 0 10px">          *                                  Default empty array.

</span><span class="cx" style="display: block; padding: 0 10px">         */

</span><span class="cx" style="display: block; padding: 0 10px">        public function __construct( $taxonomy, $object_type, $args = array() ) {

</span></span></pre></div>

<a id="trunksrcwpincludesclasswpthemejsonresolverphp"></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-theme-json-resolver.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-theme-json-resolver.php    2023-04-27 22:27:51 UTC (rev 55693)

+++ trunk/src/wp-includes/class-wp-theme-json-resolver.php      2023-04-27 23:13:36 UTC (rev 55694)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -13,7 +13,7 @@

</span><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  * This class is for internal core usage and is not supposed to be used by extenders (plugins and/or themes).

</span><span class="cx" style="display: block; padding: 0 10px">  * This is a low-level API that may need to do breaking changes. Please,

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * use get_global_settings, get_global_styles, and get_global_stylesheet instead.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * use get_global_settings(), get_global_styles(), and get_global_stylesheet() instead.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @access private

</span><span class="cx" style="display: block; padding: 0 10px">  */

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -386,7 +386,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">         * Returns the custom post type that contains the user's origin config

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * for the active theme or a void array if none are found.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * for the active theme or an empty array if none are found.

</ins><span class="cx" style="display: block; padding: 0 10px">          *

<span class="cx" style="display: block; padding: 0 10px">         * This can also create and return a new draft custom post type.

</span><span class="cx" style="display: block; padding: 0 10px">         *

</span></span></pre></div>

<a id="trunksrcwpincludesclasswpdbphp"></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-wpdb.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wpdb.php      2023-04-27 22:27:51 UTC (rev 55693)

+++ trunk/src/wp-includes/class-wpdb.php        2023-04-27 23:13:36 UTC (rev 55694)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2556,13 +2556,13 @@

</span><span class="cx" style="display: block; padding: 0 10px">         *

<span class="cx" style="display: block; padding: 0 10px">         * @param string       $table  Table name.

<span class="cx" style="display: block; padding: 0 10px">         * @param array        $data   Data to insert (in column => value pairs).

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *                             Both $data columns and $data values should be "raw" (neither should be SQL escaped).

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  *                             Both `$data` columns and `$data` values should be "raw" (neither should be SQL escaped).

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             Sending a null value will cause the column to be set to NULL - the corresponding

<span class="cx" style="display: block; padding: 0 10px">         *                             format is ignored in this case.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @param array|string $format Optional. An array of formats to be mapped to each of the value in $data.

-        *                             If string, that format will be used for all of the values in $data.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @param array|string $format Optional. An array of formats to be mapped to each of the value in `$data`.

+        *                             If string, that format will be used for all of the values in `$data`.

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             A format is one of '%d', '%f', '%s' (integer, float, string).

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *                             If omitted, all values in $data will be treated as strings unless otherwise

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  *                             If omitted, all values in `$data` will be treated as strings unless otherwise

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             specified in wpdb::$field_types. Default null.

<span class="cx" style="display: block; padding: 0 10px">         * @return int|false The number of rows inserted, or false on error.

</span><span class="cx" style="display: block; padding: 0 10px">         */

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2586,13 +2586,13 @@

</span><span class="cx" style="display: block; padding: 0 10px">         *

<span class="cx" style="display: block; padding: 0 10px">         * @param string       $table  Table name.

<span class="cx" style="display: block; padding: 0 10px">         * @param array        $data   Data to insert (in column => value pairs).

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *                             Both $data columns and $data values should be "raw" (neither should be SQL escaped).

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  *                             Both `$data` columns and `$data` values should be "raw" (neither should be SQL escaped).

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             Sending a null value will cause the column to be set to NULL - the corresponding

<span class="cx" style="display: block; padding: 0 10px">         *                             format is ignored in this case.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @param array|string $format Optional. An array of formats to be mapped to each of the value in $data.

-        *                             If string, that format will be used for all of the values in $data.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @param array|string $format Optional. An array of formats to be mapped to each of the value in `$data`.

+        *                             If string, that format will be used for all of the values in `$data`.

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             A format is one of '%d', '%f', '%s' (integer, float, string).

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *                             If omitted, all values in $data will be treated as strings unless otherwise

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  *                             If omitted, all values in `$data` will be treated as strings unless otherwise

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             specified in wpdb::$field_types. Default null.

<span class="cx" style="display: block; padding: 0 10px">         * @return int|false The number of rows affected, or false on error.

</span><span class="cx" style="display: block; padding: 0 10px">         */

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2603,7 +2603,7 @@

</span><span class="cx" style="display: block; padding: 0 10px">        /**

<span class="cx" style="display: block; padding: 0 10px">         * Helper function for insert and replace.

</span><span class="cx" style="display: block; padding: 0 10px">         *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * Runs an insert or replace query based on $type argument.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * Runs an insert or replace query based on `$type` argument.

</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 class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2613,15 +2613,15 @@

</span><span class="cx" style="display: block; padding: 0 10px">         *

<span class="cx" style="display: block; padding: 0 10px">         * @param string       $table  Table name.

<span class="cx" style="display: block; padding: 0 10px">         * @param array        $data   Data to insert (in column => value pairs).

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *                             Both $data columns and $data values should be "raw" (neither should be SQL escaped).

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  *                             Both `$data` columns and `$data` values should be "raw" (neither should be SQL escaped).

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             Sending a null value will cause the column to be set to NULL - the corresponding

<span class="cx" style="display: block; padding: 0 10px">         *                             format is ignored in this case.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @param array|string $format Optional. An array of formats to be mapped to each of the value in $data.

-        *                             If string, that format will be used for all of the values in $data.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @param array|string $format Optional. An array of formats to be mapped to each of the value in `$data`.

+        *                             If string, that format will be used for all of the values in `$data`.

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             A format is one of '%d', '%f', '%s' (integer, float, string).

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *                             If omitted, all values in $data will be treated as strings unless otherwise

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  *                             If omitted, all values in `$data` will be treated as strings unless otherwise

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             specified in wpdb::$field_types. Default null.

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @param string       $type   Optional. Type of operation. Possible values include 'INSERT' or 'REPLACE'.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @param string       $type   Optional. Type of operation. Either 'INSERT' or 'REPLACE'.

</ins><span class="cx" style="display: block; padding: 0 10px">          *                             Default 'INSERT'.

<span class="cx" style="display: block; padding: 0 10px">         * @return int|false The number of rows affected, or false on error.

</span><span class="cx" style="display: block; padding: 0 10px">         */

</span></span></pre></div>

<a id="trunksrcwpincludeshttpphp"></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/http.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/http.php    2023-04-27 22:27:51 UTC (rev 55693)

+++ trunk/src/wp-includes/http.php      2023-04-27 23:13:36 UTC (rev 55694)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -39,6 +39,7 @@

</span><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  * @param string $url  URL to retrieve.