Index: src/wp-admin/includes/menu.php =================================================================== --- src/wp-admin/includes/menu.php (revision 28076) +++ src/wp-admin/includes/menu.php (working copy) @@ -13,8 +13,8 @@ * * The hook fires before menus and sub-menus are removed based on user privileges. * - * @private * @since 3.1.0 + * @access private */ do_action( '_network_admin_menu' ); } elseif ( is_user_admin() ) { @@ -24,8 +24,8 @@ * * The hook fires before menus and sub-menus are removed based on user privileges. * - * @private * @since 3.1.0 + * @access private */ do_action( '_user_admin_menu' ); } else { @@ -35,8 +35,8 @@ * * The hook fires before menus and sub-menus are removed based on user privileges. * - * @private * @since 2.2.0 + * @access private */ do_action( '_admin_menu' ); } Index: src/wp-admin/includes/plugin-install.php =================================================================== --- src/wp-admin/includes/plugin-install.php (revision 28076) +++ src/wp-admin/includes/plugin-install.php (working copy) @@ -53,7 +53,7 @@ * * @since 2.7.0 * - * @param bool|object The result object. Default is false. + * @param bool|object $result The result object. Default false. * @param string $action The type of information being requested from the Plugin Install API. * @param object $args Plugin API arguments. */ Index: src/wp-admin/network/admin.php =================================================================== --- src/wp-admin/network/admin.php (revision 28076) +++ src/wp-admin/network/admin.php (working copy) @@ -22,7 +22,7 @@ * * @since 3.2.0 * - * @param bool $redirect_user_admin_request Whether the request should be redirected. + * @param bool $redirect_network_admin_request Whether the request should be redirected. */ $redirect_network_admin_request = apply_filters( 'redirect_network_admin_request', $redirect_network_admin_request ); if ( $redirect_network_admin_request ) { Index: src/wp-admin/options-discussion.php =================================================================== --- src/wp-admin/options-discussion.php (revision 28076) +++ src/wp-admin/options-discussion.php (working copy) @@ -80,7 +80,7 @@ * * @since 2.7.0. * - * @param int $10 The maximum depth of threaded comments. Default 10. + * @param int $max_depth The maximum depth of threaded comments. Default 10. */ $maxdeep = (int) apply_filters( 'thread_comments_depth_max', 10 ); Index: src/wp-admin/options-writing.php =================================================================== --- src/wp-admin/options-writing.php (revision 28076) +++ src/wp-admin/options-writing.php (working copy) @@ -38,11 +38,12 @@ } /** - * Toggle site update services configuration functionality. + * Filter whether the site update services configuration functionality is enabled. * * @since 3.0.0 * - * @param bool True or false, based on whether update services configuration is enabled or not. + * @param bool $enable_configuration Whether the update services configuration + * functionality is enabled. Default true. */ if ( apply_filters( 'enable_update_services_configuration', true ) ) { get_current_screen()->add_help_tab( array( Index: src/wp-admin/options.php =================================================================== --- src/wp-admin/options.php (revision 28076) +++ src/wp-admin/options.php (working copy) @@ -108,11 +108,11 @@ $whitelist_options['general'][] = 'WPLANG'; /** - * Toggle post-by-email functionality. + * Filter whether the post-by-email functionality is enabled. * * @since 3.0.0 * - * @param bool True or false, based on whether post-by-email configuration is enabled or not. + * @param bool $enabled Whether post-by-email configuration is enabled. Default true. */ if ( apply_filters( 'enable_post_by_email_configuration', true ) ) $whitelist_options['writing'] = array_merge($whitelist_options['writing'], $mail_options); Index: src/wp-admin/user/admin.php =================================================================== --- src/wp-admin/user/admin.php (revision 28076) +++ src/wp-admin/user/admin.php (working copy) @@ -18,11 +18,8 @@ $redirect_user_admin_request = ( ( $current_blog->domain != $current_site->domain ) || ( $current_blog->path != $current_site->path ) ); /** - * Filter whether a user should be redirected to the Global Dashboard in Multisite. + * Filter whether to redirect the request to the User Admin in Multisite. * - * Users not assigned to any sites in the network will be redirected to the Global - * Dashboard after logging in. - * * @since 3.2.0 * * @param bool $redirect_user_admin_request Whether the request should be redirected. Index: src/wp-includes/class-wp-embed.php =================================================================== --- src/wp-includes/class-wp-embed.php (revision 28076) +++ src/wp-includes/class-wp-embed.php (working copy) @@ -209,6 +209,8 @@ /** * Filter whether to inspect the given URL for discoverable tags. * + * @since 2.9.0 + * * @see WP_oEmbed::discover() * * @param bool false Whether to enable tag discovery. Default false. Index: src/wp-includes/class-wp-xmlrpc-server.php =================================================================== --- src/wp-includes/class-wp-xmlrpc-server.php (revision 28076) +++ src/wp-includes/class-wp-xmlrpc-server.php (working copy) @@ -5775,6 +5775,8 @@ sleep(1); $remote_ip = preg_replace( '/[^0-9a-fA-F:., ]/', '', $_SERVER['REMOTE_ADDR'] ); + + /** This filter is documented in wp-includes/class-http.php */ $user_agent = apply_filters( 'http_headers_useragent', 'WordPress/' . $GLOBALS['wp_version'] . '; ' . get_bloginfo( 'url' ) ); // Let's check the remote site Index: src/wp-includes/comment-template.php =================================================================== --- src/wp-includes/comment-template.php (revision 28076) +++ src/wp-includes/comment-template.php (working copy) @@ -518,7 +518,15 @@ $excerpt .= $blah[$i] . ' '; } $excerpt .= ($use_dotdotdot) ? '…' : ''; - return apply_filters('get_comment_excerpt', $excerpt); + + /** + * Filter the retrieved comment excerpt. + * + * @since 1.5.0 + * + * @param string $excerpt The comment excerpt text. + */ + return apply_filters( 'get_comment_excerpt', $excerpt ); } /** @@ -641,7 +649,7 @@ /** * Filter the returned post comments permalink. * - * @since + * @since 3.6.0 * * @param string $comments_link Post comments permalink with '#comments' appended. * @param int|WP_Post $post_id Post ID or WP_Post object. @@ -976,7 +984,7 @@ /** * Filter whether the current post is open for comments. * - * @since + * @since 2.5.0 * * @param bool $open Whether the current post is open for comments. * @param int|WP_Post $post_id The post ID or WP_Post object. @@ -997,6 +1005,15 @@ $_post = get_post($post_id); $open = ( 'open' == $_post->ping_status ); + + /** + * Filter whether the current post is open for pings. + * + * @since 2.5.0 + * + * @param bool $open Whether the current post is open for pings. + * @param int|WP_Post $post_id The post ID or WP_Post object. + */ return apply_filters( 'pings_open', $open, $post_id ); } @@ -2055,7 +2072,9 @@ $defaults = array( 'fields' => $fields, 'comment_field' => '

', + /** This filter is documented in wp-includes/link-template.php */ 'must_log_in' => '

' . sprintf( __( 'You must be logged in to post a comment.' ), wp_login_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ) . '

', + /** This filter is documented in wp-includes/link-template.php */ 'logged_in_as' => '

' . sprintf( __( 'Logged in as %2$s. Log out?' ), get_edit_user_link(), $user_identity, wp_logout_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ) . '

', 'comment_notes_before' => '

' . __( 'Your email address will not be published.' ) . ( $req ? $required_text : '' ) . '

', 'comment_notes_after' => '

' . sprintf( __( 'You may use these HTML tags and attributes: %s' ), ' ' . allowed_tags() . '' ) . '

', Index: src/wp-includes/l10n.php =================================================================== --- src/wp-includes/l10n.php (revision 28076) +++ src/wp-includes/l10n.php (working copy) @@ -53,7 +53,7 @@ if ( empty( $locale ) ) $locale = 'en_US'; - // duplicate_hook + /** This filter is documented in wp-includes/l10n.php */ return apply_filters( 'locale', $locale ); } @@ -424,9 +424,9 @@ * * @since 2.9.0 * - * @param boolean Whether to override the text domain. Default false. - * @param string $domain Text domain. Unique identifier for retrieving translated strings. - * @param string $mofile Path to the MO file. + * @param bool $override Whether to override the text domain. Default false. + * @param string $domain Text domain. Unique identifier for retrieving translated strings. + * @param string $mofile Path to the MO file. */ $plugin_override = apply_filters( 'override_load_textdomain', false, $domain, $mofile ); @@ -479,12 +479,12 @@ global $l10n; /** - * Filter text text domain for loading translation. + * Filter the text domain for loading translation. * * @since 3.0.0 * - * @param boolean Whether to override unloading the text domain. Default false. - * @param string $domain Text domain. Unique identifier for retrieving translated strings. + * @param bool $override Whether to override unloading the text domain. Default false. + * @param string $domain Text domain. Unique identifier for retrieving translated strings. */ $plugin_override = apply_filters( 'override_unload_textdomain', false, $domain ); @@ -591,7 +591,7 @@ * @return bool True when textdomain is successfully loaded, false otherwise. */ function load_muplugin_textdomain( $domain, $mu_plugin_rel_path = '' ) { - // duplicate_hook + /** This filter is documented in wp-includes/l10n.php */ $locale = apply_filters( 'plugin_locale', get_locale(), $domain ); $path = trailingslashit( WPMU_PLUGIN_DIR . '/' . ltrim( $mu_plugin_rel_path, '/' ) );