Automattic / jetpack

_inc/lib/class-jetpack-instagram-gallery-helper.php

Doc Comments +1 added lines, -1 removed lines

@@ -18,7 +18,7 @@
 	 *
 	 * @param  string $access_token The Instagram access token.
 	 * @param  int    $count        The number of Instagram posts to fetch.
-	 * @return mixed
+	 * @return integer|null
 	 */
 	public static function get_instagram_gallery( $access_token, $count ) {
 		$site_id = self::get_site_id();

packages/jitm/src/class-post-connection-jitm.php

Doc Comments +1 added lines, -1 removed lines

@@ -103,7 +103,7 @@
 	 *
 	 * @param string $content The current message.
 	 *
-	 * @return array The new message.
+	 * @return string The new message.
 	 */
 	public static function jitm_woocommerce_services_msg( $content ) {
 		if ( ! function_exists( 'wc_get_base_location' ) ) {

modules/scan/class-admin-bar-notice.php

Doc Comments +1 added lines, -1 removed lines

@@ -143,7 +143,7 @@
 	/**
 	 *
 	 * Return Whether boolean cached threats exist or null if the state is unknown.
-	 * * @return boolean or null
+	 * * @return null|boolean or null
 	 */
 	public function has_threats() {
 		$scan_state = get_transient( 'jetpack_scan_state' );

modules/gravatar-hovercards.php

Doc Comments +1 added lines, -1 removed lines

@@ -154,7 +154,7 @@
  * @param string $avatar The <img/> element of the avatar.
  * @param mixed $author User ID, email address, user login, comment object, user object, post object
  *
- * @return The <img/> element of the avatar.
+ * @return string <img/> element of the avatar.
  */
 function grofiles_get_avatar( $avatar, $author ) {
 	$is_amp = class_exists( 'Jetpack_AMP_Support' ) && Jetpack_AMP_Support::is_amp_request();

modules/woocommerce-analytics/classes/class-jetpack-woocommerce-analytics-universal.php

Doc Comments +1 added lines, -1 removed lines

@@ -310,7 +310,7 @@
 	/**
 	 * Get the current user id
 	 *
-	 * @return int
+	 * @return string
 	 */
 	public function get_user_id() {
 		if ( is_user_logged_in() ) {

modules/subscriptions.php

Doc Comments +1 added lines, -1 removed lines

@@ -514,7 +514,7 @@
 	 * Send a synchronous XML-RPC subscribe to blog posts or subscribe to post comments request.
 	 *
 	 * @param string $email
-	 * @param array  $post_ids (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts
+	 * @param integer  $post_ids (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts
 	 * @param bool   $async    (optional) Should the subscription be performed asynchronously?  Defaults to true.
 	 *
 	 * @return true|WP_Error true on success

docker/mu-plugins/debug.php

Doc Comments +2 added lines, -2 removed lines

@@ -38,7 +38,7 @@ 
  *
  * A null argument will log the file and line number of the l() call.
  *
- * @param mixed $stuff Information to log.
+ * @param string $stuff Information to log.
  */
 function l( $stuff = null ) {
 	// Do nothing when debugging is off.
@@ -166,7 +166,7 @@ 
  *
  * @param string $name Timer name.
  *
- * @return mixed void or elapsed time.
+ * @return null|double void or elapsed time.
  */
 function e( $name = '' ) {
 	static $times = array();

packages/analyzer/src/class-declarations.php

Doc Comments +3 added lines

@@ -33,6 +33,9 @@
 		}
 	}
 
+	/**
+	 * @param string $root
+	 */
 	public function scan_dir( $root, $exclude = array() ) {
 
 		if ( is_null( $exclude ) || ! is_array( $exclude ) ) {

packages/analyzer/src/class-differences.php

Doc Comments +3 added lines

@@ -9,6 +9,9 @@
 
 class Differences extends PersistentList {
 
+	/**
+	 * @param string $path
+	 */
 	private function slashit( $path ) {
 		$path .= ( substr( $path, -1 ) == '/' ? '' : '/' );
 		return $path;