Automattic / jetpack

projects/packages/sync/src/class-functions.php

Doc Comments +3 added lines, -3 removed lines

@@ -186,7 +186,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known constants.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_constant() {
 		$hosting_provider_constants = array(
@@ -214,7 +214,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known classes.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_class() {
 		$hosting_provider = false;
@@ -231,7 +231,7 @@ 
 	/**
 	 * Return a hosting provider using a set of known functions.
 	 *
-	 * @return mixed A host identifier string or false.
+	 * @return string|false A host identifier string or false.
 	 */
 	public function get_hosting_provider_by_known_function() {
 		$hosting_provider = false;

projects/packages/connection/src/class-urls.php

Doc Comments +1 added lines, -1 removed lines

@@ -380,7 +380,7 @@
 	 *
 	 * @param string   $option Option value from the site.
 	 * @param callable $url_function Function retrieving the URL to normalize.
-	 * @return mixed|string URL.
+	 * @return callable URL.
 	 */
 	public static function normalize_www_in_url( $option, $url_function ) {
 		$url        = wp_parse_url( call_user_func( $url_function ) );

projects/packages/sync/src/class-rest-endpoints.php

Doc Comments +1 added lines, -1 removed lines

@@ -766,7 +766,7 @@
 	 *
 	 * @param string $item Sync item identifier.
 	 *
-	 * @return string|string[]|null
+	 * @return null|string
 	 */
 	protected static function sanitize_item_ids( $item ) {
 		// lets not delete any options that don't start with jpsq_sync- .

projects/plugins/vaultpress/class.vaultpress-database.php

Doc Comments +3 added lines

@@ -10,6 +10,9 @@
 	function __construct() {
 	}
 
+	/**
+	 * @param string $table
+	 */
 	function attach( $table, $parse_create_table = false ) {
 		$this->table=$table;
 		if ( $parse_create_table ) {

projects/plugins/vaultpress/class.vaultpress-filesystem.php

Doc Comments +6 added lines

@@ -42,6 +42,9 @@ 
 		die( 'naughty naughty' );
 	}
 
+	/**
+	 * @param string $file
+	 */
 	function fdump( $file ) {
 		header("Content-Type: application/octet-stream;");
 		header("Content-Transfer-Encoding: binary");
@@ -88,6 +91,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $method
+	 */
 	function checksum_file( $file, $method ) {
 		$use_exec = false;
 		if ( filesize( $file ) >= 104857600 )

projects/plugins/vaultpress/class.vaultpress-hotfixes.php

Doc Comments +7 added lines

@@ -394,6 +394,9 @@ 
 		return $matches[1] . "<a href=\"$url\" rel=\"nofollow\">$url</a>" . $suffix;
 	}
 
+	/**
+	 * @param integer $goal
+	 */
 	function r20493_split_str_by_whitespace( $string, $goal ) {
 		$chunks = array();
 
@@ -904,6 +907,10 @@ 
 		return VaultPress_kses::wp_kses_attr( $elem, $attrlist, $allowed_html, $allowed_protocols );
 	}
 
+	/**
+	 * @param string $element
+	 * @param string $attr
+	 */
 	static function wp_kses_attr($element, $attr, $allowed_html, $allowed_protocols) {
 		# Is there a closing XHTML slash at the end of the attributes?
 

projects/plugins/vaultpress/class.vaultpress-ixr-ssl-client.php

Doc Comments +1 added lines

@@ -50,6 +50,7 @@
 	 * Perform the IXR request.
 	 *
 	 * @param string[] ...$args IXR args.
+	 * @param string $args
 	 *
 	 * @return bool True if request succeeded, false otherwise.
 	 */

projects/plugins/vaultpress/cron-tasks.php

Doc Comments +3 added lines

@@ -6,6 +6,9 @@
 
 if ( !function_exists( 'apply_filters_ref_array' ) ) :
 
+/**
+ * @param string $tag
+ */
 function apply_filters_ref_array($tag, $args) {
 	global $wp_filter, $merged_filters, $wp_current_filter;
 

projects/plugins/vaultpress/vaultpress.php

Doc Comments +39 added lines, -1 removed lines

@@ -262,6 +262,9 @@ 
 		}
 	}
 
+	/**
+	 * @param string $key
+	 */
 	function get_option( $key ) {
 		if ( 'hostname' == $key ) {
 			if ( defined( 'VAULTPRESS_HOSTNAME' ) )
@@ -306,6 +309,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $key
+	 */
 	function update_option( $key, $value ) {
 		if ( 'allow_forwarded_for' === $key ) {
 			update_option( 'vaultpress_allow_forwarded_for', $value );
@@ -321,6 +327,9 @@ 
 		$this->update_options();
 	}
 
+	/**
+	 * @param string $key
+	 */
 	function delete_option( $key ) {
 		if ( 'allow_forwarded_for' === $key ) {
 			delete_option( 'vaultpress_allow_forwarded_for' );
@@ -1046,6 +1055,9 @@ 
 		return $jetpack_logo->output();
 	}
 
+	/**
+	 * @param string $key
+	 */
 	function get_config( $key ) {
 		$val = get_option( $key );
 		if ( $val )
@@ -1291,10 +1303,16 @@ 
 	function woocommerce_order_item_meta_handler( $id ) { $this->generic_change_handler( 'woocommerce_order_itemmeta',       array( 'meta_id' => $id ) ); }
 	function woocommerce_attribute_handler( $id )       { $this->generic_change_handler( 'woocommerce_attribute_taxonomies', array( 'attribute_id' => $id ) ); }
 
+	/**
+	 * @param string $table
+	 */
 	function generic_change_handler( $table, $key ) {
 		$this->add_ping( 'db', array( $table => $key ) );
 	}
 
+	/**
+	 * @param string $table
+	 */
 	function block_change_handler( $table, $query ) {
 		$this->add_ping( 'db', array( "bulk~{$table}" => $query ) );
 	}
@@ -1310,6 +1328,10 @@ 
 	}
 
 	// Emulate $wpdb->last_table
+
+	/**
+	 * @param string $table
+	 */
 	function record_table( $table ) {
 		global $vaultpress_last_table;
 		$vaultpress_last_table = $table;
@@ -1438,6 +1460,9 @@ 
 		return $wpdb->insert_id;
 	}
 
+	/**
+	 * @param string $value
+	 */
 	function ai_ping_insert( $value ) {
 		if ( ! $this->allow_ai_pings() ) {
 			return false;
@@ -2236,6 +2261,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $action
+	 */
 	function contact_service( $action, $args = array() ) {
 		if ( 'test' != $action && 'register' != $action && !$this->check_connection() )
 			return false;
@@ -2518,6 +2546,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $string
+	 */
 	function sign_string( $string, $secret, $salt ) {
 		return hash_hmac( 'sha1', "$string:$salt", $secret );
 	}
@@ -2589,6 +2620,10 @@ 
 		);
 	}
 
+	/**
+	 * @param string $type
+	 * @param string $hook
+	 */
 	function add_ping( $type, $data, $hook=null ) {
 		global $vaultpress_pings;
 		if ( defined( 'WP_IMPORTING' ) && constant( 'WP_IMPORTING' ) )
@@ -2752,6 +2787,9 @@ 
 		$this->delete_option( 'connection_test' );
 	}
 
+	/**
+	 * @return string
+	 */
 	function site_url() {
 		$site_url = '';
 
@@ -2789,7 +2827,7 @@ 
 	 *
 	 * @param array $options The list of whitelisted option names.
 	 *
-	 * @return array The updated whitelist
+	 * @return string[] The updated whitelist
 	 */
 	function add_to_jetpack_options_whitelist( $options ) {
 		$options[] = $this->option_name;