Automattic / jetpack

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/autoloader/src/class-plugin-locator.php

Doc Comments +1 added lines, -1 removed lines

@@ -120,7 +120,7 @@
 	 * Inspects the request to determine if this is a Woo plugin actiation request. If it is,
 	 * returns the list of activating plugin slugs.
 	 *
-	 * @return array|false Returns an array of plugin slugs or false if this is not a Woo plugin
+	 * @return string[] Returns an array of plugin slugs or false if this is not a Woo plugin
 	 *                     activation request.
 	 */
 	private function find_activating_plugins_in_woo_request() {