<!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" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { 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 #fc0 solid; padding: 6px; }
#msg ul, pre { overflow: auto; }
#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>
<title>[15564] trunk: phpdoc, @since, whitespace.</title>
</head>
<body>
<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.wordpress.org/changeset/15564">15564</a></dd>
<dt>Author</dt> <dd>nacin</dd>
<dt>Date</dt> <dd>2010-09-05 02:45:39 +0000 (Sun, 05 Sep 2010)</dd>
</dl>
<h3>Log Message</h3>
<pre>phpdoc, @since, whitespace. Also require an argument in wp_insert_post(). props duck_, see <a href="http://trac.wordpress.org/ticket/14783">#14783</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkwpadminadminajaxphp">trunk/wp-admin/admin-ajax.php</a></li>
<li><a href="#trunkwpadmincustombackgroundphp">trunk/wp-admin/custom-background.php</a></li>
<li><a href="#trunkwpadminincludesbookmarkphp">trunk/wp-admin/includes/bookmark.php</a></li>
<li><a href="#trunkwpadminincludescommentphp">trunk/wp-admin/includes/comment.php</a></li>
<li><a href="#trunkwpadminincludesdashboardphp">trunk/wp-admin/includes/dashboard.php</a></li>
<li><a href="#trunkwpincludesgeneraltemplatephp">trunk/wp-includes/general-template.php</a></li>
<li><a href="#trunkwpincludespostphp">trunk/wp-includes/post.php</a></li>
<li><a href="#trunkwpincludeswpdbphp">trunk/wp-includes/wp-db.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwpadminadminajaxphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/admin-ajax.php (15563 => 15564)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/admin-ajax.php 2010-09-04 15:51:04 UTC (rev 15563)
+++ trunk/wp-admin/admin-ajax.php 2010-09-05 02:45:39 UTC (rev 15564)
</span><span class="lines">@@ -9,7 +9,7 @@
</span><span class="cx"> /**
</span><span class="cx"> * Executing AJAX process.
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.1.0
</ins><span class="cx"> */
</span><span class="cx"> define('DOING_AJAX', true);
</span><span class="cx"> define('WP_ADMIN', true);
</span></span></pre></div>
<a id="trunkwpadmincustombackgroundphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/custom-background.php (15563 => 15564)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/custom-background.php 2010-09-04 15:51:04 UTC (rev 15563)
+++ trunk/wp-admin/custom-background.php 2010-09-05 02:45:39 UTC (rev 15564)
</span><span class="lines">@@ -311,7 +311,7 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * Handle a Image upload for the background image.
</del><ins>+ * Handle an Image upload for the background image.
</ins><span class="cx"> *
</span><span class="cx"> * @since 3.0.0
</span><span class="cx"> */
</span></span></pre></div>
<a id="trunkwpadminincludesbookmarkphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/includes/bookmark.php (15563 => 15564)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/includes/bookmark.php 2010-09-04 15:51:04 UTC (rev 15563)
+++ trunk/wp-admin/includes/bookmark.php 2010-09-05 02:45:39 UTC (rev 15564)
</span><span class="lines">@@ -7,27 +7,27 @@
</span><span class="cx"> */
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Add a link to using values provided in $_POST.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> *
</span><del>- * @return unknown
</del><ins>+ * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
</ins><span class="cx"> */
</span><span class="cx"> function add_link() {
</span><span class="cx"> return edit_link();
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Update or insert a link using values provided in $_POST.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> *
</span><del>- * @param unknown_type $link_id
- * @return unknown
</del><ins>+ * @param int $link_id Optional. ID of the link to edit.
+ * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
</ins><span class="cx"> */
</span><del>-function edit_link( $link_id = '' ) {
- if (!current_user_can( 'manage_links' ))
- wp_die( __( 'Cheatin&#8217; uh?' ));
</del><ins>+function edit_link( $link_id = 0 ) {
+ if ( !current_user_can( 'manage_links' ) )
+ wp_die( __( 'Cheatin&#8217; uh?' ) );
</ins><span class="cx">
</span><span class="cx"> $_POST['link_url'] = esc_html( $_POST['link_url'] );
</span><span class="cx"> $_POST['link_url'] = esc_url($_POST['link_url']);
</span><span class="lines">@@ -39,27 +39,27 @@
</span><span class="cx">
</span><span class="cx"> if ( !empty( $link_id ) ) {
</span><span class="cx"> $_POST['link_id'] = $link_id;
</span><del>- return wp_update_link( $_POST);
</del><ins>+ return wp_update_link( $_POST );
</ins><span class="cx"> } else {
</span><del>- return wp_insert_link( $_POST);
</del><ins>+ return wp_insert_link( $_POST );
</ins><span class="cx"> }
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Retrieve the default link for editing.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> *
</span><del>- * @return unknown
</del><ins>+ * @return object Default link
</ins><span class="cx"> */
</span><span class="cx"> function get_default_link_to_edit() {
</span><span class="cx"> if ( isset( $_GET['linkurl'] ) )
</span><del>- $link->link_url = esc_url( $_GET['linkurl']);
</del><ins>+ $link->link_url = esc_url( $_GET['linkurl'] );
</ins><span class="cx"> else
</span><span class="cx"> $link->link_url = '';
</span><span class="cx">
</span><span class="cx"> if ( isset( $_GET['name'] ) )
</span><del>- $link->link_name = esc_attr( $_GET['name']);
</del><ins>+ $link->link_name = esc_attr( $_GET['name'] );
</ins><span class="cx"> else
</span><span class="cx"> $link->link_name = '';
</span><span class="cx">
</span><span class="lines">@@ -69,12 +69,12 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Delete link specified from database
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> *
</span><del>- * @param unknown_type $link_id
- * @return unknown
</del><ins>+ * @param int $link_id ID of the link to delete
+ * @return bool True
</ins><span class="cx"> */
</span><span class="cx"> function wp_delete_link( $link_id ) {
</span><span class="cx"> global $wpdb;
</span><span class="lines">@@ -93,12 +93,12 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Retrieves the link categories associated with the link specified.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.1.0
</ins><span class="cx"> *
</span><del>- * @param unknown_type $link_id
- * @return unknown
</del><ins>+ * @param int $link_id Link ID to look up
+ * @return array The requested link's categories
</ins><span class="cx"> */
</span><span class="cx"> function wp_get_link_cats( $link_id = 0 ) {
</span><span class="cx">
</span><span class="lines">@@ -108,24 +108,25 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Retrieve link data based on ID.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> *
</span><del>- * @param unknown_type $link_id
- * @return unknown
</del><ins>+ * @param int $link_id ID of link to retrieve
+ * @return object Link for editing
</ins><span class="cx"> */
</span><span class="cx"> function get_link_to_edit( $link_id ) {
</span><span class="cx"> return get_bookmark( $link_id, OBJECT, 'edit' );
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * This function inserts/updates links into/in the database.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> *
</span><del>- * @param unknown_type $linkdata
- * @return unknown
</del><ins>+ * @param array $linkdata Elements that make up the link to insert.
+ * @param bool $wp_error Optional. If true return WP_Error object on failure.
+ * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
</ins><span class="cx"> */
</span><span class="cx"> function wp_insert_link( $linkdata, $wp_error = false ) {
</span><span class="cx"> global $wpdb;
</span><span class="lines">@@ -181,7 +182,7 @@
</span><span class="cx"> $link_rel = '';
</span><span class="cx">
</span><span class="cx"> // Make sure we set a valid category
</span><del>- if ( ! isset( $link_category ) ||0 == count( $link_category ) || !is_array( $link_category ) ) {
</del><ins>+ if ( ! isset( $link_category ) || 0 == count( $link_category ) || !is_array( $link_category ) ) {
</ins><span class="cx"> $link_category = array( get_option( 'default_link_category' ) );
</span><span class="cx"> }
</span><span class="cx">
</span><span class="lines">@@ -215,12 +216,12 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Update link with the specified link categories.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.1.0
</ins><span class="cx"> *
</span><del>- * @param unknown_type $link_id
- * @param unknown_type $link_categories
</del><ins>+ * @param int $link_id ID of link to update
+ * @param array $link_categories Array of categories to
</ins><span class="cx"> */
</span><span class="cx"> function wp_set_link_cats( $link_id = 0, $link_categories = array() ) {
</span><span class="cx"> // If $link_categories isn't already an array, make it one:
</span><span class="lines">@@ -233,15 +234,15 @@
</span><span class="cx"> wp_set_object_terms( $link_id, $link_categories, 'link_category' );
</span><span class="cx">
</span><span class="cx"> clean_bookmark_cache( $link_id );
</span><del>-} // wp_set_link_cats()
</del><ins>+}
</ins><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Update a link in the database.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> *
</span><del>- * @param unknown_type $linkdata
- * @return unknown
</del><ins>+ * @param array $linkdata Link data to update.
+ * @return int|WP_Error Value 0 or WP_Error on failure. The updated link ID on success.
</ins><span class="cx"> */
</span><span class="cx"> function wp_update_link( $linkdata ) {
</span><span class="cx"> $link_id = (int) $linkdata['link_id'];
</span></span></pre></div>
<a id="trunkwpadminincludescommentphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/includes/comment.php (15563 => 15564)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/includes/comment.php 2010-09-04 15:51:04 UTC (rev 15563)
+++ trunk/wp-admin/includes/comment.php 2010-09-05 02:45:39 UTC (rev 15564)
</span><span class="lines">@@ -9,11 +9,11 @@
</span><span class="cx"> /**
</span><span class="cx"> * {@internal Missing Short Description}}
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> * @uses $wpdb
</span><span class="cx"> *
</span><del>- * @param string $comment_author
- * @param string $comment_date
</del><ins>+ * @param string $comment_author Author of the comment
+ * @param string $comment_date Date of the comment
</ins><span class="cx"> * @return mixed Comment ID on success.
</span><span class="cx"> */
</span><span class="cx"> function comment_exists($comment_author, $comment_date) {
</span><span class="lines">@@ -27,16 +27,15 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * {@internal Missing Short Description}}
</del><ins>+ * Update a comment with values provided in $_POST.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> */
</span><span class="cx"> function edit_comment() {
</span><del>-
</del><span class="cx"> $comment_post_ID = (int) $_POST['comment_post_ID'];
</span><span class="cx">
</span><span class="cx"> if (!current_user_can( 'edit_post', $comment_post_ID ))
</span><del>- wp_die( __('You are not allowed to edit comments on this post, so you cannot edit this comment.' ));
</del><ins>+ wp_die( __('You are not allowed to edit comments on this post, so you cannot edit this comment.' ) );
</ins><span class="cx">
</span><span class="cx"> $_POST['comment_author'] = $_POST['newcomment_author'];
</span><span class="cx"> $_POST['comment_author_email'] = $_POST['newcomment_author_email'];
</span><span class="lines">@@ -52,7 +51,7 @@
</span><span class="cx"> }
</span><span class="cx"> }
</span><span class="cx">
</span><del>- if (!empty ( $_POST['edit_date'] ) ) {
</del><ins>+ if ( !empty ( $_POST['edit_date'] ) ) {
</ins><span class="cx"> $aa = $_POST['aa'];
</span><span class="cx"> $mm = $_POST['mm'];
</span><span class="cx"> $jj = $_POST['jj'];
</span><span class="lines">@@ -66,16 +65,16 @@
</span><span class="cx"> $_POST['comment_date'] = "$aa-$mm-$jj $hh:$mn:$ss";
</span><span class="cx"> }
</span><span class="cx">
</span><del>- wp_update_comment( $_POST);
</del><ins>+ wp_update_comment( $_POST );
</ins><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><span class="cx"> * {@internal Missing Short Description}}
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.0.0
</ins><span class="cx"> *
</span><del>- * @param unknown_type $id
- * @return unknown
</del><ins>+ * @param int $id ID of comment to retrieve
+ * @return bool|object Comment if found. False on failure.
</ins><span class="cx"> */
</span><span class="cx"> function get_comment_to_edit( $id ) {
</span><span class="cx"> if ( !$comment = get_comment($id) )
</span><span class="lines">@@ -98,7 +97,7 @@
</span><span class="cx"> /**
</span><span class="cx"> * Get the number of pending comments on a post or posts
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.3.0
</ins><span class="cx"> * @uses $wpdb
</span><span class="cx"> *
</span><span class="cx"> * @param int|array $post_id Either a single Post ID or an array of Post IDs
</span></span></pre></div>
<a id="trunkwpadminincludesdashboardphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/includes/dashboard.php (15563 => 15564)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/includes/dashboard.php 2010-09-04 15:51:04 UTC (rev 15563)
+++ trunk/wp-admin/includes/dashboard.php 2010-09-05 02:45:39 UTC (rev 15564)
</span><span class="lines">@@ -9,9 +9,9 @@
</span><span class="cx"> /**
</span><span class="cx"> * Registers dashboard widgets.
</span><span class="cx"> *
</span><del>- * handles POST data, sets up filters.
</del><ins>+ * Handles POST data, sets up filters.
</ins><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> */
</span><span class="cx"> function wp_dashboard_setup() {
</span><span class="cx"> global $wp_registered_widgets, $wp_registered_widget_controls, $wp_dashboard_control_callbacks;
</span><span class="lines">@@ -150,7 +150,7 @@
</span><span class="cx"> /**
</span><span class="cx"> * Displays the dashboard.
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> */
</span><span class="cx"> function wp_dashboard() {
</span><span class="cx"> global $screen_layout_columns;
</span><span class="lines">@@ -517,7 +517,7 @@
</span><span class="cx"> /**
</span><span class="cx"> * Display recent comments dashboard widget content.
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> */
</span><span class="cx"> function wp_dashboard_recent_comments() {
</span><span class="cx"> global $wpdb;
</span><span class="lines">@@ -703,7 +703,7 @@
</span><span class="cx"> /**
</span><span class="cx"> * Display incoming links dashboard widget content.
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> */
</span><span class="cx"> function wp_dashboard_incoming_links_output() {
</span><span class="cx"> $widgets = get_option( 'dashboard_widget_options' );
</span><span class="lines">@@ -795,9 +795,9 @@
</span><span class="cx"> /**
</span><span class="cx"> * {@internal Missing Short Description}}
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> *
</span><del>- * @param int $widget_id
</del><ins>+ * @param string $widget_id
</ins><span class="cx"> */
</span><span class="cx"> function wp_dashboard_rss_output( $widget_id ) {
</span><span class="cx"> $widgets = get_option( 'dashboard_widget_options' );
</span><span class="lines">@@ -817,7 +817,7 @@
</span><span class="cx"> /**
</span><span class="cx"> * Display secondary dashboard RSS widget feed.
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> *
</span><span class="cx"> * @return unknown
</span><span class="cx"> */
</span><span class="lines">@@ -852,7 +852,7 @@
</span><span class="cx"> /**
</span><span class="cx"> * Display plugins most popular, newest plugins, and recently updated widget text.
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> */
</span><span class="cx"> function wp_dashboard_plugins_output() {
</span><span class="cx"> $popular = fetch_feed( 'http://wordpress.org/extend/plugins/rss/browse/popular/' );
</span><span class="lines">@@ -938,9 +938,9 @@
</span><span class="cx"> * echoes out output for this widget. If not cache, echo a "Loading..." stub
</span><span class="cx"> * which is later replaced by AJAX call (see top of /wp-admin/index.php)
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> *
</span><del>- * @param int $widget_id
</del><ins>+ * @param string $widget_id
</ins><span class="cx"> * @param callback $callback
</span><span class="cx"> * @param array $check_urls RSS feeds
</span><span class="cx"> * @return bool False on failure. True on success.
</span><span class="lines">@@ -981,7 +981,7 @@
</span><span class="cx"> /**
</span><span class="cx"> * Calls widget control callback.
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> *
</span><span class="cx"> * @param int $widget_control_id Registered Widget ID.
</span><span class="cx"> */
</span><span class="lines">@@ -999,10 +999,10 @@
</span><span class="cx"> * Sets up $args to be used as input to wp_widget_rss_form(). Handles POST data
</span><span class="cx"> * from RSS-type widgets.
</span><span class="cx"> *
</span><del>- * @since unknown
</del><ins>+ * @since 2.5.0
</ins><span class="cx"> *
</span><del>- * @param string widget_id
- * @param array form_inputs
</del><ins>+ * @param string $widget_id
+ * @param array $form_inputs
</ins><span class="cx"> */
</span><span class="cx"> function wp_dashboard_rss_control( $widget_id, $form_inputs = array() ) {
</span><span class="cx"> if ( !$widget_options = get_option( 'dashboard_widget_options' ) )
</span></span></pre></div>
<a id="trunkwpincludesgeneraltemplatephp"></a>
<div class="modfile"><h4>Modified: trunk/wp-includes/general-template.php (15563 => 15564)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-includes/general-template.php 2010-09-04 15:51:04 UTC (rev 15563)
+++ trunk/wp-includes/general-template.php 2010-09-05 02:45:39 UTC (rev 15564)
</span><span class="lines">@@ -381,7 +381,7 @@
</span><span class="cx"> *
</span><span class="cx"> * The possible values for the 'show' parameter are listed below.
</span><span class="cx"> * <ol>
</span><del>- * <li><strong>url<strong> - Blog URI to homepage.</li>
</del><ins>+ * <li><strong>url</strong> - Blog URI to homepage.</li>
</ins><span class="cx"> * <li><strong>wpurl</strong> - Blog URI path to WordPress.</li>
</span><span class="cx"> * <li><strong>description</strong> - Secondary title</li>
</span><span class="cx"> * </ol>
</span><span class="lines">@@ -1318,7 +1318,7 @@
</span><span class="cx"> *
</span><span class="cx"> * Will only output the date if the current post's date is different from the
</span><span class="cx"> * previous one output.
</span><del>-
</del><ins>+ *
</ins><span class="cx"> * i.e. Only one date listing will show per day worth of posts shown in the loop, even if the
</span><span class="cx"> * function is called several times for each post.
</span><span class="cx"> *
</span></span></pre></div>
<a id="trunkwpincludespostphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-includes/post.php (15563 => 15564)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-includes/post.php 2010-09-04 15:51:04 UTC (rev 15563)
+++ trunk/wp-includes/post.php 2010-09-05 02:45:39 UTC (rev 15564)
</span><span class="lines">@@ -2125,25 +2125,20 @@
</span><span class="cx"> * 'post_excerpt' - Post excerpt.
</span><span class="cx"> *
</span><span class="cx"> * @since 1.0.0
</span><del>- * @link http://core.trac.wordpress.org/ticket/9084 Bug report on 'wp_insert_post_data' filter.
</del><span class="cx"> * @uses $wpdb
</span><span class="cx"> * @uses $wp_rewrite
</span><span class="cx"> * @uses $user_ID
</span><del>- *
</del><span class="cx"> * @uses do_action() Calls 'pre_post_update' on post ID if this is an update.
</span><span class="cx"> * @uses do_action() Calls 'edit_post' action on post ID and post data if this is an update.
</span><del>- * @uses do_action() Calls 'save_post' and 'wp_insert_post' on post id and post data just before
- * returning.
- *
- * @uses apply_filters() Calls 'wp_insert_post_data' passing $data, $postarr prior to database
- * update or insert.
</del><ins>+ * @uses do_action() Calls 'save_post' and 'wp_insert_post' on post id and post data just before returning.
+ * @uses apply_filters() Calls 'wp_insert_post_data' passing $data, $postarr prior to database update or insert.
</ins><span class="cx"> * @uses wp_transition_post_status()
</span><span class="cx"> *
</span><del>- * @param array $postarr Optional. Overrides defaults.
</del><ins>+ * @param array $postarr Elements that make up post to insert.
</ins><span class="cx"> * @param bool $wp_error Optional. Allow return of WP_Error on failure.
</span><span class="cx"> * @return int|WP_Error The value 0 or WP_Error on failure. The post ID on success.
</span><span class="cx"> */
</span><del>-function wp_insert_post($postarr = array(), $wp_error = false) {
</del><ins>+function wp_insert_post($postarr, $wp_error = false) {
</ins><span class="cx"> global $wpdb, $wp_rewrite, $user_ID;
</span><span class="cx">
</span><span class="cx"> $defaults = array('post_status' => 'draft', 'post_type' => 'post', 'post_author' => $user_ID,
</span></span></pre></div>
<a id="trunkwpincludeswpdbphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-includes/wp-db.php (15563 => 15564)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-includes/wp-db.php 2010-09-04 15:51:04 UTC (rev 15563)
+++ trunk/wp-includes/wp-db.php 2010-09-05 02:45:39 UTC (rev 15564)
</span><span class="lines">@@ -48,7 +48,6 @@
</span><span class="cx"> * @package WordPress
</span><span class="cx"> * @subpackage Database
</span><span class="cx"> * @since 0.71
</span><del>- * @final
</del><span class="cx"> */
</span><span class="cx"> class wpdb {
</span><span class="cx">
</span></span></pre>
</div>
</div>
</body>
</html>