Automattic / jetpack

projects/packages/changelogger/lib/KeepAChangelogParser.php

Doc Comments +1 added lines

@@ -89,6 +89,7 @@
 	 *
 	 * @param string   $haystack String to split.
 	 * @param string[] ...$needles Strings to split on. Earliest match in $haystack wins.
+	 * @param string $needles
 	 * @return string[] Two elements: The part before $needles and the part after, both trimmed.
 	 */
 	private function split( $haystack, ...$needles ) {

projects/packages/identity-crisis/src/class-identity-crisis.php

Doc Comments +1 added lines, -1 removed lines

@@ -50,7 +50,7 @@
 	/**
 	 * Initializer.
 	 *
-	 * @return object
+	 * @return Identity_Crisis
 	 */
 	public static function init() {
 		if ( is_null( self::$instance ) ) {

projects/packages/connection/src/class-secrets.php

Doc Comments +1 added lines

@@ -43,6 +43,7 @@
 	 * @param String       $action       The action name.
 	 * @param Integer|bool $user_id The user identifier. Defaults to `false`.
 	 * @param Integer      $exp          Expiration time in seconds.
+	 * @return string|boolean
 	 */
 	public function generate( $action, $user_id = false, $exp = 600 ) {
 		if ( false === $user_id ) {

projects/packages/changelogger/src/Plugins/WordpressVersioning.php

Doc Comments +1 added lines, -1 removed lines

@@ -138,7 +138,7 @@
 	 * Extract the index and count from a prerelease string.
 	 *
 	 * @param string|null $s String.
-	 * @return array Two elements: index and count.
+	 * @return integer[] Two elements: index and count.
 	 * @throws InvalidArgumentException If the string is invalid.
 	 */
 	private function parsePrerelease( $s ) {

projects/packages/connection/src/class-manager.php

Doc Comments +2 added lines, -2 removed lines

@@ -290,7 +290,7 @@ 
 	/**
 	 * Verifies the signature of the current request.
 	 *
-	 * @return false|array
+	 * @return boolean
 	 */
 	public function verify_xml_rpc_signature() {
 		if ( is_null( $this->xmlrpc_verification ) ) {
@@ -1464,7 +1464,7 @@ 
 	/**
 	 * Obtains the auth token.
 	 *
-	 * @param array $data The request data.
+	 * @param string $data The request data.
 	 * @return object|\WP_Error Returns the auth token on success.
 	 *                          Returns a \WP_Error on failure.
 	 */

projects/packages/connection/src/class-tokens.php

Doc Comments +2 added lines, -2 removed lines

@@ -219,7 +219,7 @@ 
 	 * @param int    $user_id The user id.
 	 * @param string $token The user token.
 	 * @param bool   $is_master_user Whether the user is the master user.
-	 * @return bool
+	 * @return boolean|null
 	 */
 	public function update_user_token( $user_id, $token, $is_master_user ) {
 		// Not designed for concurrent updates.
@@ -495,7 +495,7 @@ 
 	 * Fetches a signed token.
 	 *
 	 * @param object $token the token.
-	 * @return WP_Error|string a signed token
+	 * @return string a signed token
 	 */
 	public function get_signed_token( $token ) {
 		if ( ! isset( $token->secret ) || empty( $token->secret ) ) {

projects/plugins/jetpack/json-endpoints/jetpack/class.jetpack-json-api-plugins-modify-endpoint.php

Doc Comments +3 added lines

@@ -250,6 +250,9 @@
 		}
 	}
 
+	/**
+	 * @param string $capability
+	 */
 	protected function current_user_can( $capability, $plugin = null ) {
 		// If this endpoint accepts site based authentication and a blog token is used, skip capabilities check.
 		if ( $this->accepts_site_based_authentication() ) {

projects/packages/jitm/src/class-jitm.php

Doc Comments +1 added lines, -1 removed lines

@@ -253,7 +253,7 @@
 	 *
 	 * The list includes an empty string, which is used when no icon should be displayed.
 	 *
-	 * @return array The list of supported icons.
+	 * @return string[] The list of supported icons.
 	 */
 	public function get_supported_icons() {
 		return array(

projects/packages/sync/src/class-functions.php

Doc Comments +3 added lines, -3 removed lines

@@ -186,7 +186,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known constants.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_constant() {
 		$hosting_provider_constants = array(
@@ -214,7 +214,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known classes.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_class() {
 		$hosting_provider = false;
@@ -231,7 +231,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known functions.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_function() {
 		$hosting_provider = false;