staylor / WordPress

wp-includes/rest-api/class-wp-rest-request.php

Doc Comments +2 added lines, -2 removed lines

@@ -478,7 +478,7 @@ 
 	 * @since 4.4.0
 	 * @access public
 	 *
-	 * @param array $params Parameter map of key to value.
+	 * @param string[] $params Parameter map of key to value.
 	 */
 	public function set_url_params( $params ) {
 		$this->params['URL'] = $params;
@@ -780,7 +780,7 @@ 
 	 * @since 4.4.0
 	 * @access public
 	 *
-	 * @return true|null True if there are no parameters to sanitize, null otherwise.
+	 * @return boolean|null True if there are no parameters to sanitize, null otherwise.
 	 */
 	public function sanitize_params() {
 

wp-includes/rest-api/class-wp-rest-server.php

Doc Comments +1 added lines, -1 removed lines

@@ -933,7 +933,7 @@
 	 * @since 4.4.0
 	 * @access protected
 	 *
-	 * @return bool|string Boolean false or string error message.
+	 * @return false|string Boolean false or string error message.
 	 */
 	protected function get_json_last_error() {
 		// See https://core.trac.wordpress.org/ticket/27799.

wp-includes/revision.php

Doc Comments +1 added lines, -1 removed lines

@@ -432,7 +432,7 @@
  *
  * @see get_children()
  *
- * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global `$post`.
+ * @param integer $post_id Optional. Post ID or WP_Post object. Default is global `$post`.
  * @param array|null  $args    Optional. Arguments for retrieving post revisions. Default null.
  * @return array An array of revisions, or an empty array if none.
  */

wp-includes/taxonomy.php

Doc Comments +5 added lines, -5 removed lines

@@ -281,7 +281,7 @@ 
  * @global WP    $wp            WP instance.
  *
  * @param string       $taxonomy    Taxonomy key, must not exceed 32 characters.
- * @param array|string $object_type Name of the object type for the taxonomy object.
+ * @param string $object_type Name of the object type for the taxonomy object.
  * @param array|string $args        {
  *     Optional. Array or query string of arguments for registering a taxonomy.
  *
@@ -720,7 +720,7 @@ 
  * @global wpdb $wpdb WordPress database abstraction object.
  *
  * @param int|array    $term_ids   Term id or array of term ids of terms that will be used.
- * @param string|array $taxonomies String of taxonomy name or Array of string values of taxonomy names.
+ * @param string $taxonomies String of taxonomy name or Array of string values of taxonomy names.
  * @param array|string $args       Change the order of the object_ids, either ASC or DESC.
  * @return WP_Error|array If the taxonomy does not exist, then WP_Error will be returned. On success.
  *	the array can be empty meaning that there are no $object_ids found or it will return the $object_ids found.
@@ -3095,7 +3095,7 @@ 
  *
  * @param array  $terms    The term_taxonomy_id of terms to update.
  * @param string $taxonomy The context of the term.
- * @return true Always true when complete.
+ * @return boolean Always true when complete.
  */
 function wp_update_term_count_now( $terms, $taxonomy ) {
 	$terms = array_map('intval', $terms);
@@ -4182,7 +4182,7 @@ 
  *
  * @since 2.5.0
  *
- * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
+ * @param integer $post Optional. Post ID or WP_Post object. Default is global $post.
  * @param array $args {
  *     Optional. Arguments about how to format the list of taxonomies. Default empty array.
  *
@@ -4244,7 +4244,7 @@ 
  *
  * @since 2.5.0
  *
- * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
+ * @param integer $post Optional. Post ID or WP_Post object. Default is global $post.
  * @return array
  */
 function get_post_taxonomies( $post = 0 ) {

wp-includes/template.php

Doc Comments +1 added lines, -1 removed lines

@@ -17,7 +17,7 @@
  * @since 1.5.0
  *
  * @param string $type      Filename without extension.
- * @param array  $templates An optional list of template candidates
+ * @param string[]  $templates An optional list of template candidates
  * @return string Full path to template file.
  */
 function get_query_template( $type, $templates = array() ) {

wp-includes/theme.php

Doc Comments -1 removed lines

@@ -1531,7 +1531,6 @@
  * @param string $feature  The feature being added. Likely core values include 'post-formats',
  *                         'post-thumbnails', 'html5', 'custom-logo', 'custom-header-uploads',
  *                         'custom-header', 'custom-background', 'title-tag', etc.
- * @param mixed  $args,... Optional extra arguments to pass along with certain features.
  * @return void|bool False on failure, void otherwise.
  */
 function add_theme_support( $feature ) {

wp-includes/user.php

Doc Comments +3 added lines, -3 removed lines

@@ -755,7 +755,7 @@ 
  *
  * @param int    $user_id    User ID.
  * @param string $meta_key   Metadata name.
- * @param mixed  $meta_value Metadata value.
+ * @param string  $meta_value Metadata value.
  * @param bool   $unique     Optional, default is false. Whether the same key should not be added.
  * @return int|false Meta ID on success, false on failure.
  */
@@ -1232,7 +1232,7 @@ 
  * @since 3.0.0
  *
  * @param object|WP_User $user User object to be cached
- * @return bool|null Returns false on failure.
+ * @return false|null Returns false on failure.
  */
 function update_user_caches( $user ) {
 	if ( $user instanceof WP_User ) {
@@ -1255,7 +1255,7 @@ 
  * @since 3.0.0
  * @since 4.4.0 'clean_user_cache' action was added.
  *
- * @param WP_User|int $user User object or ID to be cleaned from the cache
+ * @param WP_User $user User object or ID to be cleaned from the cache
  */
 function clean_user_cache( $user ) {
 	if ( is_numeric( $user ) )

wp-includes/widgets.php

Doc Comments +2 added lines, -2 removed lines

@@ -549,7 +549,7 @@ 
  *
  * @global array $wp_registered_widget_controls
  *
- * @param int|string $id            Widget ID.
+ * @param boolean|string $id            Widget ID.
  * @param string     $name          Name attribute for the widget.
  * @param callable   $form_callback Form callback.
  * @param array      $options       Optional. Widget control options. See wp_register_widget_control().
@@ -607,7 +607,7 @@ 
  * @global array $wp_registered_sidebars
  * @global array $wp_registered_widgets
  *
- * @param int|string $index Optional, default is 1. Index, name or ID of dynamic sidebar.
+ * @param integer $index Optional, default is 1. Index, name or ID of dynamic sidebar.
  * @return bool True, if widget sidebar was found and called. False if not found or not called.
  */
 function dynamic_sidebar( $index = 1 ) {

wp-includes/wp-db.php

Doc Comments +4 added lines, -6 removed lines

@@ -663,7 +663,7 @@ 
 	 *
 	 * @see wpdb::__construct()
 	 * @since 2.0.8
-	 * @return true
+	 * @return boolean
 	 */
 	public function __destruct() {
 		return true;
@@ -1268,8 +1268,6 @@ 
 	 * @param array|mixed $args     The array of variables to substitute into the query's placeholders if being called like
 	 *                              {@link https://secure.php.net/vsprintf vsprintf()}, or the first variable to substitute into the query's placeholders if
 	 *                              being called like {@link https://secure.php.net/sprintf sprintf()}.
-	 * @param mixed       $args,... further variables to substitute into the query's placeholders if being called like
-	 *                              {@link https://secure.php.net/sprintf sprintf()}.
 	 * @return string|void Sanitized query string, if there is a query to prepare.
 	 */
 	public function prepare( $query, $args ) {
@@ -1480,7 +1478,7 @@ 
 	 * @since 3.9.0 $allow_bail parameter added.
 	 *
 	 * @param bool $allow_bail Optional. Allows the function to bail. Default true.
-	 * @return bool True with a successful connection, false on failure.
+	 * @return boolean|null True with a successful connection, false on failure.
 	 */
 	public function db_connect( $allow_bail = true ) {
 		$this->is_mysql = true;
@@ -3109,7 +3107,7 @@ 
 	 *
 	 * @since 1.5.0
 	 *
-	 * @return true
+	 * @return boolean
 	 */
 	public function timer_start() {
 		$this->time_start = microtime( true );
@@ -3244,7 +3242,7 @@ 
 	 * @param string $db_cap The feature to check for. Accepts 'collation',
 	 *                       'group_concat', 'subqueries', 'set_charset',
 	 *                       or 'utf8mb4'.
-	 * @return int|false Whether the database feature is supported, false otherwise.
+	 * @return boolean Whether the database feature is supported, false otherwise.
 	 */
 	public function has_cap( $db_cap ) {
 		$version = $this->db_version();