Automattic / jetpack

json-endpoints/class.wpcom-json-api-post-v1-1-endpoint.php

Doc Comments +6 added lines

@@ -120,6 +120,9 @@ 
 		return $response;
 	}
 
+	/**
+	 * @param string $field
+	 */
 	protected function get_sal_post_by( $field, $field_value, $context ) {
 		global $blog_id;
 
@@ -132,6 +135,9 @@ 
 		return $post;
 	}
 
+	/**
+	 * @param string $context
+	 */
 	private function render_response_keys( $post, $context, $keys ) {
 		foreach ( $keys as $key ) {
 			switch ( $key ) {

sync/class.jetpack-sync-queue.php

Doc Comments +9 added lines

@@ -7,6 +7,9 @@ 
 	public $id;
 	public $items_with_ids;
 
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, $items_with_ids ) {
 		$this->id             = $id;
 		$this->items_with_ids = $items_with_ids;
@@ -31,6 +34,9 @@ 
 	public $id;
 	private $row_iterator;
 
+	/**
+	 * @param string $id
+	 */
 	function __construct( $id ) {
 		$this->id            = str_replace( '-', '_', $id ); // necessary to ensure we don't have ID collisions in the SQL
 		$this->row_iterator  = 0;
@@ -303,6 +309,9 @@ 
 		return get_transient( $this->get_checkout_transient_name() );
 	}
 
+	/**
+	 * @param string $checkout_id
+	 */
 	private function set_checkout_id( $checkout_id ) {
 		return set_transient( $this->get_checkout_transient_name(), $checkout_id, 5*60 ); // 5 minute timeout
 	}

modules/post-by-email.php

Doc Comments +1 added lines, -1 removed lines

@@ -181,7 +181,7 @@
 	/**
 	 * Backend function to abstract the xmlrpc function calls to wpcom.
 	 *
-	 * @param $endpoint
+	 * @param string $endpoint
 	 * @param $error_message
 	 */
 	function __process_ajax_proxy_request( $endpoint, $error_message ) {

_inc/lib/class.core-rest-api-endpoints.php

Doc Comments +1 added lines, -1 removed lines

@@ -1940,7 +1940,7 @@
 	 *
 	 * @param string $route Regular expression for the endpoint with the module slug to return.
 	 *
-	 * @return array
+	 * @return string
 	 */
 	public static function get_module_requested( $route ) {
 

modules/sso.php

Doc Comments +2 added lines, -2 removed lines

@@ -262,7 +262,7 @@ 
 	 * Validate the require  two step checkbox in Settings > General
 	 *
 	 * @since 2.7
-	 * @return boolean
+	 * @return integer
 	 **/
 	public function validate_jetpack_sso_require_two_step( $input ) {
 		return ( ! empty( $input ) ) ? 1 : 0;
@@ -287,7 +287,7 @@ 
 	 * Validate the match by email check in Settings > General
 	 *
 	 * @since 2.9
-	 * @return boolean
+	 * @return integer
 	 **/
 	public function validate_jetpack_sso_match_by_email( $input ) {
 		return ( ! empty( $input ) ) ? 1 : 0;

modules/shortcodes/recipe.php

Doc Comments +2 added lines

@@ -253,6 +253,8 @@
 	 * And we'll magically convert it to a list. This has the added benefit
 	 * of including itemprops for the recipe schema.
 	 *
+	 * @param string $content
+	 * @param string $type
 	 * @return string content formatted as a list item
 	 */
 	static function output_list_content( $content, $type ) {

modules/shortcodes.php

Doc Comments +1 added lines, -1 removed lines

@@ -102,9 +102,9 @@
  * Parameters are the same as preg_replace, with an added optional search param for improved performance
  *
  * @param String $pattern
- * @param String $replacement
  * @param String $content
  * @param String $search
+ * @param string $callback
  * @return String $content
  */
 function jetpack_preg_replace_callback_outside_tags( $pattern, $callback, $content, $search = null ) {

sal/class.json-api-site-jetpack-base.php

Doc Comments +13 added lines

@@ -4,16 +4,29 @@
 require_once dirname( __FILE__ ) . '/class.json-api-site-base.php';
 
 abstract class Abstract_Jetpack_Site extends SAL_Site {
+
+	/**
+	 * @param string $name
+	 */
 	abstract protected function get_constant( $name );
 
+	/**
+	 * @param string $feature_name
+	 */
 	abstract protected function current_theme_supports( $feature_name );
 
+	/**
+	 * @param string $feature_name
+	 */
 	abstract protected function get_theme_support( $feature_name );
 
 	abstract protected function get_jetpack_version();
 
 	abstract protected function get_updates();
 
+	/**
+	 * @return string
+	 */
 	abstract protected function main_network_site();
 
 	abstract protected function wp_version();

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 );