Automattic / jetpack

class.jetpack-client-server.php

Doc Comments +4 added lines

@@ -137,6 +137,10 @@
 		return 'authorized';
 	}
 
+	/**
+	 * @param string $probable_file
+	 * @param string $probable_title
+	 */
 	public static function deactivate_plugin( $probable_file, $probable_title ) {
 		include_once( ABSPATH . 'wp-admin/includes/plugin.php' );
 		if ( is_plugin_active( $probable_file ) ) {

class.jetpack-data.php

Doc Comments +1 added lines

@@ -104,6 +104,7 @@
 	 * See: https://bugs.php.net/bug.php?id=66229 and https://github.com/php/php-src/commit/d1314893fd1325ca6aa0831101896e31135a2658
 	 *
 	 * This function mirrors Jetpack_Data::php_bug_66229_check() in the WPCOM codebase.
+	 * @param string $ip
 	 */
 	public static function php_bug_66229_check( $ip ) {
 		if ( ! filter_var( $ip, FILTER_VALIDATE_IP ) ) {

json-endpoints/class.wpcom-json-api-list-terms-endpoint.php

Doc Comments +6 added lines

@@ -69,11 +69,17 @@
 		return $args;
 	}
 
+	/**
+	 * @param string $taxonomy
+	 */
 	function get_found( $taxonomy, $args ) {
 		unset( $args['offset'] );
 		return wp_count_terms( $taxonomy, $args );
 	}
 
+	/**
+	 * @param string $taxonomy
+	 */
 	function get_formatted_terms( $taxonomy, $args ) {
 		$terms = get_terms( $taxonomy, $args );
 

sal/class.json-api-post-base.php

Doc Comments +6 added lines

@@ -16,6 +16,9 @@ 
 	public $context;
 	public $site;
 
+	/**
+	 * @param Jetpack_Site $site
+	 */
 	function __construct( $site, $post, $context ) {
 		$this->post = $post;
 		$this->context = $context;
@@ -508,6 +511,9 @@ 
 		return $suggestions;
 	}
 
+	/**
+	 * @param string $context
+	 */
 	private function format_taxonomy( $taxonomy, $taxonomy_type, $context ) {
 		// Permissions
 		switch ( $context ) {

modules/widgets/contact-info.php

Doc Comments -2 removed lines

@@ -281,8 +281,6 @@
 		/**
 		 * Builds map display HTML code from the supplied latitude and longitude.
 		 *
-		 * @param float $lat Map Latitude
-		 * @param float $lon Map Longitude
 		 *
 		 * @return string HTML of the map
 		 */

modules/custom-css/csstidy/class.csstidy_optimise.php

Doc Comments +1 added lines, -1 removed lines

@@ -62,7 +62,7 @@
 
 	/**
 	 * Constructor
-	 * @param array $css contains the class csstidy
+	 * @param csstidy $css contains the class csstidy
 	 * @access private
 	 * @version 1.0
 	 */

modules/videopress/class.videopress-scheduler.php

Doc Comments +1 added lines, -1 removed lines

@@ -85,7 +85,7 @@
 	 *
 	 * @param string $cron_name
 	 *
-	 * @return bool
+	 * @return false|null
 	 */
 	public function activate_cron( $cron_name ) {
 

_inc/lib/icalendar-reader.php

Doc Comments +2 added lines, -4 removed lines

@@ -699,8 +699,7 @@ 
 	 * Render the events
 	 *
 	 * @param string $url (default: '')
-	 * @param string $context (default: 'widget') or 'shortcode'
-	 * @return mixed bool|string false on failure, rendered HTML string on success.
+	 * @return false|string bool|string false on failure, rendered HTML string on success.
 	 */
 	public function render( $url = '', $args = array() ) {
 
@@ -857,8 +856,7 @@ 
  * Wrapper function for iCalendarReader->render()
  *
  * @param string $url (default: '')
- * @param string $context (default: 'widget') or 'shortcode'
- * @return mixed bool|string false on failure, rendered HTML string on success.
+ * @return false|string bool|string false on failure, rendered HTML string on success.
  */
 function icalendar_render_events( $url = '', $args = array() ) {
 	$ical = new iCalendarReader();

_inc/lib/tracks/client.php

Doc Comments -1 removed lines

@@ -107,7 +107,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