Automattic / jetpack

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

Doc Comments +17 added lines

@@ -26,6 +26,11 @@ 
 	}
 
 	// /sites/%s/tags|categories/new    -> $blog_id
+
+	/**
+	 * @param string $path
+	 * @param string $taxonomy_type
+	 */
 	function new_taxonomy( $path, $blog_id, $taxonomy_type ) {
 		$args  = $this->query_args();
 		$input = $this->input();
@@ -77,6 +82,12 @@ 
 	}
 
 	// /sites/%s/tags|categories/slug:%s -> $blog_id, $taxonomy_id
+
+	/**
+	 * @param string $path
+	 * @param integer $object_id
+	 * @param string $taxonomy_type
+	 */
 	function update_taxonomy( $path, $blog_id, $object_id, $taxonomy_type ) {
 		$taxonomy = get_term_by( 'slug', $object_id, $taxonomy_type );
 		$tax      = get_taxonomy( $taxonomy_type );
@@ -122,6 +133,12 @@ 
 	}
 
 	// /sites/%s/tags|categories/%s/delete -> $blog_id, $taxonomy_id
+
+	/**
+	 * @param string $path
+	 * @param integer $object_id
+	 * @param string $taxonomy_type
+	 */
 	function delete_taxonomy( $path, $blog_id, $object_id, $taxonomy_type ) {
 		$taxonomy = get_term_by( 'slug', $object_id, $taxonomy_type );
 		$tax      = get_taxonomy( $taxonomy_type );

modules/after-the-deadline/config-options.php

Doc Comments +9 added lines

@@ -6,6 +6,9 @@ 
 /*
  *   A convienence function to display the HTML for an AtD option
  */
+/**
+ * @param string $name
+ */
 function AtD_print_option( $name, $value, $options ) {
 	// Attribute-safe version of $name
 	$attr_name = sanitize_title($name); // Using sanitize_title since there's no comparable function for attributes
@@ -99,6 +102,9 @@ 
 /*
  *  Returns an array of AtD user options specified by $name
  */
+/**
+ * @param string $name
+ */
 function AtD_get_options( $user_id, $name ) {
 	$options_raw = AtD_get_setting( $user_id, $name, 'single' );
 
@@ -115,6 +121,9 @@ 
 /*
  *  Saves set of user options specified by $name from POST data
  */
+/**
+ * @param string $name
+ */
 function AtD_update_options( $user_id, $name ) {
 	/* We should probably run $_POST[name] through an esc_*() function... */
 	if ( isset( $_POST[$name] ) && is_array( $_POST[$name] ) ) {

modules/after-the-deadline/proxy.php

Doc Comments +1 added lines

@@ -6,6 +6,7 @@
 /**
  * Returns array with headers in $response[0] and body in $response[1]
  * Based on a function from Akismet
+ * @param string $request
  */
 function AtD_http_post( $request, $host, $path, $port = 80 ) {
 	$http_args = array(

modules/carousel/jetpack-carousel.php

Doc Comments +9 added lines

@@ -92,6 +92,9 @@ 
 		exit;
 	}
 
+	/**
+	 * @param string $version
+	 */
 	function asset_version( $version ) {
 		/**
 		 * Filter the version string used when enqueuing Carousel assets.
@@ -542,6 +545,9 @@ 
 		return ( 1 == $value ) ? 1 : 0;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function settings_checkbox($name, $label_text, $extra_text = '', $default_to_checked = true) {
 		if ( empty( $name ) )
 			return;
@@ -555,6 +561,9 @@ 
 		echo '</fieldset>';
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function settings_select($name, $values, $extra_text = '') {
 		if ( empty( $name ) || ! is_array( $values ) || empty( $values ) )
 			return;

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

Doc Comments +3 added lines, -2 removed lines

@@ -289,7 +289,7 @@ 
 	 * Get the value of a setting.
 	 * @param string $setting
 	 * @access public
-	 * @return mixed
+	 * @return string
 	 * @version 1.0
 	 */
 	function get_cfg($setting) {
@@ -358,7 +358,7 @@ 
 
 	/**
 	 * Adds a token to $this->tokens
-	 * @param mixed $type
+	 * @param integer $type
 	 * @param string $data
 	 * @param bool $do add a token even if preserve_css is off
 	 * @access private
@@ -1189,6 +1189,7 @@ 
 	 * format("abc, def, ghi") => format("abc, def, ghi")
 	 *
 	 * @param string
+	 * @param string $value
 	 * @return array
 	 */
 

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

Doc Comments +3 added lines

@@ -38,6 +38,9 @@
 /* ctype_alpha  Check for alphabetic character(s) */
 if (!function_exists('ctype_alpha')) {
 
+	/**
+	 * @param string $text
+	 */
 	function ctype_alpha($text) {
 		return preg_match("/[a-zA-Z]/", $text);
 	}

modules/custom-css/csstidy/class.csstidy_print.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/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/gravatar-hovercards.php

Doc Comments +1 added lines, -1 removed lines

@@ -139,7 +139,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 ) {
 	if ( is_numeric( $author ) ) {