Ticket #31008: 31008.3.patch

wp-includes/wp-diff.php

@@ -42 +42 @@
         public $_trailing_context_lines = 10000;
 
         /**
-         * {@internal Missing Description}}
+         * Threshold for when a diff should be saved or omitted.
          *
          * @var float
          * @access protected

wp-admin/includes/post.php

@@ -733 +733 @@
 //
 
 /**
- * {@internal Missing Short Description}}
+ * Add post meta data defined in $_POST superglobal for post with given ID.
  *
  * @since 1.2.0
  *
@@ -772 +772 @@
 } // add_meta
 
 /**
- * {@internal Missing Short Description}}
+ * Delete post meta data by meta ID.
  *
  * @since 1.2.0
  *
@@ -803 +803 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Get post meta data by meta ID.
  *
  * @since 2.1.0
  *
@@ -815 +815 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Get meta data for given post ID.
  *
- * Some postmeta stuff.
- *
  * @since 1.2.0
  *
  * @param int $postid
@@ -833 +831 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Update post meta data by meta ID.
  *
  * @since 1.2.0
  *
@@ -1006 +1004 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Get all available post MIME types for given post type (default is attachment).
  *
  * @since 2.5.0
  *

wp-includes/wp-db.php

@@ -230 +230 @@
         var $ready = false;
 
         /**
-         * {@internal Missing Description}}
+         * Blog ID.
          *
          * @since 3.0.0
          * @access public
@@ -239 +239 @@
         public $blogid = 0;
 
         /**
-         * {@internal Missing Description}}
+         * Site ID.
          *
          * @since 3.0.0
          * @access public

wp-admin/includes/taxonomy.php

@@ -29 +29 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Get category object for given ID and 'edit' context.
  *
  * @since 2.0.0
  *
@@ -43 +43 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Add a new category to the database, if it does not already exist.
  *
  * @since 2.0.0
  *
@@ -64 +64 @@
  * @since 2.0.0
  *
  * @param array $categories List of categories to create.
- * @param int   $post_id    Optional. The post ID. Default empty.
- * @return List of categories to create for the given post.
+ * @param int   $post_id    Optional. The post ID. Default 0.
+ * @return array
  */
-function wp_create_categories( $categories, $post_id = '' ) {
+function wp_create_categories( $categories, $post_id = 0 ) {
         $cat_ids = array ();
         foreach ( $categories as $category ) {
                 if ( $id = category_exists( $category ) ) {
@@ -189 +189 @@
 //
 
 /**
- * {@internal Missing Short Description}}
+ * Check whether post tag with given name exists.
  *
  * @since 2.3.0
  *
@@ -201 +201 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Add a new tag to the database, if it does not already exist.
  *
  * @since 2.3.0
  *
@@ -213 +213 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Get comma-separated list of tags available to edit.
  *
  * @since 2.3.0
  *
- * @param int $post_id
+ * @param int    $post_id
+ * @param string $taxonomy The taxonomy for which to retrieve terms. Default 'post_tag'.
  * @return string|bool|WP_Error
  */
 function get_tags_to_edit( $post_id, $taxonomy = 'post_tag' ) {
@@ -225 +226 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Get comma-separated list of terms available to edit.
  *
  * @since 2.8.0
  *
- * @param int $post_id
+ * @param int    $post_id
+ * @param string $taxonomy The taxonomy for which to retrieve terms. Default 'post_tag'.
  * @return string|bool|WP_Error
  */
 function get_terms_to_edit( $post_id, $taxonomy = 'post_tag' ) {
@@ -272 +274 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Add a new term to the database, if it does not already exist.
  *
  * @since 2.8.0
  *
  * @param int|string $tag_name
+ * @param string $taxonomy The taxonomy for which to retrieve terms. Default 'post_tag'.
  * @return array|WP_Error
  */
 function wp_create_term($tag_name, $taxonomy = 'post_tag') {

wp-admin/includes/widgets.php

@@ -95 +95 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Before/After Dynamic controls for widgets
  *
  * @since 2.5.0
  *
@@ -108 +108 @@
         $i++;
 
         $widget_id = $params[0]['widget_id'];
-        $id = isset($params[0]['_temp_id']) ? $params[0]['_temp_id'] : $widget_id;
-        $hidden = isset($params[0]['_hide']) ? ' style="display:none;"' : '';
+        $id        = isset($params[0]['_temp_id']) ? $params[0]['_temp_id'] : $widget_id;
+        $hidden    = isset($params[0]['_hide']) ? ' style="display:none;"' : '';
 
         $params[0]['before_widget'] = "<div id='widget-{$i}_{$id}' class='widget'$hidden>";
-        $params[0]['after_widget'] = "</div>";
-        $params[0]['before_title'] = "%BEG_OF_TITLE%"; // deprecated
-        $params[0]['after_title'] = "%END_OF_TITLE%"; // deprecated
+        $params[0]['after_widget']  = "</div>";
+        $params[0]['before_title']  = "%BEG_OF_TITLE%"; // deprecated
+        $params[0]['after_title']   = "%END_OF_TITLE%"; // deprecated
         if ( is_callable( $wp_registered_widgets[$widget_id]['callback'] ) ) {
                 $wp_registered_widgets[$widget_id]['_callback'] = $wp_registered_widgets[$widget_id]['callback'];
-                $wp_registered_widgets[$widget_id]['callback'] = 'wp_widget_control';
+                $wp_registered_widgets[$widget_id]['callback']  = 'wp_widget_control';
         }
 
         return $params;