Automattic / jetpack

packages/analyzer/src/PersistentList.php

Doc Comments +1 added lines

@@ -31,6 +31,7 @@
 
 	/**
 	 * Saves the items to a file and returns the file contents
+	 * @param string $file_path
 	 */
 	public function save( $file_path, $allow_empty = true ) {
 

packages/analyzer/src/Warnings/Warning.php

Doc Comments +4 added lines

@@ -10,6 +10,10 @@
 	public $message;
 	public $old_declaration;
 
+	/**
+	 * @param string $type
+	 * @param string $message
+	 */
 	function __construct( $type, $path, $line, $message, $old_declaration ) {
 		$this->type = $type;
 		$this->path = $path;

packages/analyzer/src/Declarations/Visitor.php

Doc Comments +3 added lines

@@ -11,6 +11,9 @@
 	private $declarations;
 	private $current_relative_path;
 
+	/**
+	 * @param  $declarations
+	 */
 	public function __construct( $current_relative_path, $declarations ) {
 		$this->current_relative_path = $current_relative_path;
 		$this->declarations          = $declarations;

packages/tracking/src/Tracking.php

Doc Comments +3 added lines, -1 removed lines

@@ -14,6 +14,9 @@ 
 	private $product_name;
 	private $connection;
 
+	/**
+	 * @param Connection\Manager $connection
+	 */
 	function __construct( $product_name = 'jetpack', $connection = null ) {
 		$this->product_name = $product_name;
 		$this->connection   = $connection;
@@ -60,7 +63,6 @@ 
 	/**
 	 * Record an event in Tracks - this is the preferred way to record events from PHP.
 	 *
-	 * @param mixed  $identity username, user_id, or WP_user object
 	 * @param string $event_name The name of the event
 	 * @param array  $properties Custom properties to send with the event
 	 * @param int    $event_timestamp_millis The time in millis since 1970-01-01 00:00:00 when the event occurred

packages/sync/src/Actions.php

Doc Comments +20 added lines

@@ -134,6 +134,9 @@ 
 		return ( Settings::get_setting( 'sync_via_cron' ) );
 	}
 
+	/**
+	 * @param boolean $should_publicize
+	 */
 	static function prevent_publicize_blacklisted_posts( $should_publicize, $post ) {
 		if ( in_array( $post->post_type, Settings::get_setting( 'post_types_blacklist' ) ) ) {
 			return false;
@@ -146,6 +149,13 @@ 
 		Settings::set_importing( true );
 	}
 
+	/**
+	 * @param string $codec_name
+	 * @param integer $sent_timestamp
+	 * @param integer $queue_id
+	 * @param integer $checkout_duration
+	 * @param integer $preprocess_duration
+	 */
 	static function send_data( $data, $codec_name, $sent_timestamp, $queue_id, $checkout_duration, $preprocess_duration ) {
 		\Jetpack::load_xml_rpc_client();
 
@@ -350,6 +360,9 @@ 
 		return $sync_modules;
 	}
 
+	/**
+	 * @return string
+	 */
 	static function sanitize_filtered_sync_cron_schedule( $schedule ) {
 		$schedule  = sanitize_key( $schedule );
 		$schedules = wp_get_schedules();
@@ -387,6 +400,9 @@ 
 		);
 	}
 
+	/**
+	 * @param string $hook
+	 */
 	static function maybe_schedule_sync_cron( $schedule, $hook ) {
 		if ( ! $hook ) {
 			return;
@@ -436,6 +452,10 @@ 
 		self::maybe_schedule_sync_cron( $full_sync_cron_schedule, 'jetpack_sync_full_cron' );
 	}
 
+	/**
+	 * @param string $new_version
+	 * @param string $old_version
+	 */
 	static function cleanup_on_upgrade( $new_version = null, $old_version = null ) {
 		if ( wp_next_scheduled( 'jetpack_sync_send_db_checksum' ) ) {
 			wp_clear_scheduled_hook( 'jetpack_sync_send_db_checksum' );