Automattic / jetpack

modules/infinite-scroll/infinity.php

Doc Comments +1 added lines, -1 removed lines

@@ -1283,7 +1283,7 @@
 	 * Returns an array of stock and custom taxonomy query vars
 	 *
 	 * @global $wp_taxonomies
-	 * @return array
+	 * @return string[]
 	 */
 	function get_taxonomy_vars() {
 		global $wp_taxonomies;

modules/latex.php

Doc Comments +3 added lines

@@ -58,6 +58,9 @@
 	return latex_render( $latex, $fg, $bg, $s );
 }
 
+/**
+ * @param string $color
+ */
 function latex_get_default_color( $color, $default_color = 'ffffff' ) {
 	global $themecolors;
 	return isset($themecolors[$color]) ? $themecolors[$color] : $default_color;

modules/likes.php

Doc Comments +3 added lines

@@ -332,6 +332,9 @@
 <?php
 	}
 
+	/**
+	 * @param string $option
+	 */
 	function admin_likes_get_option( $option ) {
 		if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
 			$option_setting = get_blog_option( get_current_blog_id(), $option, 'on' );

modules/markdown/easy-markdown.php

Doc Comments +3 added lines

@@ -504,6 +504,9 @@
 		) );
 	}
 
+	/**
+	 * @param string $content
+	 */
 	protected function comment_hash( $content ) {
 		return 'c-' . substr( md5( $content ), 0, 8 );
 	}

modules/notes.php

Doc Comments +3 added lines

@@ -48,6 +48,9 @@
 		add_action( 'init', array( &$this, 'action_init' ) );
 	}
 
+	/**
+	 * @param string $file
+	 */
 	function wpcom_static_url($file) {
 		$i = hexdec( substr( md5( $file ), -1 ) ) % 2;
 		$url = 'http://s' . $i . '.wp.com' . $file;

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'] );