Automattic / jetpack

modules/sitemaps/sitemap-buffer.php

Doc Comments +2 added lines, -2 removed lines

@@ -154,7 +154,7 @@ 
 	 *
 	 * @since 5.3.0
 	 *
-	 * @param array $array The item to be added.
+	 * @param string $array The item to be added.
 	 *
 	 * @return bool True if the append succeeded, False if not.
 	 */
@@ -283,7 +283,7 @@ 
 	 * @param DOMElement  $parent (optional) an element to which new children should be added.
 	 * @param DOMDocument $root (optional) the parent document.
 	 *
-	 * @return string|DOMDocument The rendered XML string or an object if root element is specified.
+	 * @return null|DOMNode The rendered XML string or an object if root element is specified.
 	 */
 	protected function array_to_xml_string( $array, $parent = null, $root = null ) {
 		$return_string = false;

_inc/lib/class.jetpack-keyring-service-helper.php

Doc Comments +8 added lines

@@ -100,6 +100,10 @@ 
 		), menu_page_url( 'sharing', false ) );
 	}
 
+	/**
+	 * @param string $service_name
+	 * @param string $for
+	 */
 	static function refresh_url( $service_name, $for ) {
 		return add_query_arg( array(
 			'action'   => 'request',
@@ -111,6 +115,10 @@ 
 		), admin_url( 'options-general.php?page=sharing' ) );
 	}
 
+	/**
+	 * @param string $service_name
+	 * @param string $id
+	 */
 	static function disconnect_url( $service_name, $id ) {
 		return add_query_arg( array(
 			'action'   => 'delete',

modules/protect/math-fallback.php

Doc Comments +2 added lines, -2 removed lines

@@ -26,7 +26,7 @@ 
 		/**
 		 * Verifies that a user answered the math problem correctly while logging in.
 		 *
-		 * @return bool Returns true if the math is correct
+		 * @return boolean|null Returns true if the math is correct
 		 * @throws Error if insuffient $_POST variables are present.
 		 * @throws Error message if the math is wrong
 		 */
@@ -109,7 +109,7 @@ 
 		/**
 		 * Requires a user to solve a simple equation. Added to any WordPress login form.
 		 *
-		 * @return VOID outputs html
+		 * @return string|null outputs html
 		 */
 		static function math_form() {
 			// Check if jpp_math_pass cookie is set and it matches valid transient

modules/publicize/ui.php

Doc Comments +1 added lines, -1 removed lines

@@ -415,7 +415,7 @@
 	 *
 	 * @param array $connections_data
 	 *
-	 * @return array {
+	 * @return string {
 	 *     Array of content for generating connection form.
 	 *
 	 *     @type string HTML content of form

class.photon.php

Doc Comments +1 added lines, -2 removed lines

@@ -213,7 +213,6 @@ 
 	/**
 	 * Inject image sizes to Jetpack REST API responses. This wraps the filter_photon_norezise_maybe_inject_sizes function.
 	 *
-	 * @param array $data          Attachment sizes data.
 	 * @param int   $attachment_id Attachment's post ID.
 	 *
 	 * @return array Attachment sizes array.
@@ -1257,7 +1256,7 @@ 
 	 * after ourselves without breaking anyone else's filters.
 	 *
 	 * @internal
-	 * @return true
+	 * @return boolean
 	 */
 	public function _override_image_downsize_in_rest_edit_context() {
 		return true;

modules/publicize/publicize-jetpack.php

Doc Comments +3 added lines

@@ -682,6 +682,9 @@
 		$this->options_save_other( 'linkedin' );
 	}
 
+	/**
+	 * @param string $service_name
+	 */
 	function options_save_other( $service_name ) {
 		// Nonce check
 		check_admin_referer( 'save_' . $service_name . '_token_' . $_REQUEST['connection'] );

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

Doc Comments +3 added lines

@@ -244,6 +244,9 @@
 		}
 	}
 
+	/**
+	 * @param string $capability
+	 */
 	protected function current_user_can( $capability, $plugin = null ) {
 		if ( $plugin ) {
 			return current_user_can( $capability, $plugin );

modules/plugin-search.php

Doc Comments +1 added lines

@@ -543,6 +543,7 @@
  * @internal
  *
  * @param bool &$error Did the remote request result in an error?
+ * @param boolean $error
  * @return bool True if PSH is active.
  */
 function jetpack_get_remote_is_psh_active( &$error ) {

_inc/lib/class.jetpack-password-checker.php

Doc Comments +1 added lines, -1 removed lines

@@ -410,7 +410,7 @@
 	 *
 	 * @param Mixed $needle the needle.
 	 * @param Array $haystack the haystack.
-	 * @return is the needle not in the haystack?
+	 * @return boolean the needle not in the haystack?
 	 */
 	protected function negative_in_array( $needle, $haystack ) {
 		if ( in_array( $needle, $haystack, true ) ) {