Automattic / jetpack

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

Doc Comments +3 added lines

@@ -297,6 +297,7 @@ 
 	 * @param array $items item tree
 	 * @param array &$items_list output flat list of items
 	 * @param int &$counter for creating temporary IDs
+	 * @param integer $counter
 	 */
 	protected function untreeify_items( $items, &$items_list, &$counter ) {
 		foreach( $items as $index => $item ) {
@@ -546,6 +547,7 @@ 
 	 * This function will create items that have a 'tmp_id' set, and
 	 * update any items with a 'tmp_parent' to use the
 	 * newly created item as a parent.
+	 * @param integer $menu_id
 	 */
 	function create_new_items( $data, $menu_id ) {
 		$tmp_to_actual_ids = array();
@@ -571,6 +573,7 @@ 
 	/**
 	 * remove any existing menu items not present in the supplied array.
 	 * returns wp_error if an item cannot be deleted.
+	 * @param integer $menu_id
 	 */
 	function delete_items_not_present( $menu_id, $menu_items ) {
 

json-endpoints/class.wpcom-json-api-update-comment-endpoint.php

Doc Comments +16 added lines

@@ -35,6 +35,12 @@ 
 
 	// /sites/%s/posts/%d/replies/new    -> $blog_id, $post_id
 	// /sites/%s/comments/%d/replies/new -> $blog_id, $comment_id
+
+	/**
+	 * @param string $path
+	 * @param integer $post_id
+	 * @param integer $comment_parent_id
+	 */
 	function new_comment( $path, $blog_id, $post_id, $comment_parent_id ) {
 		if ( !$post_id ) {
 			$comment_parent = get_comment( $comment_parent_id );
@@ -146,6 +152,11 @@ 
 	}
 
 	// /sites/%s/comments/%d -> $blog_id, $comment_id
+
+	/**
+	 * @param string $path
+	 * @param integer $comment_id
+	 */
 	function update_comment( $path, $blog_id, $comment_id ) {
 		$comment = get_comment( $comment_id );
 		if ( !$comment || is_wp_error( $comment ) ) {
@@ -235,6 +246,11 @@ 
 	}
 
 	// /sites/%s/comments/%d/delete -> $blog_id, $comment_id
+
+	/**
+	 * @param string $path
+	 * @param integer $comment_id
+	 */
 	function delete_comment( $path, $blog_id, $comment_id ) {
 		$comment = get_comment( $comment_id );
 		if ( !$comment || is_wp_error( $comment ) ) {

modules/custom-css/custom-css/preprocessors/lessc.inc.php

Doc Comments +43 added lines

@@ -77,6 +77,9 @@ 
 		return null;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	protected function fileExists($name) {
 		return is_file($name);
 	}
@@ -260,6 +263,9 @@ 
 		return $scope;
 	}
 
+	/**
+	 * @param string[] $selectors
+	 */
 	protected function compileNestedBlock($block, $selectors) {
 		$this->pushEnv($block);
 		$this->scope = $this->makeOutputBlock($block->type, $selectors);
@@ -278,6 +284,9 @@ 
 		$this->popEnv();
 	}
 
+	/**
+	 * @param stdClass $out
+	 */
 	protected function compileProps($block, $out) {
 		foreach ($this->sortProps($block->props) as $prop) {
 			$this->compileProp($prop, $block, $out);
@@ -388,6 +397,9 @@ 
 		return $out;
 	}
 
+	/**
+	 * @param stdClass $env
+	 */
 	protected function multiplyMedia($env, $childQueries = null) {
 		if (is_null($env) ||
 			!empty($env->block->type) && $env->block->type != "media")
@@ -1288,6 +1300,9 @@ 
 		$this->throwError($error);
 	}
 
+	/**
+	 * @param integer $expectedArgs
+	 */
 	public function assertArgs($value, $expectedArgs, $name="") {
 		if ($expectedArgs == 1) {
 			return $value;
@@ -1342,6 +1357,11 @@ 
 		return $out;
 	}
 
+	/**
+	 * @param double $comp
+	 * @param double $temp1
+	 * @param double $temp2
+	 */
 	protected function toRGB_helper($comp, $temp1, $temp2) {
 		if ($comp < 0) $comp += 1.0;
 		elseif ($comp > 1) $comp -= 1.0;
@@ -2317,6 +2337,9 @@ 
 	// caches preg escaped literals
 	static protected $literalCache = array();
 
+	/**
+	 * @param lessc $lessc
+	 */
 	public function __construct($lessc, $sourceName = null) {
 		$this->eatWhiteDefault = true;
 		// reference to less needed for vPrefix, mPrefix, and parentSelector
@@ -2617,6 +2640,7 @@ 
 
 	/**
 	 * recursively parse infix equation with $lhs at precedence $minP
+	 * @param integer $minP
 	 */
 	protected function expHelper($lhs, $minP) {
 		$this->inExp = true;
@@ -2843,6 +2867,11 @@ 
 	}
 
 	// an unbounded string stopped by $end
+
+	/**
+	 * @param string $end
+	 * @param string[] $rejectStrs
+	 */
 	protected function openString($end, &$out, $nestingOpen=null, $rejectStrs = null) {
 		$oldWhite = $this->eatWhiteDefault;
 		$this->eatWhiteDefault = false;
@@ -3423,6 +3452,9 @@ 
 
 	/* raw parsing functions */
 
+	/**
+	 * @param boolean $eatWhitespace
+	 */
 	protected function literal($what, $eatWhitespace = null) {
 		if ($eatWhitespace === null) $eatWhitespace = $this->eatWhiteDefault;
 
@@ -3446,6 +3478,9 @@ 
 		return $this->match(self::$literalCache[$what], $m, $eatWhitespace);
 	}
 
+	/**
+	 * @param string $parseItem
+	 */
 	protected function genericList(&$out, $parseItem, $delim="", $flatten=true) {
 		$s = $this->seek();
 		$items = array();
@@ -3519,6 +3554,10 @@ 
 	}
 
 	// match something without consuming it
+
+	/**
+	 * @param string $regex
+	 */
 	protected function peek($regex, &$out = null, $from=null) {
 		if (is_null($from)) $from = $this->count;
 		$r = '/'.$regex.'/Ais';
@@ -3574,6 +3613,10 @@ 
 	}
 
 	// push a block that doesn't multiply tags
+
+	/**
+	 * @param string $type
+	 */
 	protected function pushSpecialBlock($type) {
 		return $this->pushBlock(null, $type);
 	}

modules/infinite-scroll/infinity.php

Doc Comments +1 added lines, -1 removed lines

@@ -1283,7 +1283,7 @@
 	 * Returns an array of stock and custom taxonomy query vars
 	 *
 	 * @global $wp_taxonomies
-	 * @return array
+	 * @return string[]
 	 */
 	function get_taxonomy_vars() {
 		global $wp_taxonomies;

modules/latex.php

Doc Comments +3 added lines

@@ -58,6 +58,9 @@
 	return latex_render( $latex, $fg, $bg, $s );
 }
 
+/**
+ * @param string $color
+ */
 function latex_get_default_color( $color, $default_color = 'ffffff' ) {
 	global $themecolors;
 	return isset($themecolors[$color]) ? $themecolors[$color] : $default_color;

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/theme-tools/site-logo/inc/class-site-logo.php

Doc Comments +1 added lines, -1 removed lines

@@ -258,7 +258,7 @@
 	/**
 	 * Reset the site logo if the current logo is deleted in the media manager.
 	 *
-	 * @param int $site_id
+	 * @param int $post_id
 	 * @uses Site_Logo::remove_site_logo()
 	 */
 	public function reset_on_attachment_delete( $post_id ) {

modules/videopress/class.videopress-player.php

Doc Comments +1 added lines

@@ -185,6 +185,7 @@
 	 * @since 1.3
 	 * @uses current_user_can() to test if current user has edit_posts capability
 	 * @var WP_Error $error WordPress error
+	 * @param VideoPress_Video $error
 	 * @return string HTML string
 	 */
 	private function error_message( $error ) {