Automattic / jetpack

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;

projects/plugins/vaultpress/vp-scanner.php

Doc Comments +13 added lines, -4 removed lines

@@ -8,6 +8,9 @@ 
 	var $offset = 0;
 	var $ignore_symlinks = false;
 
+	/**
+	 * @param string $path
+	 */
 	function __construct( $path, $ignore_symlinks = false ) {
 		if ( is_dir( $path ) )
 			$this->last_dir = $this->path = @realpath( $path );
@@ -28,6 +31,11 @@ 
 		return $files;
 	}
 
+	/**
+	 * @param string $path
+	 * @param integer $offset
+	 * @param integer $limit
+	 */
 	function _scan_files( $path, &$files, $offset, $limit, &$last_dir ) {
 		$_offset = 0;
 		if ( is_readable( $path ) && $handle = opendir( $path ) ) {
@@ -74,6 +82,9 @@ 
 	}
 }
 
+/**
+ * @return string
+ */
 function vp_get_real_file_path( $file_path, $tmp_file = false ) {
 	global $site, $site_id;
 	$site_id = !empty( $site->id ) ? $site->id : $site_id;
@@ -111,7 +122,6 @@ 
  * Uses the PHP tokenizer to split a string into 3 arrays: PHP code with no comments,
  * PHP code with comments, and HTML/JS code.
  *
- * @param string $file The file path to read and parse
  * @return array An array with 3 arrays of lines
  */
 function split_to_php_html( $source ) {
@@ -181,8 +191,7 @@ 
  * Helper function for split_file_to_php_html; adds a chunk of text to the arrays we'll return.
  * @param array $parsed The array containing all the languages we'll return
  * @param string $prefix The prefix for the languages we want to add this text to
- * @param int $line_number The line number that this text goes on
- * @param string $text The text to add
+ * @param integer $start_line_number The line number that this text goes on
  */
 function add_text_to_parsed( &$parsed, $prefix, $start_line_number, $all_text ) {
 	$line_number = $start_line_number;
@@ -223,7 +232,7 @@ 
  * expressions should result in a match.
  * @param $file the filename to be scanned.
  * @param null $tmp_file used if the file to be scanned doesn't exist or if the filename doesn't match vp_is_interesting_file().
- * @return array|bool false if no matched signature is found. A list of matched signatures otherwise.
+ * @return string false if no matched signature is found. A list of matched signatures otherwise.
  */
 function vp_scan_file( $file, $tmp_file = null, $use_parser = false ) {
 	$real_file = vp_get_real_file_path( $file, $tmp_file );