<!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>[29097] trunk/src/wp-includes/post.php: Fix syntax for inline comment line endings and a few line wraps in wp-includes/post.php inline documentation.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta">
<dt>Revision</dt> <dd><a href="http://core.trac.wordpress.org/changeset/29097">29097</a></dd>
<dt>Author</dt> <dd>DrewAPicture</dd>
<dt>Date</dt> <dd>2014-07-11 18:34:36 +0000 (Fri, 11 Jul 2014)</dd>
</dl>
<h3>Log Message</h3>
<pre>Fix syntax for inline comment line endings and a few line wraps in wp-includes/post.php inline documentation.
Fixes <a href="http://core.trac.wordpress.org/ticket/25412">#25412</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunksrcwpincludespostphp">trunk/src/wp-includes/post.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunksrcwpincludespostphp"></a>
<div class="modfile"><h4>Modified: trunk/src/wp-includes/post.php (29096 => 29097)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/src/wp-includes/post.php 2014-07-11 18:00:28 UTC (rev 29096)
+++ trunk/src/wp-includes/post.php 2014-07-11 18:34:36 UTC (rev 29097)
</span><span class="lines">@@ -391,7 +391,7 @@
</span><span class="cx"> $more_text = '';
</span><span class="cx"> }
</span><span class="cx">
</span><del>- // ` leading and trailing whitespace
</del><ins>+ // leading and trailing whitespace.
</ins><span class="cx"> $main = preg_replace('/^[\s]*(.*)[\s]*$/', '\\1', $main);
</span><span class="cx"> $extended = preg_replace('/^[\s]*(.*)[\s]*$/', '\\1', $extended);
</span><span class="cx"> $more_text = preg_replace('/^[\s]*(.*)[\s]*$/', '\\1', $more_text);
</span><span class="lines">@@ -871,11 +871,11 @@
</span><span class="cx"> if ( 'private' == $post->post_status )
</span><span class="cx"> return 'private';
</span><span class="cx">
</span><del>- // Unattached attachments are assumed to be published
</del><ins>+ // Unattached attachments are assumed to be published.
</ins><span class="cx"> if ( ( 'inherit' == $post->post_status ) && ( 0 == $post->post_parent) )
</span><span class="cx"> return 'publish';
</span><span class="cx">
</span><del>- // Inherit status from the parent
</del><ins>+ // Inherit status from the parent.
</ins><span class="cx"> if ( $post->post_parent && ( $post->ID != $post->post_parent ) ) {
</span><span class="cx"> $parent_post_status = get_post_status( $post->post_parent );
</span><span class="cx"> if ( 'trash' == $parent_post_status ) {
</span><span class="lines">@@ -1362,7 +1362,7 @@
</span><span class="cx"> if ( null === $args->exclude_from_search )
</span><span class="cx"> $args->exclude_from_search = !$args->public;
</span><span class="cx">
</span><del>- // Back compat with quirky handling in version 3.0. #14122
</del><ins>+ // Back compat with quirky handling in version 3.0. #14122.
</ins><span class="cx"> if ( empty( $args->capabilities ) && null === $args->map_meta_cap && in_array( $args->capability_type, array( 'post', 'page' ) ) )
</span><span class="cx"> $args->map_meta_cap = true;
</span><span class="cx">
</span><span class="lines">@@ -1696,7 +1696,7 @@
</span><span class="cx"> function _add_post_type_submenus() {
</span><span class="cx"> foreach ( get_post_types( array( 'show_ui' => true ) ) as $ptype ) {
</span><span class="cx"> $ptype_obj = get_post_type_object( $ptype );
</span><del>- // Submenus only.
</del><ins>+ // Sub-menus only.
</ins><span class="cx"> if ( ! $ptype_obj->show_in_menu || $ptype_obj->show_in_menu === true )
</span><span class="cx"> continue;
</span><span class="cx"> add_submenu_page( $ptype_obj->show_in_menu, $ptype_obj->labels->name, $ptype_obj->labels->all_items, $ptype_obj->cap->edit_posts, "edit.php?post_type=$ptype" );
</span><span class="lines">@@ -1948,7 +1948,7 @@
</span><span class="cx"> * false on failure.
</span><span class="cx"> */
</span><span class="cx"> function update_post_meta( $post_id, $meta_key, $meta_value, $prev_value = '' ) {
</span><del>- // make sure meta is added to the post, not a revision
</del><ins>+ // Make sure meta is added to the post, not a revision.
</ins><span class="cx"> if ( $the_post = wp_is_post_revision($post_id) )
</span><span class="cx"> $post_id = $the_post;
</span><span class="cx">
</span><span class="lines">@@ -2591,20 +2591,20 @@
</span><span class="cx"> $parent_where = array( 'post_parent' => $postid );
</span><span class="cx">
</span><span class="cx"> if ( is_post_type_hierarchical( $post->post_type ) ) {
</span><del>- // Point children of this page to its parent, also clean the cache of affected children
</del><ins>+ // Point children of this page to its parent, also clean the cache of affected children.
</ins><span class="cx"> $children_query = $wpdb->prepare( "SELECT * FROM $wpdb->posts WHERE post_parent = %d AND post_type = %s", $postid, $post->post_type );
</span><span class="cx"> $children = $wpdb->get_results( $children_query );
</span><span class="cx">
</span><span class="cx"> $wpdb->update( $wpdb->posts, $parent_data, $parent_where + array( 'post_type' => $post->post_type ) );
</span><span class="cx"> }
</span><span class="cx">
</span><del>- // Do raw query. wp_get_post_revisions() is filtered
</del><ins>+ // Do raw query. wp_get_post_revisions() is filtered.
</ins><span class="cx"> $revision_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'revision'", $postid ) );
</span><span class="cx"> // Use wp_delete_post (via wp_delete_post_revision) again. Ensures any meta/misplaced data gets cleaned up.
</span><span class="cx"> foreach ( $revision_ids as $revision_id )
</span><span class="cx"> wp_delete_post_revision( $revision_id );
</span><span class="cx">
</span><del>- // Point all attachments to this post up one level
</del><ins>+ // Point all attachments to this post up one level.
</ins><span class="cx"> $wpdb->update( $wpdb->posts, $parent_data, $parent_where + array( 'post_type' => 'attachment' ) );
</span><span class="cx">
</span><span class="cx"> $comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d", $postid ));
</span><span class="lines">@@ -2674,8 +2674,10 @@
</span><span class="cx"> function _reset_front_page_settings_for_post( $post_id ) {
</span><span class="cx"> $post = get_post( $post_id );
</span><span class="cx"> if ( 'page' == $post->post_type ) {
</span><del>- // If the page is defined in option page_on_front or post_for_posts,
- // adjust the corresponding options
</del><ins>+ /*
+ * If the page is defined in option page_on_front or post_for_posts,
+ * adjust the corresponding options.
+ */
</ins><span class="cx"> if ( get_option( 'page_on_front' ) == $post->ID ) {
</span><span class="cx"> update_option( 'show_on_front', 'posts' );
</span><span class="cx"> update_option( 'page_on_front', 0 );
</span><span class="lines">@@ -2820,13 +2822,13 @@
</span><span class="cx"> if ( empty($comments) )
</span><span class="cx"> return;
</span><span class="cx">
</span><del>- // Cache current status for each comment
</del><ins>+ // Cache current status for each comment.
</ins><span class="cx"> $statuses = array();
</span><span class="cx"> foreach ( $comments as $comment )
</span><span class="cx"> $statuses[$comment->comment_ID] = $comment->comment_approved;
</span><span class="cx"> add_post_meta($post_id, '_wp_trash_meta_comments_status', $statuses);
</span><span class="cx">
</span><del>- // Set status for all comments to post-trashed
</del><ins>+ // Set status for all comments to post-trashed.
</ins><span class="cx"> $result = $wpdb->update($wpdb->comments, array('comment_approved' => 'post-trashed'), array('comment_post_ID' => $post_id));
</span><span class="cx">
</span><span class="cx"> clean_comment_cache( array_keys($statuses) );
</span><span class="lines">@@ -2875,7 +2877,7 @@
</span><span class="cx"> */
</span><span class="cx"> do_action( 'untrash_post_comments', $post_id );
</span><span class="cx">
</span><del>- // Restore each comment to its original status
</del><ins>+ // Restore each comment to its original status.
</ins><span class="cx"> $group_by_status = array();
</span><span class="cx"> foreach ( $statuses as $comment_id => $comment_status )
</span><span class="cx"> $group_by_status[$comment_status][] = $comment_id;
</span><span class="lines">@@ -2994,7 +2996,7 @@
</span><span class="cx"> $args = array( 'numberposts' => absint( $args ) );
</span><span class="cx"> }
</span><span class="cx">
</span><del>- // Set default arguments
</del><ins>+ // Set default arguments.
</ins><span class="cx"> $defaults = array(
</span><span class="cx"> 'numberposts' => 10, 'offset' => 0,
</span><span class="cx"> 'category' => 0, 'orderby' => 'post_date',
</span><span class="lines">@@ -3008,7 +3010,7 @@
</span><span class="cx">
</span><span class="cx"> $results = get_posts( $r );
</span><span class="cx">
</span><del>- // Backward compatibility. Prior to 3.1 expected posts to be returned in array
</del><ins>+ // Backward compatibility. Prior to 3.1 expected posts to be returned in array.
</ins><span class="cx"> if ( ARRAY_A == $output ){
</span><span class="cx"> foreach( $results as $key => $result ) {
</span><span class="cx"> $results[$key] = get_object_vars( $result );
</span><span class="lines">@@ -3526,7 +3528,7 @@
</span><span class="cx"> */
</span><span class="cx"> function wp_update_post( $postarr = array(), $wp_error = false ) {
</span><span class="cx"> if ( is_object($postarr) ) {
</span><del>- // non-escaped post was passed
</del><ins>+ // Non-escaped post was passed.
</ins><span class="cx"> $postarr = get_object_vars($postarr);
</span><span class="cx"> $postarr = wp_slash($postarr);
</span><span class="cx"> }
</span><span class="lines">@@ -3634,7 +3636,8 @@
</span><span class="cx">
</span><span class="cx"> $time = strtotime( $post->post_date_gmt . ' GMT' );
</span><span class="cx">
</span><del>- if ( $time > time() ) { // Uh oh, someone jumped the gun!
</del><ins>+ // Uh oh, someone jumped the gun!
+ if ( $time > time() ) {
</ins><span class="cx"> wp_clear_scheduled_hook( 'publish_future_post', array( $post_id ) ); // clear anything else in the system
</span><span class="cx"> wp_schedule_single_event( $time, 'publish_future_post', array( $post_id ) );
</span><span class="cx"> return;
</span><span class="lines">@@ -3988,7 +3991,7 @@
</span><span class="cx"> */
</span><span class="cx"> $new = apply_filters( 'add_ping', $new );
</span><span class="cx">
</span><del>- // expected_slashed ($new)
</del><ins>+ // expected_slashed ($new).
</ins><span class="cx"> $new = wp_unslash($new);
</span><span class="cx"> return $wpdb->update( $wpdb->posts, array( 'pinged' => $new ), array( 'ID' => $post_id ) );
</span><span class="cx"> }
</span><span class="lines">@@ -4092,10 +4095,10 @@
</span><span class="cx"> */
</span><span class="cx"> function trackback_url_list( $tb_list, $post_id ) {
</span><span class="cx"> if ( ! empty( $tb_list ) ) {
</span><del>- // get post data
</del><ins>+ // Get post data.
</ins><span class="cx"> $postdata = get_post( $post_id, ARRAY_A );
</span><span class="cx">
</span><del>- // form an excerpt
</del><ins>+ // Form an excerpt.
</ins><span class="cx"> $excerpt = strip_tags( $postdata['post_excerpt'] ? $postdata['post_excerpt'] : $postdata['post_content'] );
</span><span class="cx">
</span><span class="cx"> if ( strlen( $excerpt ) > 255 ) {
</span><span class="lines">@@ -4431,7 +4434,7 @@
</span><span class="cx"> $parent = $r['parent'];
</span><span class="cx"> $post_status = $r['post_status'];
</span><span class="cx">
</span><del>- // Make sure the post type is hierarchical
</del><ins>+ // Make sure the post type is hierarchical.
</ins><span class="cx"> $hierarchical_post_types = get_post_types( array( 'hierarchical' => true ) );
</span><span class="cx"> if ( ! in_array( $r['post_type'], $hierarchical_post_types ) ) {
</span><span class="cx"> return false;
</span><span class="lines">@@ -4441,7 +4444,7 @@
</span><span class="cx"> $hierarchical = false;
</span><span class="cx"> }
</span><span class="cx">
</span><del>- // Make sure we have a valid post status
</del><ins>+ // Make sure we have a valid post status.
</ins><span class="cx"> if ( ! is_array( $post_status ) ) {
</span><span class="cx"> $post_status = explode( ',', $post_status );
</span><span class="cx"> }
</span><span class="lines">@@ -4449,7 +4452,7 @@
</span><span class="cx"> return false;
</span><span class="cx"> }
</span><span class="cx">
</span><del>- // $args can be whatever, only use the args defined in defaults to compute the key
</del><ins>+ // $args can be whatever, only use the args defined in defaults to compute the key.
</ins><span class="cx"> $key = md5( serialize( wp_array_slice_assoc( $r, array_keys( $defaults ) ) ) );
</span><span class="cx"> $last_changed = wp_cache_get( 'last_changed', 'posts' );
</span><span class="cx"> if ( ! $last_changed ) {
</span><span class="lines">@@ -4459,7 +4462,7 @@
</span><span class="cx">
</span><span class="cx"> $cache_key = "get_pages:$key:$last_changed";
</span><span class="cx"> if ( $cache = wp_cache_get( $cache_key, 'posts' ) ) {
</span><del>- // Convert to WP_Post instances
</del><ins>+ // Convert to WP_Post instances.
</ins><span class="cx"> $pages = array_map( 'get_post', $cache );
</span><span class="cx"> /** This filter is documented in wp-includes/post.php */
</span><span class="cx"> $pages = apply_filters( 'get_pages', $pages, $r );
</span><span class="lines">@@ -4608,7 +4611,7 @@
</span><span class="cx"> return $pages;
</span><span class="cx"> }
</span><span class="cx">
</span><del>- // Sanitize before caching so it'll only get done once
</del><ins>+ // Sanitize before caching so it'll only get done once.
</ins><span class="cx"> $num_pages = count($pages);
</span><span class="cx"> for ($i = 0; $i < $num_pages; $i++) {
</span><span class="cx"> $pages[$i] = sanitize_post($pages[$i], 'raw');
</span><span class="lines">@@ -4645,7 +4648,7 @@
</span><span class="cx">
</span><span class="cx"> wp_cache_set( $cache_key, $page_structure, 'posts' );
</span><span class="cx">
</span><del>- // Convert to WP_Post instances
</del><ins>+ // Convert to WP_Post instances.
</ins><span class="cx"> $pages = array_map( 'get_post', $pages );
</span><span class="cx">
</span><span class="cx"> /**
</span><span class="lines">@@ -4780,7 +4783,8 @@
</span><span class="cx"> wp_delete_object_term_relationships($post_id, array('category', 'post_tag'));
</span><span class="cx"> wp_delete_object_term_relationships($post_id, get_object_taxonomies($post->post_type));
</span><span class="cx">
</span><del>- delete_metadata( 'post', null, '_thumbnail_id', $post_id, true ); // delete all for any posts.
</del><ins>+ // Delete all for any posts.
+ delete_metadata( 'post', null, '_thumbnail_id', $post_id, true );
</ins><span class="cx">
</span><span class="cx"> $comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d", $post_id ));
</span><span class="cx"> foreach ( $comment_ids as $comment_id )
</span><span class="lines">@@ -5272,7 +5276,7 @@
</span><span class="cx">
</span><span class="cx"> $sql .= "(post_status = 'publish'";
</span><span class="cx">
</span><del>- // Only need to check the cap if $public_only is false
</del><ins>+ // Only need to check the cap if $public_only is false.
</ins><span class="cx"> if ( false === $public_only ) {
</span><span class="cx"> if ( current_user_can( $cap ) ) {
</span><span class="cx"> // Does the user have the capability to view private posts? Guess so.
</span><span class="lines">@@ -5592,7 +5596,7 @@
</span><span class="cx"> global $wpdb;
</span><span class="cx">
</span><span class="cx"> if ( $old_status != 'publish' && $new_status == 'publish' ) {
</span><del>- // Reset GUID if transitioning to publish and it is empty
</del><ins>+ // Reset GUID if transitioning to publish and it is empty.
</ins><span class="cx"> if ( '' == get_the_guid($post->ID) )
</span><span class="cx"> $wpdb->update( $wpdb->posts, array( 'guid' => get_permalink( $post->ID ) ), array( 'ID' => $post->ID ) );
</span><span class="cx">
</span><span class="lines">@@ -5607,7 +5611,7 @@
</span><span class="cx"> do_action('private_to_published', $post->ID);
</span><span class="cx"> }
</span><span class="cx">
</span><del>- // If published posts changed clear the lastpostmodified cache
</del><ins>+ // If published posts changed clear the lastpostmodified cache.
</ins><span class="cx"> if ( 'publish' == $new_status || 'publish' == $old_status) {
</span><span class="cx"> foreach ( array( 'server', 'gmt', 'blog' ) as $timezone ) {
</span><span class="cx"> wp_cache_delete( "lastpostmodified:$timezone", 'timeinfo' );
</span><span class="lines">@@ -5706,24 +5710,23 @@
</span><span class="cx"> * @return int The new post_parent for the post, 0 otherwise.
</span><span class="cx"> */
</span><span class="cx"> function wp_check_post_hierarchy_for_loops( $post_parent, $post_ID ) {
</span><del>- // Nothing fancy here - bail
</del><ins>+ // Nothing fancy here - bail.
</ins><span class="cx"> if ( !$post_parent )
</span><span class="cx"> return 0;
</span><span class="cx">
</span><del>- // New post can't cause a loop
</del><ins>+ // New post can't cause a loop.
</ins><span class="cx"> if ( empty( $post_ID ) )
</span><span class="cx"> return $post_parent;
</span><span class="cx">
</span><del>- // Can't be its own parent
</del><ins>+ // Can't be its own parent.
</ins><span class="cx"> if ( $post_parent == $post_ID )
</span><span class="cx"> return 0;
</span><span class="cx">
</span><del>- // Now look for larger loops
-
</del><ins>+ // Now look for larger loops.
</ins><span class="cx"> if ( !$loop = wp_find_hierarchy_loop( 'wp_get_post_parent_id', $post_ID, $post_parent ) )
</span><span class="cx"> return $post_parent; // No loop
</span><span class="cx">
</span><del>- // Setting $post_parent to the given value causes a loop
</del><ins>+ // Setting $post_parent to the given value causes a loop.
</ins><span class="cx"> if ( isset( $loop[$post_ID] ) )
</span><span class="cx"> return 0;
</span><span class="cx">
</span><span class="lines">@@ -5789,8 +5792,11 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * Update the custom taxonomies' term counts when a post's status is changed. For example, default posts term counts (for custom taxonomies) don't include private / draft posts.
</del><ins>+ * Update the custom taxonomies' term counts when a post's status is changed.
</ins><span class="cx"> *
</span><ins>+ * For example, default posts term counts (for custom taxonomies) don't include
+ * private / draft posts.
+ *
</ins><span class="cx"> * @since 3.3.0
</span><span class="cx"> * @access private
</span><span class="cx"> *
</span><span class="lines">@@ -5810,9 +5816,10 @@
</span><span class="cx"> * Adds any posts from the given ids to the cache that do not already exist in cache
</span><span class="cx"> *
</span><span class="cx"> * @since 3.4.0
</span><del>- *
</del><span class="cx"> * @access private
</span><span class="cx"> *
</span><ins>+ * @see update_post_caches()
+ *
</ins><span class="cx"> * @param array $post_ids ID list
</span><span class="cx"> * @param bool $update_term_cache Optional. Whether to update the term cache. Default true.
</span><span class="cx"> * @param bool $update_meta_cache Optional. Whether to update the meta cache. Default true.
</span></span></pre>
</div>
</div>
</body>
</html>