Ticket #31008: 31008.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') {