ntwb / wordpress

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

Doc Comments +1 added lines, -1 removed lines

@@ -193,7 +193,7 @@
 	 *
 	 * @param string $name    Post value.
 	 * @param mixed  $default Default post value.
-	 * @return mixed Unslashed post value or default value.
+	 * @return string Unslashed post value or default value.
 	 */
 	protected function get_post_value( $name, $default = null ) {
 		if ( ! isset( $_POST[ $name ] ) ) {

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

Doc Comments +1 added lines, -1 removed lines

@@ -205,7 +205,7 @@
 	 * @global wpdb $wpdb WordPress database abstraction object.
 	 *
 	 * @param int $post_id Post ID.
-	 * @return WP_Post|false Post object, false otherwise.
+	 * @return string Post object, false otherwise.
 	 */
 	public static function get_instance( $post_id ) {
 		global $wpdb;

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

Doc Comments +1 added lines, -6 removed lines

@@ -111,7 +111,7 @@ 
 	 *
 	 * @global wpdb $wpdb WordPress database abstraction object.
 	 *
-	 * @param int|string|stdClass|WP_User $id User's ID, a WP_User object, or a user object from the DB.
+	 * @param integer $id User's ID, a WP_User object, or a user object from the DB.
 	 * @param string $name Optional. User's username
 	 * @param int $blog_id Optional Site ID, defaults to current site.
 	 */
@@ -702,11 +702,6 @@ 
 	 * @see map_meta_cap()
 	 *
 	 * @param string $cap           Capability name.
-	 * @param int    $object_id,... Optional. ID of the specific object to check against if `$cap` is a "meta" cap.
-	 *                              "Meta" capabilities, e.g. 'edit_post', 'edit_user', etc., are capabilities used
-	 *                              by map_meta_cap() to map to other "primitive" capabilities, e.g. 'edit_posts',
-	 *                              'edit_others_posts', etc. The parameter is accessed via func_get_args() and passed
-	 *                              to map_meta_cap().
 	 * @return bool Whether the current user has the given capability. If `$cap` is a meta cap and `$object_id` is
 	 *              passed, whether the current user has the given meta capability for the given object.
 	 */

src/wp-includes/compat.php

Doc Comments +5 added lines, -1 removed lines

@@ -8,6 +8,10 @@ 
 
 // If gettext isn't available
 if ( !function_exists('_') ) {
+
+	/**
+	 * @param string $string
+	 */
 	function _($string) {
 		return $string;
 	}
@@ -366,7 +370,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() {

src/wp-includes/customize/class-wp-customize-selective-refresh.php

Doc Comments +2 added lines, -2 removed lines

@@ -78,7 +78,7 @@ 
 	 * @since 4.5.0
 	 * @access public
 	 *
-	 * @return array Partials.
+	 * @return WP_Customize_Partial[] Partials.
 	 */
 	public function partials() {
 		return $this->partials;
@@ -283,7 +283,7 @@ 
 	 * @param string $errstr  Error string.
 	 * @param string $errfile Error file.
 	 * @param string $errline Error line.
-	 * @return true Always true.
+	 * @return boolean Always true.
 	 */
 	public function handle_error( $errno, $errstr, $errfile = null, $errline = null ) {
 		$this->triggered_errors[] = array(

src/wp-includes/pomo/po.php

Doc Comments +7 added lines, -2 removed lines

@@ -87,6 +87,7 @@ 
 	 * Text to include as a comment before the start of the PO contents
 	 *
 	 * Doesn't need to include # in the beginning of lines, these are added automatically
+	 * @param string $text
 	 */
 	function set_comment_before_headers( $text ) {
 		$this->comments_before_headers = $text;
@@ -196,6 +197,7 @@ 
 	 *
 	 * @static
 	 * @param Translation_Entry &$entry the entry to convert to po string
+	 * @param Translation_Entry $entry
 	 * @return false|string PO-style formatted string for the entry or
 	 * 	false if the entry is empty
 	 */
@@ -223,6 +225,9 @@ 
 		return implode("\n", $po);
 	}
 
+	/**
+	 * @return string
+	 */
 	public static function match_begin_and_end_newlines( $translation, $original ) {
 		if ( '' === $translation ) {
 			return $translation;
@@ -395,7 +400,7 @@ 
 	 *
 	 * @param     resource $f
 	 * @param     string   $action
-	 * @return boolean
+	 * @return boolean|string
 	 */
 	function read_line($f, $action = 'read') {
 		static $last_line = '';
@@ -435,7 +440,7 @@ 
 
 	/**
 	 * @param string $s
-	 * @return sring
+	 * @return string
 	 */
 	public static function trim_quotes($s) {
 		if ( substr($s, 0, 1) == '"') $s = substr($s, 1);

src/wp-includes/post-thumbnail-template.php

Doc Comments +1 added lines, -1 removed lines

@@ -53,7 +53,7 @@
  *
  * @see get_the_post_thumbnail()
  *
- * @param string|array $size Optional. Image size to use. Accepts any valid image size, or
+ * @param string $size Optional. Image size to use. Accepts any valid image size, or
  *                           an array of width and height values in pixels (in that order).
  *                           Default 'post-thumbnail'.
  * @param string|array $attr Optional. Query string or array of attributes. Default empty.

src/wp-includes/random_compat/random.php

Doc Comments +1 added lines

@@ -199,6 +199,7 @@
             /**
              * We don't have any more options, so let's throw an exception right now
              * and hope the developer won't let it fail silently.
+             * @param integer $length
              */
             function random_bytes($length)
             {

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

Doc Comments +1 added lines, -1 removed lines

@@ -907,7 +907,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.