Automattic / jetpack

packages/options/legacy/class.jetpack-options.php

Doc Comments +10 added lines, -4 removed lines

@@ -16,7 +16,7 @@ 
 	 *
 	 * @param string $type The type of option to return. Defaults to 'compact'.
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public static function get_option_names( $type = 'compact' ) {
 		switch ( $type ) {
@@ -199,6 +199,9 @@ 
 		return $value;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	private static function update_grouped_option( $group, $name, $value ) {
 		$options = get_option( self::$grouped_options[ $group ] );
 		if ( ! is_array( $options ) ) {
@@ -301,6 +304,9 @@ 
 		return $result;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	private static function get_grouped_option( $group, $name, $default ) {
 		$options = get_option( self::$grouped_options[ $group ] );
 		if ( is_array( $options ) && isset( $options[ $name ] ) ) {
@@ -420,7 +426,7 @@ 
 	 * This function checks for a constant that, if present, will disable direct DB queries Jetpack uses to manage certain options and force Jetpack to always use Options API instead.
 	 * Options can be selectively managed via a blacklist by filtering option names via the jetpack_disabled_raw_option filter.
 	 *
-	 * @param $name Option name
+	 * @param string $name Option name
 	 *
 	 * @return bool
 	 */
@@ -445,7 +451,7 @@ 
 	 * @since 5.4.0
 	 *
 	 * @param boolean $strip_unsafe_options If true, and by default, will strip out options necessary for the connection to WordPress.com.
-	 * @return array An array of all options managed via the Jetpack_Options class.
+	 * @return string[] An array of all options managed via the Jetpack_Options class.
 	 */
 	static function get_all_jetpack_options( $strip_unsafe_options = true ) {
 		$jetpack_options            = self::get_option_names();
@@ -488,7 +494,7 @@ 
 	 *
 	 * @since 5.4.0
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	static function get_all_wp_options() {
 		// A manual build of the wp options

tools/import-translations.php

Doc Comments +1 added lines, -1 removed lines

@@ -22,7 +22,7 @@
 /**
  * Converts GlotPress URL into a GlotPress API URL
  *
- * @param sring $url URL
+ * @param string $url URL
  * @return sstring API URL
  */
 function apize_url( $url ) {

_inc/lib/plugins.php

Doc Comments +3 added lines

@@ -95,6 +95,9 @@
 		return (array) $upgrader->skin->get_upgrade_messages();
 	}
 
+	 /**
+	  * @param string $plugin_slug
+	  */
 	 protected static function generate_wordpress_org_plugin_download_link( $plugin_slug ) {
 		return "https://downloads.wordpress.org/plugin/$plugin_slug.latest-stable.zip";
 	 }

packages/autoloader/src/AutoloadGenerator.php

Doc Comments +2 added lines, -2 removed lines

@@ -160,7 +160,7 @@ 
 	 * @param string     $vendorPath Path to the vendor directory.
 	 * @param string     $basePath Base Path.
 	 *
-	 * @return array $classMap
+	 * @return string $classMap
 	 */
 	private function getClassMap( array $autoloads, Filesystem $filesystem, $vendorPath, $basePath ) {
 		$blacklist = null;
@@ -224,7 +224,7 @@ 
 	/**
 	 * Generate the PHP that will be used in the autoload_classmap_package.php files.
 	 *
-	 * @param srting $classMap class map array string that is to be written out to the file.
+	 * @param string $classMap class map array string that is to be written out to the file.
 	 *
 	 * @return string
 	 */

packages/analyzer/src/Declarations.php

Doc Comments +3 added lines

@@ -33,6 +33,9 @@
 		}
 	}
 
+	/**
+	 * @param string $root
+	 */
 	public function scan_dir( $root, $exclude = array() ) {
 
 		if ( is_null( $exclude ) || ! is_array( $exclude ) ) {

packages/analyzer/src/Invocations.php

Doc Comments +3 added lines

@@ -37,6 +37,9 @@
 		}
 	}
 
+	/**
+	 * @param string $root
+	 */
 	public function scan_dir( $root, $exclude = array() ) {
 		$filter = function ( $file, $key, $iterator ) use ( $exclude ) {
 			if ( $iterator->hasChildren() && ! in_array( $file->getFilename(), $exclude ) ) {

packages/analyzer/src/Invocations/Visitor.php

Doc Comments +3 added lines

@@ -9,6 +9,9 @@
 	private $invocations;
 	private $file_path;
 
+	/**
+	 * @param  $invocations
+	 */
 	public function __construct( $file_path, $invocations ) {
 		$this->file_path   = $file_path;
 		$this->invocations = $invocations;

packages/analyzer/src/PersistentList.php

Doc Comments +1 added lines

@@ -31,6 +31,7 @@
 
 	/**
 	 * Saves the items to a file and returns the file contents
+	 * @param string $file_path
 	 */
 	public function save( $file_path, $allow_empty = true ) {
 

packages/analyzer/src/Declarations/Visitor.php

Doc Comments +3 added lines

@@ -11,6 +11,9 @@
 	private $declarations;
 	private $current_relative_path;
 
+	/**
+	 * @param  $declarations
+	 */
 	public function __construct( $current_relative_path, $declarations ) {
 		$this->current_relative_path = $current_relative_path;
 		$this->declarations          = $declarations;