Automattic / jetpack

_inc/lib/class.media-extractor.php

Doc Comments +1 added lines, -1 removed lines

@@ -74,7 +74,7 @@
 	 * NOTE: If you want IMAGES, call extract( $blog_id, $post_id, ...) which will give you more/better image extraction
 	 * This method will give you an error if you ask for IMAGES.
 	 *
-	 * @param $content The HTML post_content of a post
+	 * @param string $content The HTML post_content of a post
 	 * @param $what_to_extract (int) A mask of things to extract, e.g. Jetpack_Media_Meta_Extractor::IMAGES | Jetpack_Media_Meta_Extractor::MENTIONS
 	 * @param $already_extracted (array) Previously extracted things, e.g. images from extract(), which can be used for x-referencing here
 	 * @returns a structure containing metadata about the embedded things, or empty array if nothing found, or WP_Error on error

_inc/lib/icalendar-reader.php

Doc Comments +2 added lines, -4 removed lines

@@ -699,8 +699,7 @@ 
 	 * Render the events
 	 *
 	 * @param string $url (default: '')
-	 * @param string $context (default: 'widget') or 'shortcode'
-	 * @return mixed bool|string false on failure, rendered HTML string on success.
+	 * @return false|string bool|string false on failure, rendered HTML string on success.
 	 */
 	public function render( $url = '', $args = array() ) {
 
@@ -857,8 +856,7 @@ 
  * Wrapper function for iCalendarReader->render()
  *
  * @param string $url (default: '')
- * @param string $context (default: 'widget') or 'shortcode'
- * @return mixed bool|string false on failure, rendered HTML string on success.
+ * @return false|string bool|string false on failure, rendered HTML string on success.
  */
 function icalendar_render_events( $url = '', $args = array() ) {
 	$ical = new iCalendarReader();

3rd-party/domain-mapping.php

Doc Comments +10 added lines

@@ -93,14 +93,24 @@
 	 * So that we can test.
 	 */
 
+	/**
+	 * @param string $class
+	 * @param string $method
+	 */
 	public function method_exists( $class, $method ) {
 		return method_exists( $class, $method );
 	}
 
+	/**
+	 * @param string $class
+	 */
 	public function class_exists( $class ) {
 		return class_exists( $class );
 	}
 
+	/**
+	 * @param string $function
+	 */
 	public function function_exists( $function ) {
 		return function_exists( $function );
 	}

class.jetpack-autoupdate.php

Doc Comments +1 added lines, -1 removed lines

@@ -163,7 +163,7 @@
 	/**
 	 * Iterates through expected items ( plugins or themes ) and compares them to actual results.
 	 *
-	 * @param $items 'plugin' or 'theme'
+	 * @param string $items 'plugin' or 'theme'
 	 */
 	private function log_items( $items ) {
 		if ( ! isset( $this->expected[ $items ] ) ) {

3rd-party/qtranslate-x.php

Doc Comments +1 added lines, -1 removed lines

@@ -8,7 +8,7 @@
  * @param string $url_orig Original URL.
  * @param array $url_info  Pieces of original URL.
  *
- * @return bool
+ * @return false|string
  */
 function jetpack_no_qtranslate_rest_url_redirect( $url_lang, $url_orig, $url_info ) {
 	if ( false !== strpos( $url_info['wp-path'], 'wp-json/jetpack' ) ) {

_inc/lib/functions.wp-notify.php

Doc Comments +1 added lines, -1 removed lines

@@ -201,7 +201,7 @@
 	 * should be notified, overriding the site setting.
 	 *
 	 * @param int $comment_id Comment ID.
-	 * @return true Always returns true.
+	 * @return boolean Always returns true.
 	 */
 	function wp_notify_moderator( $comment_id ) {
 		global $wpdb;

_inc/lib/class.jetpack-search-performance-logger.php

Doc Comments +4 added lines

@@ -58,6 +58,10 @@
 		return $query->is_main_query() && $query->is_search();
 	}
 
+	/**
+	 * @param double $duration
+	 * @param boolean $was_jetpack_search
+	 */
 	private function record_query_time( $duration, $was_jetpack_search ) {
 		$this->stats[] = array( $was_jetpack_search, intval( $duration * 1000 ) );
 	}

_inc/lib/markdown/extra.php

Doc Comments +27 added lines, -1 removed lines

@@ -69,7 +69,7 @@ 
  *
  * @since 5.9
  *
- * @return string Length of the multibyte string
+ * @return integer Length of the multibyte string
  *
  */
 function jetpack_utf8_strlen( $text ) {
@@ -169,6 +169,9 @@ 
 	}
 
 
+	/**
+	 * @param string $text
+	 */
 	function transform($text) {
 	#
 	# Main function. Performs some preprocessing on the input text
@@ -903,6 +906,10 @@ 
 
 	public $list_level = 0;
 
+	/**
+	 * @param string $list_str
+	 * @param string $marker_any_re
+	 */
 	function processListItems($list_str, $marker_any_re) {
 	#
 	#	Process the contents of a single ordered or unordered list, splitting it
@@ -1006,6 +1013,9 @@ 
 	}
 
 
+	/**
+	 * @param string $code
+	 */
 	function makeCodeSpan($code) {
 	#
 	# Create a code span markup for $code. Called from handleSpanToken.
@@ -1498,6 +1508,9 @@ 
 	# hanlde UTF-8 if the default function does not exist.
 	public $utf8_strlen = 'mb_strlen';
 
+	/**
+	 * @param string $text
+	 */
 	function detab($text) {
 	#
 	# Replace tabs with the appropriate amount of space.
@@ -2042,6 +2055,12 @@ 
 
 		return array($parsed, $text);
 	}
+
+	/**
+	 * @param string $text
+	 * @param string $hash_method
+	 * @param boolean $md_attr
+	 */
 	function _hashHTMLBlocks_inHTML($text, $hash_method, $md_attr) {
 	#
 	# Parse HTML, calling _HashHTMLBlocks_InMarkdown for block tags.
@@ -2706,6 +2725,9 @@ 
 	}
 
 
+	/**
+	 * @return string
+	 */
 	function processDefListItems($list_str) {
 	#
 	#	Process the contents of a single definition list, splitting it
@@ -2817,6 +2839,10 @@ 
 
 		return $text;
 	}
+
+	/**
+	 * @param string[] $matches
+	 */
 	function _doFencedCodeBlocks_callback($matches) {
 		$classname =& $matches[2];
 		$attrs     =& $matches[3];

docker/mu-plugins/debug.php

Doc Comments +1 added lines

@@ -40,6 +40,7 @@
  * l($arg1, $arg2) will call l($arg1) and l($arg2) and then return $arg1.
  *
  * A null argument will log the file and line number of the l() call.
+ * @param string $stuff
  */
 function l( $stuff = null ) {
 	// Do nothing when debugging is off