Completed
Push — rm/deprecated-code ( 60e936...87d3e1 )
by Jeremy
38:33 queued 26:57
created
projects/plugins/jetpack/class.jetpack.php 1 patch
Doc Comments   +32 added lines, -14 removed lines patch added patch discarded remove patch
@@ -930,7 +930,7 @@  discard block
 block discarded – undo
930 930
 	 * This is ported over from the manage module, which has been deprecated and baked in here.
931 931
 	 *
932 932
 	 * @param $domains
933
-	 * @return array
933
+	 * @return string[]
934 934
 	 */
935 935
 	function allow_wpcom_domain( $domains ) {
936 936
 		if ( empty( $domains ) ) {
@@ -1278,7 +1278,7 @@  discard block
 block discarded – undo
1278 1278
 	/**
1279 1279
 	 * Does the network allow admins to add new users.
1280 1280
 	 *
1281
-	 * @return boolian
1281
+	 * @return boolean
1282 1282
 	 */
1283 1283
 	static function network_add_new_users( $option = null ) {
1284 1284
 		return (bool) get_site_option( 'add_new_users' );
@@ -1388,7 +1388,7 @@  discard block
 block discarded – undo
1388 1388
 	 *
1389 1389
 	 * @param  bool $option
1390 1390
 	 *
1391
-	 * @return boolean
1391
+	 * @return string
1392 1392
 	 */
1393 1393
 	public function is_main_network_option( $option ) {
1394 1394
 		// return '1' or ''
@@ -1399,7 +1399,7 @@  discard block
 block discarded – undo
1399 1399
 	 * Return true if we are with multi-site or multi-network false if we are dealing with single site.
1400 1400
 	 *
1401 1401
 	 * @param  string $option
1402
-	 * @return boolean
1402
+	 * @return string
1403 1403
 	 */
1404 1404
 	public function is_multisite( $option ) {
1405 1405
 		return (string) (bool) is_multisite();
@@ -1446,7 +1446,7 @@  discard block
 block discarded – undo
1446 1446
 	/**
1447 1447
 	 * Returns true if the site has file write access false otherwise.
1448 1448
 	 *
1449
-	 * @return string ( '1' | '0' )
1449
+	 * @return integer ( '1' | '0' )
1450 1450
 	 **/
1451 1451
 	public static function file_system_write_access() {
1452 1452
 		if ( ! function_exists( 'get_filesystem_method' ) ) {
@@ -2511,7 +2511,7 @@  discard block
 block discarded – undo
2511 2511
 	 *
2512 2512
 	 * @param string $tag Tag as it appears in each module heading.
2513 2513
 	 *
2514
-	 * @return mixed
2514
+	 * @return string
2515 2515
 	 */
2516 2516
 	public static function translate_module_tag( $tag ) {
2517 2517
 		return jetpack_get_module_i18n_tag( $tag );
@@ -2626,8 +2626,8 @@  discard block
 block discarded – undo
2626 2626
 	 * Rewrites ABSPATH (eg `/home/jetpack/wordpress/`) to ABSPATH, and if WP_CONTENT_DIR
2627 2627
 	 * is located outside of ABSPATH, rewrites that to WP_CONTENT_DIR.
2628 2628
 	 *
2629
-	 * @param $string
2630
-	 * @return mixed
2629
+	 * @param string $string
2630
+	 * @return string|null
2631 2631
 	 */
2632 2632
 	public static function alias_directories( $string ) {
2633 2633
 		// ABSPATH has a trailing slash.
@@ -2638,6 +2638,11 @@  discard block
 block discarded – undo
2638 2638
 		return $string;
2639 2639
 	}
2640 2640
 
2641
+	/**
2642
+	 * @param boolean $redirect
2643
+	 * @param boolean $send_state_messages
2644
+	 * @param boolean $requires_user_connection
2645
+	 */
2641 2646
 	public static function activate_default_modules(
2642 2647
 		$min_version = false,
2643 2648
 		$max_version = false,
@@ -2923,6 +2928,9 @@  discard block
 block discarded – undo
2923 2928
 		return self::update_active_modules( $new );
2924 2929
 	}
2925 2930
 
2931
+	/**
2932
+	 * @param string $module
2933
+	 */
2926 2934
 	public static function enable_module_configurable( $module ) {
2927 2935
 		$module = self::get_module_slug( $module );
2928 2936
 		add_filter( 'jetpack_module_configurable_' . $module, '__return_true' );
@@ -2951,6 +2959,10 @@  discard block
 block discarded – undo
2951 2959
 	}
2952 2960
 
2953 2961
 	/* Installation */
2962
+
2963
+	/**
2964
+	 * @param string $message
2965
+	 */
2954 2966
 	public static function bail_on_activation( $message, $deactivate = true ) {
2955 2967
 		?>
2956 2968
 <!doctype html>
@@ -2996,6 +3008,7 @@  discard block
 block discarded – undo
2996 3008
 	 * Attached to activate_{ plugin_basename( __FILES__ ) } by register_activation_hook()
2997 3009
 	 *
2998 3010
 	 * @static
3011
+	 * @param boolean $network_wide
2999 3012
 	 */
3000 3013
 	public static function plugin_activation( $network_wide ) {
3001 3014
 		Jetpack_Options::update_option( 'activated', 1 );
@@ -3741,7 +3754,7 @@  discard block
 block discarded – undo
3741 3754
 	 * Add help to the Jetpack page
3742 3755
 	 *
3743 3756
 	 * @since Jetpack (1.2.3)
3744
-	 * @return false if not the Jetpack page
3757
+	 * @return false|null if not the Jetpack page
3745 3758
 	 */
3746 3759
 	function admin_help() {
3747 3760
 		$current_screen = get_current_screen();
@@ -4474,6 +4487,7 @@  discard block
 block discarded – undo
4474 4487
 
4475 4488
 	/**
4476 4489
 	 * Record a stat for later output.  This will only currently output in the admin_footer.
4490
+	 * @param string $group
4477 4491
 	 */
4478 4492
 	function stat( $group, $detail ) {
4479 4493
 		$this->initialize_stats();
@@ -4839,6 +4853,9 @@  discard block
 block discarded – undo
4839 4853
 		return $url;
4840 4854
 	}
4841 4855
 
4856
+	/**
4857
+	 * @param string $actionurl
4858
+	 */
4842 4859
 	public static function nonce_url_no_esc( $actionurl, $action = -1, $name = '_wpnonce' ) {
4843 4860
 		$actionurl = str_replace( '&amp;', '&', $actionurl );
4844 4861
 		return add_query_arg( $name, wp_create_nonce( $action ), $actionurl );
@@ -5224,6 +5241,7 @@  discard block
 block discarded – undo
5224 5241
 	 * @param string $key
5225 5242
 	 * @param string $value
5226 5243
 	 * @param bool   $restate private
5244
+	 * @return string
5227 5245
 	 */
5228 5246
 	public static function state( $key = null, $value = null, $restate = false ) {
5229 5247
 		static $state = array();
@@ -5305,6 +5323,9 @@  discard block
 block discarded – undo
5305 5323
 		return true;
5306 5324
 	}
5307 5325
 
5326
+	/**
5327
+	 * @param string $file
5328
+	 */
5308 5329
 	public static function check_privacy( $file ) {
5309 5330
 		static $is_site_publicly_accessible = null;
5310 5331
 
@@ -5733,9 +5754,7 @@  discard block
 block discarded – undo
5733 5754
 	 *
5734 5755
 	 * Attached to `style_loader_src` filter.
5735 5756
 	 *
5736
-	 * @param string $tag The tag that would link to the external asset.
5737 5757
 	 * @param string $handle The registered handle of the script in question.
5738
-	 * @param string $href The url of the asset in question.
5739 5758
 	 */
5740 5759
 	public static function set_suffix_on_min( $src, $handle ) {
5741 5760
 		if ( false === strpos( $src, '.min.css' ) ) {
@@ -6111,8 +6130,8 @@  discard block
 block discarded – undo
6111 6130
 	 *  - Absolute URLs             `http://domain.com/feh.png`
6112 6131
 	 *  - Domain root relative URLs `/feh.png`
6113 6132
 	 *
6114
-	 * @param $css string: The raw CSS -- should be read in directly from the file.
6115
-	 * @param $css_file_url : The URL that the file can be accessed at, for calculating paths from.
6133
+	 * @param string $css string: The raw CSS -- should be read in directly from the file.
6134
+	 * @param string $css_file_url : The URL that the file can be accessed at, for calculating paths from.
6116 6135
 	 *
6117 6136
 	 * @return mixed|string
6118 6137
 	 */
@@ -6392,7 +6411,6 @@  discard block
 block discarded – undo
6392 6411
 	}
6393 6412
 
6394 6413
 	/**
6395
-	 * @param mixed $result Value for the user's option
6396 6414
 	 * @return mixed
6397 6415
 	 */
6398 6416
 	function get_user_option_meta_box_order_dashboard( $sorted ) {
Please login to merge, or discard this patch.