ntwb / wordpress

src/wp-admin/includes/class-wp-filesystem-ssh2.php

Doc Comments +3 added lines, -3 removed lines

@@ -263,7 +263,7 @@ 
 	/**
 	 * @access public
 	 *
-	 * @return bool
+	 * @return string
 	 */
 	public function cwd() {
 		$cwd = ssh2_sftp_realpath( $this->sftp_link, '.' );
@@ -290,7 +290,7 @@ 
 	 * @param string $group
 	 * @param bool   $recursive
 	 *
-	 * @return bool
+	 * @return boolean|string
 	 */
 	public function chgrp($file, $group, $recursive = false ) {
 		if ( ! $this->exists($file) )
@@ -334,7 +334,7 @@ 
 	 * @param string     $file      Path to the file.
 	 * @param string|int $owner     A user name or number.
 	 * @param bool       $recursive Optional. If set True changes file owner recursivly. Default False.
-	 * @return bool True on success or false on failure.
+	 * @return boolean|string True on success or false on failure.
 	 */
 	public function chown( $file, $owner, $recursive = false ) {
 		if ( ! $this->exists($file) )

src/wp-includes/date.php

Doc Comments +1 added lines, -1 removed lines

@@ -804,7 +804,7 @@
 	 *
 	 * @param string $compare The compare operator to use
 	 * @param string|array $value The value
-	 * @return string|false|int The value to be used in SQL or false on error.
+	 * @return string The value to be used in SQL or false on error.
 	 */
 	public function build_value( $compare, $value ) {
 		if ( ! isset( $value ) )

src/wp-includes/formatting.php

Doc Comments +3 added lines, -4 removed lines

@@ -879,7 +879,7 @@ 
  * @staticvar string $_charset
  *
  * @param string     $string         The text which is to be encoded.
- * @param int|string $quote_style    Optional. Converts double quotes if set to ENT_COMPAT,
+ * @param integer $quote_style    Optional. Converts double quotes if set to ENT_COMPAT,
  *                                   both single and double if set to ENT_QUOTES or none if set to ENT_NOQUOTES.
  *                                   Also compatible with old values; converting single quotes if set to 'single',
  *                                   double if set to 'double' or both if otherwise set.
@@ -952,7 +952,7 @@ 
  * @since 2.8.0
  *
  * @param string     $string The text which is to be decoded.
- * @param string|int $quote_style Optional. Converts double quotes if set to ENT_COMPAT,
+ * @param integer $quote_style Optional. Converts double quotes if set to ENT_COMPAT,
  *                                both single and double if set to ENT_QUOTES or
  *                                none if set to ENT_NOQUOTES.
  *                                Also compatible with old _wp_specialchars() values;
@@ -3692,7 +3692,7 @@ 
  * @since 2.8.1
  * @access private
  *
- * @param string|array $search  The value being searched for, otherwise known as the needle.
+ * @param string[] $search  The value being searched for, otherwise known as the needle.
  *                              An array may be used to designate multiple needles.
  * @param string       $subject The string being searched and replaced on, otherwise known as the haystack.
  * @return string The string with the replaced svalues.
@@ -4358,7 +4358,6 @@ 
  * @link https://secure.php.net/sprintf
  *
  * @param string $pattern   The string which formatted args are inserted.
- * @param mixed  $args ,... Arguments to be formatted into the $pattern string.
  * @return string The formatted string.
  */
 function wp_sprintf( $pattern ) {

src/wp-includes/functions.php

Doc Comments +8 added lines, -11 removed lines

@@ -55,7 +55,7 @@ 
  *
  * @param string   $type Type of time to retrieve. Accepts 'mysql', 'timestamp', or PHP date
  *                       format string (e.g. 'Y-m-d').
- * @param int|bool $gmt  Optional. Whether to use GMT timezone. Default false.
+ * @param integer $gmt  Optional. Whether to use GMT timezone. Default false.
  * @return int|string Integer if $type is 'timestamp', string otherwise.
  */
 function current_time( $type, $gmt = 0 ) {
@@ -436,7 +436,7 @@ 
  * @since 2.0.5
  *
  * @param string|array|object $data Data that might be serialized.
- * @return mixed A scalar data
+ * @return string A scalar data
  */
 function maybe_serialize( $data ) {
 	if ( is_array( $data ) || is_object( $data ) )
@@ -771,9 +771,6 @@ 
  *
  * @since 1.5.0
  *
- * @param string|array $key   Either a query variable key, or an associative array of query variables.
- * @param string       $value Optional. Either a query variable value, or a URL to act upon.
- * @param string       $url   Optional. A URL to act upon.
  * @return string New URL query string (unescaped).
  */
 function add_query_arg() {
@@ -1428,7 +1425,7 @@ 
  * @since 2.0.4
  *
  * @param string     $actionurl URL to add nonce action.
- * @param int|string $action    Optional. Nonce action name. Default -1.
+ * @param integer $action    Optional. Nonce action name. Default -1.
  * @param string     $name      Optional. Nonce name. Default '_wpnonce'.
  * @return string Escaped URL with nonce action added.
  */
@@ -1457,7 +1454,7 @@ 
  *
  * @since 2.0.4
  *
- * @param int|string $action  Optional. Action name. Default -1.
+ * @param integer $action  Optional. Action name. Default -1.
  * @param string     $name    Optional. Nonce name. Default '_wpnonce'.
  * @param bool       $referer Optional. Whether to set the referer field for validation. Default true.
  * @param bool       $echo    Optional. Whether to display or return hidden form field. Default true.
@@ -1549,7 +1546,7 @@ 
  *
  * @since 4.5.0
  *
- * @return string|false Referer URL on success, false on failure.
+ * @return string Referer URL on success, false on failure.
  */
 function wp_get_raw_referer() {
 	if ( ! empty( $_REQUEST['_wp_http_referer'] ) ) {
@@ -1861,7 +1858,7 @@ 
  * @param bool   $create_dir Optional. Whether to check and create the uploads directory.
  *                           Default true for backward compatibility.
  * @param bool   $refresh_cache Optional. Whether to refresh the cache. Default false.
- * @return array See above for description.
+ * @return callable|null See above for description.
  */
 function wp_upload_dir( $time = null, $create_dir = true, $refresh_cache = false ) {
 	static $cache = array(), $tested_paths = array();
@@ -4692,7 +4689,7 @@ 
  *
  * @see __return_false()
  *
- * @return true True.
+ * @return boolean True.
  */
 function __return_true() {
 	return true;
@@ -4814,7 +4811,7 @@ 
  * @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.
+ * @param string[]    $callback_args Optional. Additional arguments to send to $callback.
  * @return array IDs of all members of loop.
  */
 function wp_find_hierarchy_loop( $callback, $start, $start_parent, $callback_args = array() ) {

src/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.
  */

src/wp-includes/category-template.php

Doc Comments +1 added lines, -1 removed lines

@@ -723,7 +723,7 @@
  * @since 2.9.0
  *
  * @param int $count Number of posts with that tag.
- * @return int Scaled count.
+ * @return double Scaled count.
  */
 function default_topic_count_scale( $count ) {
 	return round(log10($count + 1) * 100);

src/wp-includes/class-wp-customize-manager.php

Doc Comments +5 added lines, -5 removed lines

@@ -400,8 +400,8 @@ 
 	 *
 	 * @since 3.4.0
 	 *
-	 * @param mixed $ajax_message Ajax return
-	 * @param mixed $message UI message
+	 * @param integer $ajax_message Ajax return
+	 * @param string $message UI message
 	 */
 	protected function wp_die( $ajax_message, $message = null ) {
 		if ( $this->doing_ajax() ) {
@@ -444,7 +444,7 @@ 
 	 * @since 3.4.0
 	 * @deprecated 4.7.0
 	 *
-	 * @return callable Die handler.
+	 * @return string Die handler.
 	 */
 	public function wp_die_handler() {
 		_deprecated_function( __METHOD__, '4.7.0' );
@@ -4275,7 +4275,7 @@ 
 	 *
 	 * @param WP_Error $validity
 	 * @param mixed $value
-	 * @return mixed
+	 * @return WP_Error
 	 */
 	public function _validate_header_video( $validity, $value ) {
 		$video = get_attached_file( absint( $value ) );
@@ -4307,7 +4307,7 @@ 
 	 *
 	 * @param WP_Error $validity
 	 * @param mixed $value
-	 * @return mixed
+	 * @return WP_Error
 	 */
 	public function _validate_external_header_video( $validity, $value ) {
 		$video = esc_url_raw( $value );

src/wp-includes/class-wp-feed-cache-transient.php

Doc Comments +2 added lines, -2 removed lines

@@ -98,7 +98,7 @@ 
 	 * @access public
 	 *
 	 * @param SimplePie $data Data to save.
-	 * @return true Always true.
+	 * @return boolean Always true.
 	 */
 	public function save($data) {
 		if ( $data instanceof SimplePie ) {
@@ -152,7 +152,7 @@ 
 	 * @since 2.8.0
 	 * @access public
 	 *
-	 * @return true Always true.
+	 * @return boolean Always true.
 	 */
 	public function unlink() {
 		delete_transient($this->name);

src/wp-includes/class-wp-hook.php

Doc Comments +2 added lines, -2 removed lines

@@ -101,7 +101,7 @@ 
 	 * @since 4.7.0
 	 * @access private
 	 *
-	 * @param bool|int $new_priority     Optional. The priority of the new filter being added. Default false,
+	 * @param integer $new_priority     Optional. The priority of the new filter being added. Default false,
 	 *                                   for no priority being added.
 	 * @param bool     $priority_existed Optional. Flag for whether the priority already existed before the new
 	 *                                   filter was added. Default false.
@@ -269,7 +269,7 @@ 
 	 * @since 4.7.0
 	 * @access public
 	 *
-	 * @param mixed $value The value to filter.
+	 * @param string $value The value to filter.
 	 * @param array $args  Arguments to pass to callbacks.
 	 * @return mixed The filtered value after all hooked functions are applied to it.
 	 */