Automattic / jetpack

modules/protect/math-fallback.php

Doc Comments +1 added lines, -1 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
 		 */

modules/publicize.php

Doc Comments +6 added lines

@@ -266,6 +266,9 @@ 
 		return trim( preg_replace( '#<p>\s*</p>#i', '', $new_string ) );
 	}
 
+	/**
+	 * @return integer
+	 */
 	function remove_innermost_last_child( $node, &$node_removed_from ) {
 		$node_removed_from = $node;
 
@@ -308,6 +311,9 @@ 
 		return str_replace( $search, $replace, $string );
 	}
 
+	/**
+	 * @param string $message
+	 */
 	public static function sanitize_message( $message ) {
 		$message = preg_replace( '@<(script|style)[^>]*?>.*?</\\1>@si', '', $message );
 		$message = wp_kses( $message, array() );

modules/publicize/publicize-jetpack.php

Doc Comments +6 added lines

@@ -328,6 +328,9 @@ 
 		), menu_page_url( 'sharing', false ) );
 	}
 
+	/**
+	 * @param string $filter
+	 */
 	function get_services( $filter ) {
 		if ( !in_array( $filter, array( 'all', 'connected' ) ) )
 			$filter = 'all';
@@ -663,6 +666,9 @@ 
 	function options_save_path() { $this->options_save_other( 'path' ); }
 	function options_save_google_plus() { $this->options_save_other( 'google_plus' ); }
 
+	/**
+	 * @param string $service_name
+	 */
 	function options_save_other( $service_name ) {
 		// Nonce check
 		check_admin_referer( 'save_' . $service_name . '_token_' . $_REQUEST['connection'] );

modules/publicize/ui.php

Doc Comments +3 added lines

@@ -261,6 +261,9 @@
 		</div><?php
 	}
 
+	/**
+	 * @param string $service_name
+	 */
 	public static function options_page_other( $service_name ) {
 		// Nonce check
 		check_admin_referer( "options_page_{$service_name}_" . $_REQUEST['connection'] );

modules/related-posts/jetpack-related-posts.php

Doc Comments +2 added lines

@@ -1220,6 +1220,8 @@
 	 * Enqueues assets needed to do async loading of related posts.
 	 *
 	 * @uses wp_enqueue_script, wp_enqueue_style, plugins_url
+	 * @param boolean $script
+	 * @param boolean $style
 	 * @return null
 	 */
 	protected function _enqueue_assets( $script, $style ) {

modules/sharedaddy/sharing-service.php

Doc Comments +3 added lines

@@ -427,6 +427,9 @@
 	public $service	= '';
 	public $total 		= 0;
 
+	/**
+	 * @param integer $total
+	 */
 	public function __construct( $id, $total ) {
 		$services 		= new Sharing_Service();
 		$this->id 		= esc_html( $id );

modules/shortcodes/slideshow.php

Doc Comments +3 added lines

@@ -82,6 +82,9 @@
 		$this->settings_select( 'jetpack_slideshow_background_color', $options );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function settings_select( $name, $values, $extra_text = '' ) {
 		if ( empty( $name ) || empty( $values ) || ! is_array( $values ) ) {
 			return;

modules/shortcodes/soundcloud.php

Doc Comments +1 added lines, -1 removed lines

@@ -129,7 +129,7 @@
 
 /**
  * Plugin options getter
- * @param  {string|array}  $option   Option name
+ * @param  string  $option   Option name
  * @param  {mixed}         $default  Default value
  * @return {mixed}                   Option value
  */

modules/site-icon/jetpack-site-icon.php

Doc Comments +1 added lines, -2 removed lines

@@ -592,7 +592,7 @@ 
 	 *
 	 * @param $id
 	 *
-	 * @return mixed
+	 * @return boolean
 	 */
 	public static function delete_site_icon( $id ) {
 		// We add the filter to make sure that we also delete all the added images
@@ -715,7 +715,6 @@ 
 	 * Save Blavatar files to Media Library
 	 *
 	 * @param  string  	$title
-	 * @param  string  	$filename
 	 * @param  string  	$file_type
 	 * @param  boolean 	$generate_meta
 	 * @return int 		$attactment_id