Docs: Miscellaneous docblock corrections in `wp-admin/includes/plugin.php`.

See #48303.
Built from https://develop.svn.wordpress.org/trunk@46695


git-svn-id: http://core.svn.wordpress.org/trunk@46495 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2019-11-11 00:05:01 +00:00
parent 2af39e45cb
commit 82dfb2d151
2 changed files with 18 additions and 17 deletions

View File

@ -1756,17 +1756,17 @@ function remove_submenu_page( $menu_slug, $submenu_slug ) {
} }
/** /**
* Get the url to access a particular menu page based on the slug it was registered with. * Get the URL to access a particular menu page based on the slug it was registered with.
* *
* If the slug hasn't been registered properly no url will be returned * If the slug hasn't been registered properly, no URL will be returned.
* *
* @since 3.0.0 * @since 3.0.0
* *
* @global array $_parent_pages * @global array $_parent_pages
* *
* @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu) * @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu).
* @param bool $echo Whether or not to echo the url - default is true * @param bool $echo Whether or not to echo the URL. Default true.
* @return string the url * @return string The menu page URL.
*/ */
function menu_page_url( $menu_slug, $echo = true ) { function menu_page_url( $menu_slug, $echo = true ) {
global $_parent_pages; global $_parent_pages;
@ -2186,7 +2186,8 @@ function remove_option_whitelist( $del_options, $options = '' ) {
* *
* @since 2.7.0 * @since 2.7.0
* *
* @param string $option_group A settings group name. This should match the group name used in register_setting(). * @param string $option_group A settings group name. This should match the group name
* used in register_setting().
*/ */
function settings_fields( $option_group ) { function settings_fields( $option_group ) {
echo "<input type='hidden' name='option_page' value='" . esc_attr( $option_group ) . "' />"; echo "<input type='hidden' name='option_page' value='" . esc_attr( $option_group ) . "' />";
@ -2195,11 +2196,11 @@ function settings_fields( $option_group ) {
} }
/** /**
* Clears the Plugins cache used by get_plugins() and by default, the Plugin Update cache. * Clears the plugins cache used by get_plugins() and by default, the plugin updates cache.
* *
* @since 3.7.0 * @since 3.7.0
* *
* @param bool $clear_update_cache Whether to clear the Plugin updates cache * @param bool $clear_update_cache Whether to clear the plugin updates cache. Default true.
*/ */
function wp_clean_plugins_cache( $clear_update_cache = true ) { function wp_clean_plugins_cache( $clear_update_cache = true ) {
if ( $clear_update_cache ) { if ( $clear_update_cache ) {
@ -2241,7 +2242,8 @@ function plugin_sandbox_scrape( $plugin ) {
* *
* @since 4.9.6 * @since 4.9.6
* *
* @param string $plugin_name The name of the plugin or theme that is suggesting content for the site's privacy policy. * @param string $plugin_name The name of the plugin or theme that is suggesting content
* for the site's privacy policy.
* @param string $policy_text The suggested content for inclusion in the policy. * @param string $policy_text The suggested content for inclusion in the policy.
*/ */
function wp_add_privacy_policy_content( $plugin_name, $policy_text ) { function wp_add_privacy_policy_content( $plugin_name, $policy_text ) {
@ -2287,7 +2289,7 @@ function wp_add_privacy_policy_content( $plugin_name, $policy_text ) {
* @since 5.2.0 * @since 5.2.0
* *
* @param string $plugin Path to the plugin file relative to the plugins directory. * @param string $plugin Path to the plugin file relative to the plugins directory.
* @return bool True, if in the list of paused plugins. False, not in the list. * @return bool True, if in the list of paused plugins. False, if not in the list.
*/ */
function is_plugin_paused( $plugin ) { function is_plugin_paused( $plugin ) {
if ( ! isset( $GLOBALS['_paused_plugins'] ) ) { if ( ! isset( $GLOBALS['_paused_plugins'] ) ) {
@ -2308,10 +2310,9 @@ function is_plugin_paused( $plugin ) {
* *
* @since 5.2.0 * @since 5.2.0
* *
* @param string $plugin Path to the plugin file relative to the plugins * @param string $plugin Path to the plugin file relative to the plugins directory.
* directory. * @return array|false Array of error information as returned by `error_get_last()`,
* @return array|false Array of error information as it was returned by * or false if none was recorded.
* `error_get_last()`, or false if none was recorded.
*/ */
function wp_get_plugin_error( $plugin ) { function wp_get_plugin_error( $plugin ) {
if ( ! isset( $GLOBALS['_paused_plugins'] ) ) { if ( ! isset( $GLOBALS['_paused_plugins'] ) ) {

View File

@ -13,7 +13,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '5.4-alpha-46694'; $wp_version = '5.4-alpha-46695';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.