ntwb / wordpress

src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php

Doc Comments -1 removed lines

@@ -127,7 +127,6 @@
 	 *
 	 * @since 4.7.2
 	 *
-	 * @param int $id Supplied ID.
 	 * @return WP_Post|WP_Error Post object if ID is valid, WP_Error otherwise.
 	 */
 	protected function get_parent( $parent ) {

src/wp-includes/taxonomy.php

Doc Comments +6 added lines, -6 removed lines

@@ -300,7 +300,7 @@ 
  * @global array $wp_taxonomies Registered taxonomies.
  *
  * @param string       $taxonomy    Taxonomy key, must not exceed 32 characters.
- * @param array|string $object_type Object type or array of object types with which the taxonomy should be associated.
+ * @param string $object_type Object type or array of object types with which the taxonomy should be associated.
  * @param array|string $args        {
  *     Optional. Array or query string of arguments for registering a taxonomy.
  *
@@ -619,8 +619,8 @@ 
  *
  * @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 integer    $term_ids   Term id or array of term ids of terms that will be used.
+ * @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.
@@ -2877,7 +2877,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);
@@ -3973,7 +3973,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.
  *
@@ -4035,7 +4035,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 An array of all taxonomy names for the given post.
  */
 function get_post_taxonomies( $post = 0 ) {

src/wp-includes/theme.php

Doc Comments +1 added lines, -2 removed lines

@@ -1834,7 +1834,7 @@ 
  *
  * @global array $editor_styles
  *
- * @param array|string $stylesheet Optional. Stylesheet name or array thereof, relative to theme root.
+ * @param string[] $stylesheet Optional. Stylesheet name or array thereof, relative to theme root.
  * 	                               Defaults to 'editor-style.css'
  */
 function add_editor_style( $stylesheet = 'editor-style.css' ) {
@@ -2217,7 +2217,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', 'starter-content', 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 ) {

src/wp-includes/widgets.php

Doc Comments +3 added lines, -3 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 ) {
@@ -844,7 +844,7 @@ 
  *
  * @since 2.8.0
  *
- * @param string|int $index Sidebar name, id or number to check.
+ * @param string $index Sidebar name, id or number to check.
  * @return bool true if the sidebar is in use, false otherwise.
  */
 function is_active_sidebar( $index ) {

src/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;
@@ -1284,8 +1284,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 ) {
@@ -1499,7 +1497,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;
@@ -3132,7 +3130,7 @@ 
 	 *
 	 * @since 1.5.0
 	 *
-	 * @return true
+	 * @return boolean
 	 */
 	public function timer_start() {
 		$this->time_start = microtime( true );
@@ -3269,7 +3267,7 @@ 
 	 * @param string $db_cap The feature to check for. Accepts 'collation',
 	 *                       'group_concat', 'subqueries', 'set_charset',
 	 *                       'utf8mb4', or 'utf8mb4_520'.
-	 * @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();

src/wp-admin/includes/class-theme-upgrader.php

Doc Comments +1 added lines, -1 removed lines

@@ -93,7 +93,7 @@
 	 * @param bool  $install_result
 	 * @param array $hook_extra
 	 * @param array $child_result
-	 * @return type
+	 * @return boolean
 	 */
 	public function check_parent_theme_filter( $install_result, $hook_extra, $child_result ) {
 		// Check to see if we need to install a parent theme

src/wp-admin/includes/class-wp-upgrader.php

Doc Comments +1 added lines, -1 removed lines

@@ -183,7 +183,7 @@
 	 *
 	 * @global WP_Filesystem_Base $wp_filesystem Subclass
 	 *
-	 * @param array $directories                  Optional. A list of directories. If any of these do
+	 * @param string[] $directories                  Optional. A list of directories. If any of these do
 	 *                                            not exist, a WP_Error object will be returned.
 	 *                                            Default empty array.
 	 * @param bool  $allow_relaxed_file_ownership Whether to allow relaxed file ownership.

src/wp-includes/class-wp-xmlrpc-server.php

Doc Comments +2 added lines, -4 removed lines

@@ -408,7 +408,6 @@ 
 	 *
 	 * @since 4.9.0
 	 *
-	 * @param int $post_id Post ID.
 	 * @return array Array of custom fields, if they exist.
 	 */
 	public function get_term_custom_fields( $term_id ) {
@@ -437,7 +436,6 @@ 
 	 *
 	 * @since 4.9.0
 	 *
-	 * @param int $post_id Post ID.
 	 * @param array $fields Custom fields.
 	 */
 	public function set_term_custom_fields( $term_id, $fields ) {
@@ -824,7 +822,7 @@ 
 	 * @access protected
 	 *
 	 * @param string $date Date string to convert.
-	 * @return IXR_Date IXR_Date object.
+	 * @return integer IXR_Date object.
 	 */
 	protected function _convert_date( $date ) {
 		if ( $date === '0000-00-00 00:00:00' ) {
@@ -840,7 +838,7 @@ 
 	 *
 	 * @param string $date_gmt WordPress GMT date string.
 	 * @param string $date     Date string.
-	 * @return IXR_Date IXR_Date object.
+	 * @return integer IXR_Date object.
 	 */
 	protected function _convert_date_gmt( $date_gmt, $date ) {
 		if ( $date !== '0000-00-00 00:00:00' && $date_gmt === '0000-00-00 00:00:00' ) {

src/wp-includes/compat.php

Doc Comments +1 added lines, -1 removed lines

@@ -366,7 +366,7 @@
 	 *
 	 * @internal This is a compatibility function for PHP <5.5
 	 *
-	 * @return bool|string Returns the error message on success, "No Error" if no error has occurred,
+	 * @return false|string Returns the error message on success, "No Error" if no error has occurred,
 	 *                     or false on failure.
 	 */
 	function json_last_error_msg() {