Automattic / jetpack

sync/class.jetpack-sync-module-full-sync.php

Doc Comments +3 added lines

@@ -170,6 +170,9 @@
 		$listener->get_full_sync_queue()->reset();
 	}
 
+	/**
+	 * @param integer $default
+	 */
 	private function get_status_option( $option, $default = null ) {
 		$prefix = self::STATUS_OPTION_PREFIX;
 

modules/wordads/wordads.php

Doc Comments +1 added lines, -1 removed lines

@@ -256,7 +256,7 @@
 
 	/**
 	 * Check the reasons to bail before we attempt to insert ads.
-	 * @return true if we should bail (don't insert ads)
+	 * @return boolean if we should bail (don't insert ads)
 	 *
 	 * @since 0.1
 	 */

class.jetpack-options.php

Doc Comments +7 added lines, -1 removed lines

@@ -16,7 +16,7 @@ 
 	 *
 	 * @param string $type The type of option to return. Defaults to 'compact'.
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public static function get_option_names( $type = 'compact' ) {
 		switch ( $type ) {
@@ -163,6 +163,9 @@ 
 		return $value;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	private static function update_grouped_option( $group, $name, $value ) {
 		$options = get_option( self::$grouped_options[ $group ] );
 		if ( ! is_array( $options ) ) {
@@ -257,6 +260,9 @@ 
 		return $result;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	private static function get_grouped_option( $group, $name, $default ) {
 		$options = get_option( self::$grouped_options[ $group ] );
 		if ( is_array( $options ) && isset( $options[ $name ] ) ) {

modules/shortcodes/archiveorg.php

Doc Comments +1 added lines, -1 removed lines

@@ -98,7 +98,7 @@
  *
  * @param string $content
  *
- * @return mixed
+ * @return string
  */
 function jetpack_archiveorg_embed_to_shortcode( $content ) {
 	if ( false === stripos( $content, 'archive.org/embed/' ) )

modules/wordads/php/api.php

Doc Comments +3 added lines, -3 removed lines

@@ -45,7 +45,7 @@ 
 
 	/**
 	 * Returns status of WordAds approval.
-	 * @return boolean true if site is WordAds approved
+	 * @return string true if site is WordAds approved
 	 *
 	 * @since 4.5.0
 	 */
@@ -59,7 +59,7 @@ 
 
 	/**
 	 * Returns status of WordAds active.
-	 * @return boolean true if ads are active on site
+	 * @return string true if ads are active on site
 	 *
 	 * @since 4.5.0
 	 */
@@ -73,7 +73,7 @@ 
 
 	/**
 	 * Returns status of WordAds house ads.
-	 * @return boolean true if WP.com house ads should be shown
+	 * @return string true if WP.com house ads should be shown
 	 *
 	 * @since 4.5.0
 	 */

modules/shortcodes/class.filter-embedded-html-objects.php

Doc Comments +6 added lines

@@ -90,6 +90,9 @@ 
 		return $html;
 	}
 
+	/**
+	 * @param string $regexp
+	 */
 	static public function regexp_entities( $regexp ) {
 		return preg_replace(
 			'/\[\^&([^\]]+)\]\*\+/',
@@ -128,6 +131,9 @@ 
 		return self::dispatch( $matches );
 	}
 
+	/**
+	 * @param string[] $matches
+	 */
 	static function dispatch( $matches ) {
 		$html  = preg_replace( '%&#0*58;//%', '://', $matches[0] );
 		$attrs = self::get_attrs( $html );

modules/theme-tools/content-options/blog-display.php

Doc Comments +1 added lines

@@ -138,6 +138,7 @@
 /**
  * Returns a class value, `output-the-content` by default.
  * Used for themes with a 'Mixed' Blog Display so we can tell which output is by default.
+ * @param string $new_class
  */
 function jetpack_the_content_customizer_class( $new_class = null ) {
 	static $class;

modules/shortcodes/googleapps.php

Doc Comments +1 added lines, -1 removed lines

@@ -98,7 +98,7 @@
  *
  * @param string $content
  *
- * @return mixed
+ * @return string
  */
 function jetpack_archiveorg_embed_to_shortcode( $content ) {
 	if ( false === stripos( $content, 'archive.org/embed/' ) )

sync/class.jetpack-sync-actions.php

Doc Comments +6 added lines

@@ -298,6 +298,9 @@ 
 		return $sync_modules;
 	}
 
+	/**
+	 * @return string
+	 */
 	static function sanitize_filtered_sync_cron_schedule( $schedule ) {
 		$schedule = sanitize_key( $schedule );
 		$schedules = wp_get_schedules();
@@ -333,6 +336,9 @@ 
 		) );
 	}
 
+	/**
+	 * @param string $hook
+	 */
 	static function maybe_schedule_sync_cron( $schedule, $hook ) {
 		if ( ! $hook ) {
 			return;