Ticket #25229: wp-admin-includes-plugin.3.diff

src/wp-admin/includes/plugin.php

@@ -541 +541 @@
 
                 if ( ! $silent ) {
                         /**
-                         * Fires before a plugin is activated in activate_plugin() when the $silent parameter is false
+                         * Fires before a plugin is activated in activate_plugin() when the $silent parameter is false.
                          * 
                          * @since 2.9.0
                          *
-                         * @param string $plugin       Basename of the plugin path from {@see activate_plugin()}.
-                         * @param bool   $network_wide Argument from {@see activate_plugin()}.
+                         * @param string $plugin       Plugin path to main plugin file with plugin data.
+                         * @param bool   $network_wide Whether to enable the plugin for all sites in the network
+                         *                             or just the current site. Multisite only. Default is false.
                          */
                         do_action( 'activate_plugin', $plugin, $network_wide );
 
                         /**
-                         * Fires before a plugin is activated in activate_plugin() when the $silent parameter is false
+                         * Fires before a plugin is activated in activate_plugin() when the $silent parameter is false.
                          * 
                          * The action concatenates the 'activate_' prefix with the $plugin value passed to
-                         * activate_plugin() to create a dynamically named action.
+                         * activate_plugin() to create a dynamically-named action.
                          * 
                          * @since 2.0.0
                          *
-                         * @param bool $network_wide Argument from {@see activate_plugin()}.
+                         * @param bool $network_wide Whether to enable the plugin for all sites in the network
+                         *                           or just the current site. Multisite only. Default is false.
                          */
                         do_action( 'activate_' . $plugin, $network_wide );
                 }
@@ -574 +576 @@
 
                 if ( ! $silent ) {
                         /**
-                         * Fires after a plugin has been activated in activate_plugin() when the $silent parameter is false
+                         * Fires after a plugin has been activated in activate_plugin() when the $silent parameter is false.
                          * 
                          * @since 2.9.0
                          *
-                         * @param string $plugin       Basename of the plugin path from {@see activate_plugin()}.
-                         * @param bool   $network_wide Argument from {@see activate_plugin()}.
+                         * @param string $plugin       Plugin path to main plugin file with plugin data.
+                         * @param bool   $network_wide Whether to enable the plugin for all sites in the network
+                         *                             or just the current site. Multisite only. Default is false.
                          */
                         do_action( 'activated_plugin', $plugin, $network_wide );
                 }