Automattic / jetpack

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 );
 	}

_inc/lib/class.media-extractor.php

Doc Comments +1 added lines, -1 removed lines

@@ -74,7 +74,7 @@
 	 * NOTE: If you want IMAGES, call extract( $blog_id, $post_id, ...) which will give you more/better image extraction
 	 * This method will give you an error if you ask for IMAGES.
 	 *
-	 * @param $content The HTML post_content of a post
+	 * @param string $content The HTML post_content of a post
 	 * @param $what_to_extract (int) A mask of things to extract, e.g. Jetpack_Media_Meta_Extractor::IMAGES | Jetpack_Media_Meta_Extractor::MENTIONS
 	 * @param $already_extracted (array) Previously extracted things, e.g. images from extract(), which can be used for x-referencing here
 	 * @returns a structure containing metadata about the embedded things, or empty array if nothing found, or WP_Error on error

json-endpoints/class.wpcom-json-api-site-settings-v1-2-endpoint.php

Doc Comments +3 added lines

@@ -27,6 +27,9 @@
 	}
 
 
+	/**
+	 * @param string $key
+	 */
 	protected function get_locale( $key ) {
 		if ( 'locale' == $key ) {
 			if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {

json-endpoints/class.wpcom-json-api-post-v1-1-endpoint.php

Doc Comments +6 added lines

@@ -120,6 +120,9 @@ 
 		return $response;
 	}
 
+	/**
+	 * @param string $field
+	 */
 	protected function get_sal_post_by( $field, $field_value, $context ) {
 		global $blog_id;
 
@@ -132,6 +135,9 @@ 
 		return $post;
 	}
 
+	/**
+	 * @param string $context
+	 */
 	private function render_response_keys( $post, $context, $keys ) {
 		foreach ( $keys as $key ) {
 			switch ( $key ) {

json-endpoints/class.wpcom-json-api-list-terms-endpoint.php

Doc Comments +6 added lines

@@ -69,11 +69,17 @@
 		return $args;
 	}
 
+	/**
+	 * @param string $taxonomy
+	 */
 	function get_found( $taxonomy, $args ) {
 		unset( $args['offset'] );
 		return wp_count_terms( $taxonomy, $args );
 	}
 
+	/**
+	 * @param string $taxonomy
+	 */
 	function get_formatted_terms( $taxonomy, $args ) {
 		$terms = get_terms( $taxonomy, $args );
 

_inc/lib/icalendar-reader.php

Doc Comments +2 added lines, -4 removed lines

@@ -699,8 +699,7 @@ 
 	 * Render the events
 	 *
 	 * @param string $url (default: '')
-	 * @param string $context (default: 'widget') or 'shortcode'
-	 * @return mixed bool|string false on failure, rendered HTML string on success.
+	 * @return false|string bool|string false on failure, rendered HTML string on success.
 	 */
 	public function render( $url = '', $args = array() ) {
 
@@ -857,8 +856,7 @@ 
  * Wrapper function for iCalendarReader->render()
  *
  * @param string $url (default: '')
- * @param string $context (default: 'widget') or 'shortcode'
- * @return mixed bool|string false on failure, rendered HTML string on success.
+ * @return false|string bool|string false on failure, rendered HTML string on success.
  */
 function icalendar_render_events( $url = '', $args = array() ) {
 	$ical = new iCalendarReader();

modules/custom-css/custom-css.php

Doc Comments +1 added lines, -1 removed lines

@@ -1404,7 +1404,7 @@
 	/**
 	 * Migration routine for moving safecss from wp_options to wp_posts to support revisions
 	 *
-	 * @return void
+	 * @return false|null
 	 */
 	static function upgrade() {
 		$css = get_option( 'safecss' );