Changeset 16469

Timestamp:

11/18/2010 07:12:48 PM (14 years ago)

Author:

nacin

Message:

More param fixes, props duck_. see #14783.

Location:

trunk

Files:

• wp-admin/includes/class-wp-list-table.php (modified) (2 diffs)
• wp-admin/includes/plugin-install.php (modified) (1 diff)
• wp-includes/cache.php (modified) (1 diff)
• wp-includes/category-template.php (modified) (1 diff)
• wp-includes/class.wp-dependencies.php (modified) (4 diffs)
• wp-includes/class.wp-scripts.php (modified) (2 diffs)
• wp-includes/formatting.php (modified) (1 diff)
• wp-includes/functions.php (modified) (2 diffs)
• wp-includes/ms-blogs.php (modified) (2 diffs)
• wp-includes/post-template.php (modified) (1 diff)
• wp-includes/post.php (modified) (1 diff)

trunk/wp-admin/includes/class-wp-list-table.php

@@ -738 +738 @@
      * @access protected
      *
-     * @param $object $item The current item
+     * @param object $item The current item
      */
     function single_row( $item ) {
@@ -755 +755 @@
      * @access protected
      *
-     * @param $object $item The current item
+     * @param object $item The current item
      */
     function single_row_columns( $item ) {

trunk/wp-admin/includes/plugin-install.php

@@ -158 +158 @@
  *
  * @since 2.7.0
- *
- * @param array $plugins List of plugins.
- * @param int $total_plugins Number of plugins.
  */
 function display_plugins_table() {

trunk/wp-includes/cache.php

@@ -172 +172 @@
  *
  * @since 2.6.0
- *
- * @param string|array $groups A group or an array of groups to add
  */
 function wp_cache_reset() {

trunk/wp-includes/category-template.php

@@ -1175 +1175 @@
  * @param string|int|array $term Optional. The term name/term_id/slug or array of them to check for.
  * @param string $taxonomy Taxonomy name
- * @param int|post object Optional.  Post to check instead of the current post.
+ * @param int|object $post Optional. Post to check instead of the current post.
  * @return bool True if the current post has any of the given tags (or any tag, if no tag specified).
  */

trunk/wp-includes/class.wp-dependencies.php

@@ -38 +38 @@
      * Process the items passed to it or the queue.  Processes all dependencies.
      *
-     * @param mixed handles (optional) items to be processed.  (void) processes queue, (string) process that item, (array of strings) process those items
+     * @param mixed $handles (optional) items to be processed. (void) processes queue, (string) process that item, (array of strings) process those items
      * @return array Items that have been processed
      */
     function do_items( $handles = false, $group = false ) {
-        // Print the queue if nothing is passed.  If a string is passed, print that script.  If an array is passed, print those scripts.
+        // Print the queue if nothing is passed. If a string is passed, print that script. If an array is passed, print those scripts.
         $handles = false === $handles ? $this->queue : (array) $handles;
         $this->all_deps( $handles );
@@ -73 +73 @@
      * Recursively builds array of items to process taking dependencies into account.  Does NOT catch infinite loops.
      *
-
-     * @param mixed handles Accepts (string) dep name or (array of strings) dep names
-     * @param bool recursion Used internally when function calls itself
+     *
+     * @param mixed $handles Accepts (string) dep name or (array of strings) dep names
+     * @param bool $recursion Used internally when function calls itself
      */
     function all_deps( $handles, $recursion = false, $group = false ) {
@@ -126 +126 @@
      * Adds the item only if no item of that name already exists
      *
-     * @param string handle Script name
-     * @param string src Script url
-     * @param array deps (optional) Array of script names on which this script depends
-     * @param string ver (optional) Script version (used for cache busting)
+     * @param string $handle Script name
+     * @param string $src Script url
+     * @param array $deps (optional) Array of script names on which this script depends
+     * @param string $ver (optional) Script version (used for cache busting)
      * @return array Hierarchical array of dependencies
      */
@@ -144 +144 @@
      * Adds data only if script has already been added
      *
-     * @param string handle Script name
-     * @param string data_name Name of object in which to store extra data
-     * @param array data Array of extra data
+     * @param string $handle Script name
+     * @param string $data_name Name of object in which to store extra data
+     * @param array $data Array of extra data
      * @return bool success
      */

trunk/wp-includes/class.wp-scripts.php

@@ -40 +40 @@
      * Prints the scripts passed to it or the print queue.  Also prints all necessary dependencies.
      *
-     * @param mixed handles (optional) Scripts to be printed.  (void) prints queue, (string) prints that script, (array of strings) prints those scripts.
-     * @param int group (optional) If scripts were queued in groups prints this group number.
+     * @param mixed $handles (optional) Scripts to be printed.  (void) prints queue, (string) prints that script, (array of strings) prints those scripts.
+     * @param int $group (optional) If scripts were queued in groups prints this group number.
      * @return array Scripts that have been printed
      */
@@ -136 +136 @@
      * Localizes only if script has already been added
      *
-     * @param string handle Script name
-     * @param string object_name Name of JS object to hold l10n info
-     * @param array l10n Array of JS var name => localized string
+     * @param string $handle Script name
+     * @param string $object_name Name of JS object to hold l10n info
+     * @param array $l10n Array of JS var name => localized string
      * @return bool Successful localization
      */

trunk/wp-includes/formatting.php

@@ -1578 +1578 @@
  * @since 3.1.0
  * @access private
- * @param $match the preg_replace_callback matches array
+ * @param array $match the preg_replace_callback matches array
  */
 function _wp_iso_convert( $match ) {

trunk/wp-includes/functions.php

@@ -4361 +4361 @@
  *
  * @param callback $callback function that accepts ( ID, $callback_args ) and outputs parent_ID
- * @param $start The ID to start the loop check at
- * @param $start_parent the parent_ID of $start to use instead of calling $callback( $start ).  Use null to always use $callback
+ * @param int $start The ID to start the loop check at
+ * @param int $start_parent the parent_ID of $start to use instead of calling $callback( $start ). Use null to always use $callback
  * @param array $callback_args optional additional arguments to send to $callback
  * @return array IDs of all members of loop
@@ -4385 +4385 @@
  *
  * @param callback $callback function that accupts ( ID, callback_arg, ... ) and outputs parent_ID
- * @param $start The ID to start the loop check at
+ * @param int $start The ID to start the loop check at
  * @param array $override an array of ( ID => parent_ID, ... ) to use instead of $callback
  * @param array $callback_args optional additional arguments to send to $callback

trunk/wp-includes/ms-blogs.php

@@ -665 +665 @@
  * @since MU
  *
- * @param $deprecated Not used
+ * @param mixed $deprecated Not used
  * @param int $start The offset
  * @param int $quantity The maximum number of blogs to retrieve. Default is 40.
@@ -672 +672 @@
 function get_last_updated( $deprecated = '', $start = 0, $quantity = 40 ) {
     global $wpdb;
+    
+    if ( ! empty( $deprecated ) )
+        _deprecated_argument( __FUNCTION__, 'MU' ); // never used
+    
     return $wpdb->get_results( $wpdb->prepare("SELECT blog_id, domain, path FROM $wpdb->blogs WHERE site_id = %d AND public = '1' AND archived = '0' AND mature = '0' AND spam = '0' AND deleted = '0' AND last_updated != '0000-00-00 00:00:00' ORDER BY last_updated DESC limit %d, %d", $wpdb->siteid, $start, $quantity ) , ARRAY_A );
 }

trunk/wp-includes/post-template.php

@@ -676 +676 @@
  * @access private
  *
- * @param $i Page number.
+ * @param int $i Page number.
  * @return string Link.
  */

trunk/wp-includes/post.php

@@ -5043 +5043 @@
  * @since 2.0.0
  *
- * @param string A post type string, defaults to 'post'.
+ * @param string $post_type A post type string, defaults to 'post'.
+ * @param bool $create_in_db If true then also insert an auto-draft into database
  * @return object stdClass object containing all the default post data as attributes
  */