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/class-simplepie.php

Doc Comments +5 added lines, -5 removed lines

@@ -1589,7 +1589,7 @@ 
 	/**
 	 * Get the error message for the occurred error.
 	 *
-	 * @return string|array Error message, or array of messages for multifeeds
+	 * @return string Error message, or array of messages for multifeeds
 	 */
 	public function error()
 	{
@@ -2582,7 +2582,7 @@ 
 	 * @since 1.0
 	 * @link http://www.w3.org/2003/01/geo/ W3C WGS84 Basic Geo
 	 * @link http://www.georss.org/ GeoRSS
-	 * @return string|null
+	 * @return double|null
 	 */
 	public function get_latitude()
 	{
@@ -2611,7 +2611,7 @@ 
 	 * @since 1.0
 	 * @link http://www.w3.org/2003/01/geo/ W3C WGS84 Basic Geo
 	 * @link http://www.georss.org/ GeoRSS
-	 * @return string|null
+	 * @return double|null
 	 */
 	public function get_longitude()
 	{
@@ -2753,7 +2753,7 @@ 
 	 * Uses `<image><width>` or defaults to 88.0 if no width is specified and
 	 * the feed is an RSS 2.0 feed.
 	 *
-	 * @return int|float|null
+	 * @return double|null
 	 */
 	public function get_image_width()
 	{
@@ -2779,7 +2779,7 @@ 
 	 * Uses `<image><height>` or defaults to 31.0 if no height is specified and
 	 * the feed is an RSS 2.0 feed.
 	 *
-	 * @return int|float|null
+	 * @return double|null
 	 */
 	public function get_image_height()
 	{

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/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/SimplePie/Sanitize.php

Doc Comments +16 added lines

@@ -222,6 +222,10 @@ 
 		$this->replace_url_attributes = (array) $element_attribute;
 	}
 
+	/**
+	 * @param string $data
+	 * @param integer $type
+	 */
 	public function sanitize($data, $type, $base = '')
 	{
 		$data = trim($data);
@@ -381,6 +385,9 @@ 
 		return $data;
 	}
 
+	/**
+	 * @param string $html
+	 */
 	protected function preprocess($html, $type)
 	{
 		$ret = '';
@@ -404,6 +411,9 @@ 
 		return $ret;
 	}
 
+	/**
+	 * @param DOMDocument $document
+	 */
 	public function replace_urls($document, $tag, $attributes)
 	{
 		if (!is_array($attributes))
@@ -456,6 +466,9 @@ 
 		}
 	}
 
+	/**
+	 * @param DOMDocument $document
+	 */
 	protected function strip_tag($tag, $document, $type)
 	{
 		$xpath = new DOMXPath($document);
@@ -541,6 +554,9 @@ 
 		}
 	}
 
+	/**
+	 * @param DOMDocument $document
+	 */
 	protected function strip_attr($attrib, $document)
 	{
 		$xpath = new DOMXPath($document);

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-http-requests-response.php

Doc Comments +1 added lines, -1 removed lines

@@ -145,7 +145,7 @@
 	 * @since 4.6.0
 	 * @access public
 	 *
-	 * @return mixed Response data.
+	 * @return string Response data.
 	 */
 	public function get_data() {
 		return $this->response->body;

src/wp-includes/class-wp-image-editor-imagick.php

Doc Comments +2 added lines, -2 removed lines

@@ -292,7 +292,7 @@ 
 	 * @param int    $dst_h       The destination height.
 	 * @param string $filter_name Optional. The Imagick filter to use when resizing. Default 'FILTER_TRIANGLE'.
 	 * @param bool   $strip_meta  Optional. Strip all profiles, excluding color profiles, from the image. Default true.
-	 * @return bool|WP_Error
+	 * @return null|WP_Error
 	 */
 	protected function thumbnail_image( $dst_w, $dst_h, $filter_name = 'FILTER_TRIANGLE', $strip_meta = true ) {
 		$allowed_filters = array(
@@ -745,7 +745,7 @@ 
 	 * @since 4.7.0
 	 * @access protected
 	 *
-	 * @return string|WP_Error File to load or WP_Error on failure.
+	 * @return string File to load or WP_Error on failure.
 	 */
 	protected function pdf_setup() {
 		try {