Automattic / jetpack

modules/likes.php

Doc Comments +3 added lines

@@ -332,6 +332,9 @@
 <?php
 	}
 
+	/**
+	 * @param string $option
+	 */
 	function admin_likes_get_option( $option ) {
 		if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
 			$option_setting = get_blog_option( get_current_blog_id(), $option, 'on' );

modules/markdown/easy-markdown.php

Doc Comments +3 added lines

@@ -504,6 +504,9 @@
 		) );
 	}
 
+	/**
+	 * @param string $content
+	 */
 	protected function comment_hash( $content ) {
 		return 'c-' . substr( md5( $content ), 0, 8 );
 	}

modules/monitor.php

Doc Comments +3 added lines

@@ -97,6 +97,9 @@
 		return $xml->getResponse();
 	}
 
+	/**
+	 * @param boolean $value
+	 */
 	public function update_option_receive_jetpack_monitor_notification( $value ) {
 		Jetpack::load_xml_rpc_client();
 		$xml = new Jetpack_IXR_Client( array(

modules/notes.php

Doc Comments +3 added lines

@@ -48,6 +48,9 @@
 		add_action( 'init', array( &$this, 'action_init' ) );
 	}
 
+	/**
+	 * @param string $file
+	 */
 	function wpcom_static_url($file) {
 		$i = hexdec( substr( md5( $file ), -1 ) ) % 2;
 		$url = 'http://s' . $i . '.wp.com' . $file;

modules/protect/math-fallback.php

Doc Comments +1 added lines, -1 removed lines

@@ -26,7 +26,7 @@
 		/**
 		 * Verifies that a user answered the math problem correctly while logging in.
 		 *
-		 * @return bool Returns true if the math is correct
+		 * @return boolean|null Returns true if the math is correct
 		 * @throws Error if insuffient $_POST variables are present.
 		 * @throws Error message if the math is wrong
 		 */

modules/publicize.php

Doc Comments +6 added lines

@@ -266,6 +266,9 @@ 
 		return trim( preg_replace( '#<p>\s*</p>#i', '', $new_string ) );
 	}
 
+	/**
+	 * @return integer
+	 */
 	function remove_innermost_last_child( $node, &$node_removed_from ) {
 		$node_removed_from = $node;
 
@@ -308,6 +311,9 @@ 
 		return str_replace( $search, $replace, $string );
 	}
 
+	/**
+	 * @param string $message
+	 */
 	public static function sanitize_message( $message ) {
 		$message = preg_replace( '@<(script|style)[^>]*?>.*?</\\1>@si', '', $message );
 		$message = wp_kses( $message, array() );

modules/related-posts/jetpack-related-posts.php

Doc Comments +2 added lines

@@ -1220,6 +1220,8 @@
 	 * Enqueues assets needed to do async loading of related posts.
 	 *
 	 * @uses wp_enqueue_script, wp_enqueue_style, plugins_url
+	 * @param boolean $script
+	 * @param boolean $style
 	 * @return null
 	 */
 	protected function _enqueue_assets( $script, $style ) {

modules/sharedaddy/sharing-service.php

Doc Comments +3 added lines

@@ -427,6 +427,9 @@
 	public $service	= '';
 	public $total 		= 0;
 
+	/**
+	 * @param integer $total
+	 */
 	public function __construct( $id, $total ) {
 		$services 		= new Sharing_Service();
 		$this->id 		= esc_html( $id );

modules/sharedaddy/sharing-sources.php

Doc Comments +12 added lines

@@ -40,6 +40,9 @@ 
 		return $this->id;
 	}
 
+	/**
+	 * @return string
+	 */
 	public function get_share_url( $post_id ) {
 		/**
 		 * Filter the sharing permalink.
@@ -77,6 +80,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $url
+	 */
 	public function get_link( $url, $text, $title, $query = '', $id = false ) {
 		$args = func_get_args();
 		$klasses = array( 'share-'.$this->get_class(), 'sd-button' );
@@ -311,6 +317,9 @@ 
 		do_action( 'sharing_bump_stats', array( 'service' => $this, 'post' => $post ) );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	public function js_dialog( $name, $params = array() ) {
 		if ( true !== $this->open_link_in_new )
 			return;
@@ -1393,6 +1402,9 @@ 
 		return __( 'Pinterest', 'jetpack' );
 	}
 
+	/**
+	 * @return string
+	 */
 	public function get_image( $post ) {
 		if ( class_exists( 'Jetpack_PostImages' ) ) {
 			$image = Jetpack_PostImages::get_image( $post->ID, array( 'fallback_to_avatars' => true ) );