ntwb / wordpress

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

Doc Comments -2 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 ) {

src/wp-includes/general-template.php

Doc Comments +2 added lines, -2 removed lines

@@ -3262,7 +3262,7 @@ 
  *     @type string $before_page_number A string to appear before the page number. Default empty.
  *     @type string $after_page_number  A string to append after the page number. Default empty.
  * }
- * @return array|string|void String of page links or array of page links.
+ * @return string String of page links or array of page links.
  */
 function paginate_links( $args = '' ) {
 	global $wp_query, $wp_rewrite;
@@ -3423,7 +3423,7 @@ 
  * @param string $key    The unique key for this theme.
  * @param string $name   The name of the theme.
  * @param string $url    The URL of the CSS file containing the color scheme.
- * @param array  $colors Optional. An array of CSS color definition strings which are used
+ * @param string[]  $colors Optional. An array of CSS color definition strings which are used
  *                       to give the user a feel for the theme.
  * @param array  $icons {
  *     Optional. CSS color definitions used to color any SVG icons.

src/wp-includes/media.php

Doc Comments +8 added lines, -8 removed lines

@@ -327,7 +327,7 @@ 
  *
  * @param int        $width  Image width in pixels.
  * @param int        $height Image height in pixels.
- * @param bool|array $crop   Optional. Whether to crop images to specified width and height or resize.
+ * @param boolean $crop   Optional. Whether to crop images to specified width and height or resize.
  *                           An array can specify positioning of the crop area. Default false.
  */
 function set_post_thumbnail_size( $width = 0, $height = 0, $crop = false ) {
@@ -1010,7 +1010,7 @@ 
  *                                    width and height values in pixels (in that order). Default 'medium'.
  * @param array        $image_meta    Optional. The image meta data as returned by 'wp_get_attachment_metadata()'.
  *                                    Default null.
- * @return string|bool A 'srcset' value string or false.
+ * @return false|string A 'srcset' value string or false.
  */
 function wp_get_attachment_image_srcset( $attachment_id, $size = 'medium', $image_meta = null ) {
 	if ( ! $image = wp_get_attachment_image_src( $attachment_id, $size ) ) {
@@ -1039,7 +1039,7 @@ 
  * @param string $image_src     The 'src' of the image.
  * @param array  $image_meta    The image meta data as returned by 'wp_get_attachment_metadata()'.
  * @param int    $attachment_id Optional. The image attachment ID to pass to the filter. Default 0.
- * @return string|bool          The 'srcset' attribute value. False on error or when only one source exists.
+ * @return false|string          The 'srcset' attribute value. False on error or when only one source exists.
  */
 function wp_calculate_image_srcset( $size_array, $image_src, $image_meta, $attachment_id = 0 ) {
 	/**
@@ -3662,7 +3662,7 @@ 
  * @since 3.6.0
  *
  * @param string      $type Mime type.
- * @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 Found attachments.
  */
 function get_attached_media( $type, $post = 0 ) {
@@ -3815,7 +3815,7 @@ 
  *
  * @since 3.6.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 bool        $html Optional. Whether to return HTML or data. Default is true.
  * @return string|array Gallery data and srcs parsed from the expanded shortcode.
  */
@@ -3842,7 +3842,7 @@ 
  *
  * @see get_post_galleries()
  *
- * @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 A list of lists, each containing image srcs parsed.
  *               from an expanded shortcode
  */
@@ -3858,7 +3858,7 @@ 
  *
  * @see get_post_gallery()
  *
- * @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 A list of a gallery's image srcs in order.
  */
 function get_post_gallery_images( $post = 0 ) {
@@ -3941,7 +3941,7 @@ 
  *
  * @since 4.0.0
  *
- * @return array The relevant CSS file URLs.
+ * @return string[] The relevant CSS file URLs.
  */
 function wpview_media_sandbox_styles() {
  	$version = 'ver=' . get_bloginfo( 'version' );

src/wp-includes/ms-load.php

Doc Comments +1 added lines, -1 removed lines

@@ -65,7 +65,7 @@
  *
  * @since 3.0.0
  *
- * @return true|string Returns true on success, or drop-in file to include.
+ * @return boolean|string Returns true on success, or drop-in file to include.
  */
 function ms_site_check() {
 

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/rss.php

Doc Comments +13 added lines, -4 removed lines

@@ -407,7 +407,7 @@ 
  * @subpackage MagpieRSS
  *
  * @param string $url URL to retrieve feed
- * @return bool|MagpieRSS false on failure or MagpieRSS object on success.
+ * @return integer|null false on failure or MagpieRSS object on success.
  */
 function fetch_rss ($url) {
 	// initialize constants
@@ -545,7 +545,7 @@ 
  *
  * @param string $url URL to retrieve
  * @param array $headers Optional. Headers to send to the URL.
- * @return Snoopy style response
+ * @return stdClass style response
  */
 function _fetch_remote_file($url, $headers = "" ) {
 	$resp = wp_safe_remote_request( $url, array( 'headers' => $headers, 'timeout' => MAGPIE_FETCH_TIME_OUT ) );
@@ -587,7 +587,7 @@ 
  * @package External
  * @subpackage MagpieRSS
  *
- * @param array $resp
+ * @param stdClass $resp
  * @return MagpieRSS|bool
  */
 function _response_to_rss ($resp) {
@@ -744,6 +744,9 @@ 
 	Input:		url from which the rss file was fetched
 	Output:		true on success
 \*=======================================================================*/
+	/**
+	 * @param string $url
+	 */
 	function set ($url, $rss) {
 		$cache_option = 'rss_' . $this->file_name( $url );
 
@@ -758,6 +761,9 @@ 
 	Input:		url from which the rss file was fetched
 	Output:		cached object on HIT, false on MISS
 \*=======================================================================*/
+	/**
+	 * @param string $url
+	 */
 	function get ($url) {
 		$this->ERROR = "";
 		$cache_option = 'rss_' . $this->file_name( $url );
@@ -779,6 +785,9 @@ 
 	Input:		url from which the rss file was fetched
 	Output:		cached object on HIT, false on MISS
 \*=======================================================================*/
+	/**
+	 * @param string $url
+	 */
 	function check_cache ( $url ) {
 		$this->ERROR = "";
 		$cache_option = 'rss_' . $this->file_name( $url );
@@ -934,7 +943,7 @@ 
  *
  * @param string $url URL of feed to display. Will not auto sense feed URL.
  * @param int $num_items Optional. Number of items to display, default is all.
- * @return bool False on failure.
+ * @return null|false False on failure.
  */
 function get_rss ($url, $num_items = 5) { // Like get posts, but for RSS
 	$rss = fetch_rss($url);

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();