Automattic / jetpack

json-endpoints/jetpack/class.jetpack-json-api-plugins-modify-endpoint.php

Doc Comments +3 added lines

@@ -139,6 +139,9 @@
 		}
 	}
 
+	/**
+	 * @param string $capability
+	 */
 	protected function current_user_can( $capability, $plugin = null ) {
 		global $wp_version;
 		if ( version_compare( $wp_version, '4.9-beta2' ) >= 0 ) {

modules/google-analytics/classes/wp-google-analytics-options.php

Doc Comments +4 added lines

@@ -15,6 +15,10 @@
 }
 
 class Jetpack_Google_Analytics_Options {
+
+	/**
+	 * @param string $option_name
+	 */
 	public static function get_option( $option_name, $default = false ) {
 		$o = get_option( 'jetpack_wga' );
 		return isset( $o[ $option_name ] ) ? $o[ $option_name ] : $default;

modules/protect/blocked-login-page.php

Doc Comments +3 added lines

@@ -326,6 +326,9 @@
 		return $contents;
 	}
 
+	/**
+	 * @param string $message
+	 */
 	function display_page( $title, $message, $back_button = false, $recovery_form = false ) {
 
 		if ( ! headers_sent() ) {

modules/widgets/goodreads.php

Doc Comments +3 added lines

@@ -87,6 +87,9 @@
 		echo $args['after_widget'];
 	}
 
+	/**
+	 * @param string $user_id
+	 */
 	function goodreads_user_id_exists( $user_id ) {
 		$url = "https://www.goodreads.com/user/show/$user_id/";
 		$response = wp_remote_head( $url, array( 'httpversion' => '1.1', 'timeout' => 3, 'redirection' => 2 ) );

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

Doc Comments +3 added lines

@@ -94,6 +94,9 @@
 		return $user;
 	}
 
+	/**
+	 * @param WP_User|null $user
+	 */
 	public function expand_user( $user ) {
 		if ( ! is_object( $user ) ) {
 			return null;

_inc/lib/functions.wp-notify.php

Doc Comments +1 added lines, -1 removed lines

@@ -201,7 +201,7 @@
 	 * should be notified, overriding the site setting.
 	 *
 	 * @param int $comment_id Comment ID.
-	 * @return true Always returns true.
+	 * @return boolean Always returns true.
 	 */
 	function wp_notify_moderator( $comment_id ) {
 		global $wpdb;

_inc/lib/jetpack-wpes-query-builder/jetpack-wpes-query-parser.php

Doc Comments +4 added lines

@@ -147,6 +147,10 @@
 	 * Take a list of field prefixes and expand them for multi-lingual
 	 * with the provided boostings.
 	 */
+
+	/**
+	 * @param string[] $additional_fields
+	 */
 	public function merge_ml_fields( $fields2boosts, $additional_fields ) {
 		$flds = array();
 		foreach( $fields2boosts as $f => $b ) {

_inc/lib/class.jetpack-search-performance-logger.php

Doc Comments +4 added lines

@@ -58,6 +58,10 @@
 		return $query->is_main_query() && $query->is_search();
 	}
 
+	/**
+	 * @param double $duration
+	 * @param boolean $was_jetpack_search
+	 */
 	private function record_query_time( $duration, $was_jetpack_search ) {
 		$this->stats[] = array( $was_jetpack_search, intval( $duration * 1000 ) );
 	}

modules/search/class.jetpack-search-helpers.php

Doc Comments -1 removed lines

@@ -76,7 +76,6 @@
 	 * @since 5.8.0
 	 *
 	 * @param string|array $key   Query key or keys to remove.
-	 * @param bool|string  $query Optional. A URL to act upon.  Defaults to the current search URL.
 	 *
 	 * @return string New URL query string (unescaped).
 	 */