Automattic / jetpack

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/theme-tools/site-logo/inc/class-site-logo.php

Doc Comments +1 added lines, -1 removed lines

@@ -258,7 +258,7 @@
 	/**
 	 * Reset the site logo if the current logo is deleted in the media manager.
 	 *
-	 * @param int $site_id
+	 * @param int $post_id
 	 * @uses Site_Logo::remove_site_logo()
 	 */
 	public function reset_on_attachment_delete( $post_id ) {

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 ) {

modules/sso.php

Doc Comments +2 added lines, -2 removed lines

@@ -262,7 +262,7 @@ 
 	 * Validate the require  two step checkbox in Settings > General
 	 *
 	 * @since 2.7
-	 * @return boolean
+	 * @return integer
 	 **/
 	public function validate_jetpack_sso_require_two_step( $input ) {
 		return ( ! empty( $input ) ) ? 1 : 0;
@@ -287,7 +287,7 @@ 
 	 * Validate the match by email check in Settings > General
 	 *
 	 * @since 2.9
-	 * @return boolean
+	 * @return integer
 	 **/
 	public function validate_jetpack_sso_match_by_email( $input ) {
 		return ( ! empty( $input ) ) ? 1 : 0;

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

modules/theme-tools/site-logo/inc/functions.php

Doc Comments +1 added lines

@@ -165,6 +165,7 @@
  * Sanitize the string of classes used for header text.
  * Limit to A-Z,a-z,0-9,(space),(comma),_,-
  *
+ * @param string $classes
  * @return string Sanitized string of CSS classes.
  */
 function jetpack_sanitize_header_text_classes( $classes ) {

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