Ticket #30191: 30191.diff

src/wp-admin/includes/class-wp-list-table.php

@@ -184 +184 @@
 
         /**
          * Checks the current user's permissions
-         * @uses wp_die()
          *
          * @since 3.1.0
          * @access public

src/wp-admin/includes/class-wp-themes-list-table.php

@@ -255 +255 @@
          *
          * @since 3.4.0
          * @access public
-         *
-         * @uses $this->features Array of all feature search terms.
-         * @uses get_pagenum()
-         * @uses _pagination_args['total_pages']
          */
         public function _js_vars( $extra_args = array() ) {
                 $search_string = isset( $_REQUEST['s'] ) ? esc_attr( wp_unslash( $_REQUEST['s'] ) ) : '';

src/wp-admin/includes/file.php

@@ -50 +50 @@
  *
  * @since 1.5.0
  *
- * @uses _cleanup_header_comment
  * @uses $wp_file_descriptions
  * @param string $file Filesystem path or filename
  * @return string Description of file from $wp_file_descriptions or basename of $file if description doesn't exist
@@ -75 +74 @@
  *
  * @since 1.5.0
  *
- * @uses get_option
  * @return string Full filesystem path to the root of the WordPress installation
  */
 function get_home_path() {
@@ -163 +161 @@
  *
  * @since 1.5.0
  *
- * @uses wp_die
- * @uses validate_file
  * @param string $file file the users is attempting to edit
  * @param array $allowed_files Array of allowed files to edit, $file must match an entry exactly
  * @return null

src/wp-admin/includes/ms.php

@@ -395 +395 @@
  * Get the remaining upload space for this blog.
  *
  * @since MU
- * @uses upload_is_user_over_quota()
- * @uses get_space_allowed()
- * @uses get_upload_space_available()
  *
  * @param int $size Current max size in bytes
  * @return int Max size in bytes

src/wp-admin/includes/nav-menu.php

@@ -550 +550 @@
  * @since 3.6.0
  *
  * @uses global $one_theme_location_no_menus to determine if no menus exist
- * @uses disabled() to output the disabled attribute in $other_attributes param in submit_button()
  *
  * @param int|string $nav_menu_selected_id (id, name or slug) of the currently-selected menu
  * @return string Disabled attribute if at least one menu exists, false if not
@@ -1247 +1246 @@
  *
  * @since 3.6.0
  *
- * @uses wp_get_nav_menu_items() to retrieve the nav menu's menu items
- * @uses wp_defer_term_counter() to enable then disable term counting
- *
  * @param int|string $nav_menu_selected_id (id, slug, or name ) of the currently-selected menu
  * @param string $nav_menu_selected_title Title of the currently-selected menu
  * @return array $messages The menu updated message

src/wp-admin/includes/post.php

@@ -1069 +1069 @@
 /**
  * Returns the list of classes to be used by a metabox
  *
- * @uses get_user_option()
  * @since 2.5.0
  *
  * @param unknown_type $id
@@ -1500 +1499 @@
  * @subpackage Post_Revisions
  * @since 2.6.0
  *
- * @uses _wp_translate_postdata()
- * @uses _wp_post_revision_fields()
- *
  * @param mixed $post_data Associative array containing the post data or int post ID.
  * @return mixed The autosave revision ID. WP_Error or 0 on error.
  */
@@ -1566 +1562 @@
  * @package WordPress
  * @since 2.7.0
  *
- * @uses get_post_status()
- * @uses edit_post()
- * @uses get_post()
- * @uses current_user_can()
- * @uses wp_die()
- * @uses wp_create_post_autosave()
- * @uses add_query_arg()
- * @uses wp_create_nonce()
- *
  * @return str URL to redirect to show the preview
  */
 function post_preview() {

src/wp-admin/includes/screen.php

@@ -177 +177 @@
  * Set the current screen object
  *
  * @since 3.0.0
- * @uses $current_screen
  *
  * @param mixed $hook_name Optional. The hook name (also known as the hook suffix) used to determine the screen,
  *      or an existing screen object.

src/wp-admin/includes/template.php

@@ -1466 +1466 @@
  * The password is passed through {@link esc_attr()} to ensure that it
  * is safe for placing in an html attribute.
  *
- * @uses attr
  * @since 2.7.0
  */
 function the_post_password() {
@@ -1499 +1498 @@
  * A simple wrapper to display the "s" parameter in a GET URI. This function
  * should only be used when {@link the_search_query()} cannot.
  *
- * @uses attr
  * @since 2.7.0
  *
  */

src/wp-includes/author-template.php

@@ -16 +16 @@
  * @since 1.5.0
  *
  * @uses $authordata The current author's DB object.
- * @uses apply_filters() Calls 'the_author' hook on the author display name.
  *
  * @param string $deprecated Deprecated.
  * @return string The author's display name.
@@ -71 +70 @@
  *
  * @since 2.8.0
  *
- * @uses $post The current post's DB object.
- * @uses get_post_meta() Retrieves the ID of the author who last edited the current post.
- * @uses get_userdata() Retrieves the author's DB object.
- * @uses apply_filters() Calls 'the_modified_author' hook on the author display name.
  * @return string The author's display name.
  */
 function get_the_modified_author() {
@@ -108 +103 @@
  * Retrieve the requested data of the author of the current post.
  * @link http://codex.wordpress.org/Template_Tags/the_author_meta
  * @since 2.8.0
- * @uses $authordata The current author's DB object (if $user_id not specified).
  * @param string $field selects the field of the users record.
  * @param int $user_id Optional. User ID.
  * @return string The author's field from the current author's DB object.
@@ -168 +162 @@
  *
  * If the author has a home page set, return an HTML link, otherwise just return the
  * author's name.
- *
- * @uses get_the_author_meta()
- * @uses get_the_author()
  */
 function get_the_author_link() {
         if ( get_the_author_meta('url') ) {
@@ -189 +180 @@
  * @link http://codex.wordpress.org/Template_Tags/the_author_link
  *
  * @since 2.1.0
- *
- * @uses get_the_author_link()
  */
 function the_author_link() {
         echo get_the_author_link();
@@ -201 +190 @@
  *
  * @since 1.5.0
  *
- * @uses $post The current post in the Loop's DB object.
- * @uses count_user_posts()
  * @return int The number of posts by the author.
  */
 function get_the_author_posts() {
@@ -218 +205 @@
  *
  * @link http://codex.wordpress.org/Template_Tags/the_author_posts
  * @since 0.71
- * @uses get_the_author_posts() Echoes returned value from function.
  */
 function the_author_posts() {
         echo get_the_author_posts();
@@ -233 +219 @@
  *
  * @link http://codex.wordpress.org/Template_Tags/the_author_posts_link
  * @since 1.2.0
- * @uses $authordata The current author's DB object.
- * @uses get_author_posts_url()
- * @uses get_the_author()
  * @param string $deprecated Deprecated.
  */
 function the_author_posts_link($deprecated = '') {

src/wp-includes/bookmark.php

@@ -60 +60 @@
  * Retrieve single bookmark data item or field.
  *
  * @since 2.3.0
- * @uses get_bookmark() Gets bookmark object using $bookmark as ID
- * @uses sanitize_bookmark_field() Sanitizes Bookmark field based on $context.
  *
  * @param string $field The name of the data field to return
  * @param int $bookmark The bookmark ID to get field
@@ -407 +405 @@
  * Deletes bookmark cache
  *
  * @since 2.7.0
- * @uses wp_cache_delete() Deletes the contents of 'get_bookmarks'
  */
 function clean_bookmark_cache( $bookmark_id ) {
         wp_cache_delete( $bookmark_id, 'bookmark' );

src/wp-includes/category-template.php

@@ -66 +66 @@
  * Retrieve post categories.
  *
  * @since 0.71
- * @uses $post
  *
  * @param int $id Optional, default to current post ID. The post ID.
  * @return array
@@ -248 +247 @@
  * As of 2.7, the function can be used anywhere if it is provided a post ID or post object.
  *
  * @since 1.2.0
- * @uses has_category()
  *
  * @param int|string|array $category Category ID, name or slug, or array of said.
  * @param int|object $post Optional. Post to check instead of the current post. (since 2.7.0)

src/wp-includes/category.php

@@ -63 +63 @@
  * The category will converted to maintain backwards compatibility.
  *
  * @since 1.5.1
- * @uses get_term() Used to get the category data from the taxonomy.
  *
  * @param int|object $category Category ID or Category row object
  * @param string $output Optional. Constant OBJECT, ARRAY_A, or ARRAY_N
@@ -210 +209 @@
  * Sanitizes category data based on context.
  *
  * @since 2.3.0
- * @uses sanitize_term() See this function for what context are supported.
  *
  * @param object|array $category Category data
  * @param string $context Optional. Default is 'display'.
@@ -224 +222 @@
  * Sanitizes data in single category key field.
  *
  * @since 2.3.0
- * @uses sanitize_term_field() See function for more details.
  *
  * @param string $field Category key to sanitize
  * @param mixed $value Category value to sanitize
@@ -243 +240 @@
  *
  * @since 2.3.0
  * @see get_terms() For list of arguments to pass.
- * @uses apply_filters() Calls 'get_tags' hook on array of tags and with $args.
  *
  * @param string|array $args Tag arguments to use when retrieving tags.
  * @return array List of tags.
@@ -297 +293 @@
  * Remove the category cache data based on ID.
  *
  * @since 2.1.0
- * @uses clean_term_cache() Clears the cache for the category based on ID
  *
  * @param int $id Category ID
  */

src/wp-includes/class-http.php

@@ -1785 +1785 @@
          * some proxies can not handle this. We also have the constant available for defining other
          * hosts that won't be sent through the proxy.
          *
-         * @uses WP_PROXY_BYPASS_HOSTS
          * @since 2.8.0
          *
          * @param string $uri URI to check.

src/wp-includes/class-oembed.php

@@ -565 +565 @@
  * @access private
  *
  * @see WP_oEmbed
- * @uses WP_oEmbed
  *
  * @return WP_oEmbed object.
  */

src/wp-includes/class-wp-customize-manager.php

@@ -1283 +1283 @@
  * Returns either '', a 3 or 6 digit hex color (without a #), or null.
  *
  * @since 3.4.0
- * @uses sanitize_hex_color()
  *
  * @param string $color
  * @return string|null

src/wp-includes/class-wp-customize-setting.php

@@ -556 +556 @@
 
         /**
          * @since 3.4.0
-         * @uses remove_theme_mod()
          *
          * @param $value
          */

src/wp-includes/class-wp-embed.php

@@ -43 +43 @@
          * calls {@link do_shortcode()}, and then re-registers the old shortcodes.
          *
          * @uses $shortcode_tags
-         * @uses remove_all_shortcodes()
-         * @uses add_shortcode()
-         * @uses do_shortcode()
          *
          * @param string $content Content to parse
          * @return string Content with shortcode parsed
@@ -122 +119 @@
          * Attempts to convert a URL into embed HTML. Starts by checking the URL against the regex of the registered embed handlers.
          * If none of the regex matches and it's enabled, then the URL will be given to the {@link WP_oEmbed} class.
          *
-         * @uses wp_oembed_get()
-         * @uses wp_parse_args()
-         * @uses wp_embed_defaults()
-         * @uses WP_Embed::maybe_make_link()
-         * @uses get_option()
-         * @uses author_can()
-         * @uses wp_cache_get()
-         * @uses wp_cache_set()
-         * @uses get_post_meta()
-         * @uses update_post_meta()
-         *
          * @param array $attr {
          *     Shortcode attributes. Optional.
          *
@@ -332 +318 @@
         /**
          * Callback function for {@link WP_Embed::autoembed()}.
          *
-         * @uses WP_Embed::shortcode()
-         *
          * @param array $match A regex match array.
          * @return string The embed HTML on success, otherwise the original URL.
          */

src/wp-includes/class-wp-theme.php

@@ -855 +855 @@
          * for all other URLs returned by WP_Theme, so we pass it to the public function
          * get_theme_root_uri() and allow it to run the theme_root_uri filter.
          *
-         * @uses get_theme_root_uri()
-         *
          * @since 3.4.0
          * @access public
          *

src/wp-includes/class-wp.php

@@ -532 +532 @@
         /**
          * Set up the Loop based on the query variables.
          *
-         * @uses WP::$query_vars
          * @since 2.0.0
          */
         public function query_posts() {

src/wp-includes/comment.php

@@ -853 +853 @@
  * Add meta data field to a comment.
  *
  * @since 2.9.0
- * @uses add_metadata
  * @link http://codex.wordpress.org/Function_Reference/add_comment_meta
  *
  * @param int $comment_id Comment ID.
@@ -874 +873 @@
  * allows removing all metadata matching key, if needed.
  *
  * @since 2.9.0
- * @uses delete_metadata
  * @link http://codex.wordpress.org/Function_Reference/delete_comment_meta
  *
  * @param int $comment_id comment ID
@@ -890 +888 @@
  * Retrieve comment meta field for a comment.
  *
  * @since 2.9.0
- * @uses get_metadata
  * @link http://codex.wordpress.org/Function_Reference/get_comment_meta
  *
  * @param int $comment_id Comment ID.
@@ -912 +909 @@
  * If the meta field for the comment does not exist, it will be added.
  *
  * @since 2.9.0
- * @uses update_metadata
  * @link http://codex.wordpress.org/Function_Reference/update_comment_meta
  *
  * @param int $comment_id Comment ID.
@@ -1250 +1246 @@
  * Calculate what page number a comment will appear on for comment paging.
  *
  * @since 2.7.0
- * @uses get_comment() Gets the full comment of the $comment_ID parameter.
- * @uses get_option() Get various settings to control function and defaults.
- * @uses get_page_of_comment() Used to loop up to top level comment.
  *
  * @param int $comment_ID Comment ID.
  * @param array $args Optional args.
@@ -1440 +1433 @@
  *
  * @since 2.0.0
  * @uses $wpdb
- * @uses wp_transition_comment_status() Passes new and old comment status along with $comment object
  *
  * @param int $comment_id Comment ID
  * @param bool $force_delete Whether to bypass trash and force deletion. Default is false.
@@ -1507 +1499 @@
  *
  * @since 2.9.0
  *
- * @uses wp_delete_comment() if trash is disabled
- *
  * @param int $comment_id Comment ID.
  * @return bool True on success, false on failure.
  */
@@ -2043 +2033 @@
  * If the comment status is not in the list, then false is returned.
  *
  * @since 1.0.0
- * @uses wp_transition_comment_status() Passes new and old comment status along with $comment object
  *
  * @param int $comment_id Comment ID.
  * @param string $comment_status New comment status, either 'hold', 'approve', 'spam', or 'trash'.
@@ -2114 +2103 @@
  *
  * @since 2.0.0
  * @uses $wpdb
- * @uses wp_transition_comment_status() Passes new and old comment status along with $comment object
  *
  * @param array $commentarr Contains information on the comment.
  * @return int Comment was updated if value is 1, or was not updated if value is 0.
@@ -2466 +2454 @@
  *
  * @since 0.71
  * @uses $wp_version
- * @uses IXR_Client
  *
  * @param string $content Post content to check for links.
  * @param int $post_ID Post ID.
@@ -2609 +2596 @@
  *
  * @since 1.2.0
  * @uses $wp_version
- * @uses IXR_Client
  *
  * @param string $server Host of blog to connect to.
  * @param string $path Path to send the ping.

src/wp-includes/deprecated.php

@@ -1699 +1699 @@
  * and the rest of the content will be removed.
  *
  * @since 0.71
- * @uses apply_filters() Calls 'the_content_rss' on the content before processing.
  *
  * @deprecated 2.9.0
  * @deprecated Use the_content_feed()
@@ -1807 +1806 @@
  * contains a context after its last vertical bar.
  *
  * @since 2.5.0
- * @uses translate()
  * @deprecated 3.0.0
  * @deprecated Use _x()
  * @see _x()
@@ -3152 +3150 @@
  * @since 2.0.0
  * @deprecated 3.4.0
  *
- * @uses do_action() Will call the 'clean_page_cache' hook action.
- *
  * @param int $id Page ID to clean
  */
 function clean_page_cache( $id ) {

src/wp-includes/feed.php

@@ -71 +71 @@
  * 'default_feed' filter.
  *
  * @since 2.5.0
- * @uses apply_filters() Calls 'default_feed' hook on the default feed string.
  *
  * @return string Default feed, or for example 'rss2', 'atom', etc.
  */
@@ -165 +164 @@
  * Display the post title in the feed.
  *
  * @since 0.71
- * @uses get_the_title_rss() Used to retrieve current post title.
  */
 function the_title_rss() {
         echo get_the_title_rss();
@@ -203 +201 @@
  * Display the post content for feeds.
  *
  * @since 2.9.0
- * @uses apply_filters() Calls 'the_content_feed' on the content before processing.
- * @see get_the_content()
  *
  * @param string $feed_type The type of feed. rss2 | atom | rss | rdf
  */
@@ -313 +309 @@
  * Retrieve the current comment author for use in the feeds.
  *
  * @since 2.0.0
- * @uses get_comment_author()
  *
  * @return string Comment Author
  */
@@ -343 +338 @@
  * Display the current comment content for use in the feeds.
  *
  * @since 1.0.0
- * @uses get_comment_text()
  */
 function comment_text_rss() {
         $comment_text = get_comment_text();
@@ -454 +448 @@
  * attributes.
  *
  * @since 1.5.0
- * @uses get_post_custom() To get the current post enclosure metadata.
  */
 function rss_enclosure() {
         if ( post_password_required() )
@@ -494 +487 @@
  * enclosure(s) consist of link HTML tag(s) with a URI and other attributes.
  *
  * @since 2.2.0
- * @uses get_post_custom() To get the current post enclosure metadata.
  */
 function atom_enclosure() {
         if ( post_password_required() )

src/wp-includes/formatting.php

@@ -1226 +1226 @@
  * Used for querying the database for a value from URL.
  *
  * @since 3.1.0
- * @uses sanitize_title()
  *
  * @param string $title The string to be sanitized.
  * @return string The sanitized string.
@@ -2230 +2229 @@
  *
  * @since 1.2.0
  *
- * @uses get_option() to retrieve the value of 'gmt_offset'.
  * @param string $string The date to be converted.
  * @param string $format The format string for the returned date (default is Y-m-d H:i:s)
  * @return string GMT version of the date provided.
@@ -3023 +3021 @@
  * is applied to the returned cleaned URL.
  *
  * @since 2.8.0
- * @uses wp_kses_bad_protocol() To only permit protocols in the URL set
- *              via $protocols or the common ones set in the function.
  *
  * @param string $url The URL to be cleaned.
  * @param array $protocols Optional. An array of acceptable protocols.
@@ -3082 +3078 @@
  * Performs esc_url() for database usage.
  *
  * @since 2.8.0
- * @uses esc_url()
  *
  * @param string $url The URL to be cleaned.
  * @param array $protocols An array of acceptable protocols.
@@ -3478 +3473 @@
  *
  * KSES already converts lone greater than signs.
  *
- * @uses wp_pre_kses_less_than_callback in the callback function.
  * @since 2.3.0
  *
  * @param string $text Text to be converted.
@@ -3491 +3485 @@
 /**
  * Callback function used by preg_replace.
  *
- * @uses esc_html to format the $matches text.
  * @since 2.3.0
  *
  * @param array $matches Populated by matches to preg_replace.

src/wp-includes/functions.php

@@ -2274 +2274 @@
  *
  * @since 2.8.6
  *
- * @uses wp_get_upload_mime_types() to fetch the list of mime types
- *
  * @param int|WP_User $user Optional. User to check. Defaults to current user.
  * @return array Array of mime types keyed by the file extension regex corresponding
  *               to those types.
@@ -3200 +3198 @@
  * Append the Widgets menu to the themes main menu.
  *
  * @since 2.2.0
- *
- * @uses $submenu The administration submenu list.
  */
 function wp_widgets_add_menu() {
         global $submenu;

src/wp-includes/general-template.php

@@ -17 +17 @@
  *
  * @since 1.5.0
  *
- * @uses locate_template()
- *
  * @param string $name The name of the specialised header.
  */
 function get_header( $name = null ) {
@@ -59 +57 @@
  *
  * @since 1.5.0
  *
- * @uses locate_template()
- *
  * @param string $name The name of the specialised footer.
  */
 function get_footer( $name = null ) {
@@ -101 +97 @@
  *
  * @since 1.5.0
  *
- * @uses locate_template()
- *
  * @param string $name The name of the specialised sidebar.
  */
 function get_sidebar( $name = null ) {
@@ -150 +144 @@
  *
  * @since 3.0.0
  *
- * @uses locate_template()
- *
  * @param string $slug The slug name for the generic template.
  * @param string $name The name of the specialised template.
  */
@@ -307 +299 @@
  *
  * @since 2.7.0
  *
- * @uses wp_nonce_url() To protect against CSRF.
- * @uses site_url() To generate the log out URL.
- *
  * @param string $redirect Path to redirect to on logout.
  * @return string A log out URL.
  */
@@ -340 +329 @@
  *
  * @since 2.7.0
  *
- * @uses site_url() To generate the log in URL.
- *
  * @param string $redirect Path to redirect to on login.
  * @param bool $force_reauth Whether to force reauthorization, even if a cookie is present. Default is false.
  * @return string A log in URL.
@@ -373 +360 @@
  *
  * @since 3.6.0
  *
- * @uses site_url() To generate the registration URL.
- *
  * @return string User registration URL.
  */
 function wp_registration_url() {
@@ -496 +481 @@
  *
  * @since 2.8.0
  *
- * @uses site_url() To generate the lost password URL
- *
  * @param string $redirect Path to redirect to on login.
  * @return string Lost password URL.
  */
@@ -1429 +1412 @@
  * no posts for the month, then it will not be displayed.
  *
  * @since 1.0.0
- * @uses calendar_week_mod()
  *
  * @param bool $initial Optional, default is true. Use initial calendar names.
  * @param bool $echo Optional, default is true. Set to false for return.
@@ -1711 +1693 @@
  *
  * @since 0.71
  *
- * @uses get_the_date()
  * @param string $d Optional. PHP date format defaults to the date_format option if not specified.
  * @param string $before Optional. Output before the date.
  * @param string $after Optional. Output after the date.
@@ -2032 +2013 @@
  *
  * @since 0.71
  * @uses $wp_locale
- * @uses $post
  */
 function the_weekday() {
         global $wp_locale;
@@ -2358 +2338 @@
  * to ensure that it is safe for placing in an html attribute.
  *
  * @since 2.3.0
- * @uses esc_attr()
  *
  * @param bool $escaped Whether the result is escaped. Default true.
  *      Only use when you are later escaping it. Do not use unescaped.
@@ -2385 +2364 @@
  * The search query string is passed through {@link esc_attr()}
  * to ensure that it is safe for placing in an html attribute.
  *
- * @uses esc_attr()
  * @since 2.1.0
  */
 function the_search_query() {

src/wp-includes/kses.php

@@ -661 +661 @@
  *
  * @access private
  * @since 1.0.0
- * @uses wp_kses_attr()
  *
  * @param string $string Content to filter
  * @param array $allowed_html Allowed HTML elements
@@ -1318 +1317 @@
  * Sanitize content with allowed HTML Kses rules.
  *
  * @since 1.0.0
- * @uses $allowedtags
  *
  * @param string $data Content to filter, expected to be escaped with slashes
  * @return string Filtered content
@@ -1331 +1329 @@
  * Sanitize content with allowed HTML Kses rules.
  *
  * @since 2.9.0
- * @uses $allowedtags
  *
  * @param string $data Content to filter, expected to not be escaped
  * @return string Filtered content
@@ -1392 +1389 @@
  * 'excerpt_save_pre', and 'content_filtered_save_pre' hooks.
  *
  * @since 2.0.0
- * @uses add_filter() See description for what functions are added to what hooks.
  */
 function kses_init_filters() {
         // Normal filtering
@@ -1447 +1443 @@
  * to have Kses filter the content. If the user does not have unfiltered_html
  * capability, then Kses filters are added.
  *
- * @uses kses_remove_filters() Removes the Kses filters
- * @uses kses_init_filters() Adds the Kses filters back if the user
- *              does not have unfiltered HTML capability.
  * @since 2.0.0
  */
 function kses_init() {

src/wp-includes/link-template.php

@@ -1880 +1880 @@
  * Can be either next post link or previous.
  *
  * @since 2.5.0
- * @uses get_adjacent_post_link()
  *
  * @param string       $format         Link anchor format.
  * @param string       $link           Link permalink format.
@@ -2048 +2047 @@
  * Display the next posts page link.
  *
  * @since 0.71
- * @uses get_next_posts_link()
  *
  * @param string $label Content for link text.
  * @param int $max_page Optional. Max pages.
@@ -2126 +2124 @@
  * Display the previous posts page link.
  *
  * @since 0.71
- * @uses get_previous_posts_link()
  *
  * @param string $label Optional. Previous page link text.
  */
@@ -2606 +2603 @@
  *
  * @since 3.0.0
  *
- * @uses get_home_url()
- *
  * @param  string $path   (optional) Path relative to the home url.
  * @param  string $scheme (optional) Scheme to give the home url context. Currently 'http', 'https', or 'relative'.
  * @return string Home url link with optional path appended.
@@ -2675 +2670 @@
  *
  * @since 3.0.0
  *
- * @uses get_site_url()
- *
  * @param string $path Optional. Path relative to the site url.
  * @param string $scheme Optional. Scheme to give the site url context. See set_url_scheme().
  * @return string Site url link with optional path appended.
@@ -3258 +3251 @@
  *  Attached to the wp_head action.
  *
  * @since 3.0.0
- *
- * @uses wp_get_shortlink()
  */
 function wp_shortlink_wp_head() {
         $shortlink = wp_get_shortlink( 0, 'query' );
@@ -3276 +3267 @@
  * Attached to the wp action.
  *
  * @since 3.0.0
- *
- * @uses wp_get_shortlink()
  */
 function wp_shortlink_header() {
         if ( headers_sent() )

src/wp-includes/media.php

@@ -25 +25 @@
  * height as the second element.
  *
  * @since 2.5.0
- * @uses wp_constrain_dimensions() This function passes the widths and the heights.
  *
  * @param int $width Width of the image
  * @param int $height Height of the image
@@ -684 +683 @@
  * @since 2.5.0
  *
  * @see add_image_size()
- * @uses wp_get_attachment_image_src() Gets attachment file URL and dimensions
  *
  * @param int          $attachment_id Image attachment ID.
  * @param string|array $size          Optional. Default 'thumbnail'.
@@ -1995 +1993 @@
  *
  * @since 3.5.0
  * @see get_attachment_taxonomies()
- * @uses get_taxonomies()
  *
  * @param string $output The type of output to return, either taxonomy 'names' or 'objects'. 'names' is the default.
  * @return array The names of all taxonomy of $object_type.
@@ -2099 +2096 @@
  * Based on a supplied width/height example, return the biggest possible dimensions based on the max width/height.
  *
  * @since 2.9.0
- * @uses wp_constrain_dimensions() This function passes the widths and the heights.
  *
  * @param int $example_width The width of an example embed.
  * @param int $example_height The height of an example embed.
@@ -2122 +2118 @@
  * @since 2.9.0
  * @see WP_oEmbed
  *
- * @uses _wp_oembed_get_object()
- * @uses WP_oEmbed::get_html()
- *
  * @param string $url The URL that should be embedded.
  * @param array $args Additional arguments and parameters.
  * @return bool|string False on failure or the embed HTML on success.
@@ -2141 +2134 @@
  * @since 2.9.0
  * @see WP_oEmbed
  *
- * @uses _wp_oembed_get_object()
- *
  * @param string $format The format of URL that this provider can handle. You can use asterisks as wildcards.
  * @param string $provider The URL to the oEmbed provider.
  * @param boolean $regex Whether the $format parameter is in a regex format.
@@ -2164 +2155 @@
  * @since 3.5.0
  * @see WP_oEmbed
  *
- * @uses _wp_oembed_get_object()
- *
  * @param string $format The URL format for the oEmbed provider to remove.
  */
 function wp_oembed_remove_provider( $format ) {

src/wp-includes/meta.php

@@ -576 +576 @@
  *
  * @since 3.3.0
  *
- * @uses get_metadata_by_mid() Calls get_metadata_by_mid() to fetch the meta key, value
- *              and object_id of the given meta_id.
- *
  * @param string $meta_type Type of object metadata is for (e.g., comment, post, or user)
  * @param int $meta_id ID for a specific meta row
  * @param string $meta_value Metadata value
@@ -670 +667 @@
  *
  * @since 3.3.0
  *
- * @uses get_metadata_by_mid() Calls get_metadata_by_mid() to fetch the meta key, value
- *              and object_id of the given meta_id.
- *
  * @param string $meta_type Type of object metadata is for (e.g., comment, post, or user)
  * @param int $meta_id ID for a specific meta row
  * @return bool True on successful delete, false on failure.

src/wp-includes/ms-deprecated.php

@@ -232 +232 @@
  * @since MU
  * @deprecated 3.3.0
  * @deprecated Use wp_redirect()
- * @uses wpmu_admin_redirect_add_updated_param()
  *
  * @param string $url
  */
@@ -297 +296 @@
  * @since MU
  * @deprecated 3.6.0
  * @deprecated Use get_user_by()
- * @uses get_user_by()
  *
  * @param string $string Either an email address or a login.
  * @return int

src/wp-includes/ms-functions.php

@@ -11 +11 @@
  * Gets the network's site and user counts.
  *
  * @since MU 1.0
- * @uses get_blog_count()
- * @uses get_user_count()
  *
  * @return array Site and user count for the network.
  */
@@ -58 +56 @@
  * is returned.
  *
  * @since MU 1.0
- * @uses get_blogs_of_user()
- * @uses add_user_to_blog()
- * @uses get_blog_details()
  *
  * @param int $user_id The unique ID of the user
  * @return object The blog object
@@ -298 +293 @@
  * Create an empty blog.
  *
  * @since MU 1.0
- * @uses install_blog()
  *
  * @param string $domain The new blog's domain.
  * @param string $path The new blog's path.
@@ -455 +449 @@
  * relevant errors if necessary.
  *
  * @since MU
- * @uses is_email_address_unsafe()
- * @uses username_exists()
- * @uses email_exists()
  *
  * @param string $user_name The login name provided by the user.
  * @param string $user_email The email provided by the user.
@@ -580 +571 @@
  * the way that WordPress validates new site signups.
  *
  * @since MU
- * @uses domain_exists()
- * @uses username_exists()
  *
  * @param string $blogname The blog name provided by the user. Must be unique.
  * @param string $blog_title The blog title provided by the user.
@@ -713 +702 @@
  * Record site signup information for future activation.
  *
  * @since MU
- * @uses wpmu_signup_blog_notification()
  *
  * @param string $domain The requested domain.
  * @param string $path The requested path.
@@ -749 +737 @@
  * new site registration is not.
  *
  * @since MU
- * @uses wpmu_signup_user_notification()
  *
  * @param string $user The user's requested login name.
  * @param string $user_email The user's email address.
@@ -978 +965 @@
  * by a Super Admin).
  *
  * @since MU
- * @uses wp_generate_password()
- * @uses wpmu_welcome_user_notification()
- * @uses add_user_to_blog()
- * @uses wpmu_create_user()
- * @uses wpmu_create_blog()
- * @uses wpmu_welcome_notification()
  *
  * @param string $key The activation key provided to the user.
  * @return array An array containing information about the activated user and/or blog
@@ -1078 +1059 @@
  * use 'user_register').
  *
  * @since MU
- * @uses wp_create_user()
  *
  * @param string $user_name The new user's login name.
  * @param string $password The new user's password.
@@ -1121 +1101 @@
  * root domain (eg 'blog1.example.com'), and $path is '/'.
  *
  * @since MU
- * @uses domain_exists()
- * @uses insert_blog()
- * @uses wp_install_defaults()
- * @uses add_user_to_blog()
  *
  * @param string $domain The new site's domain.
  * @param string $path The new site's path.
@@ -1248 +1224 @@
  * the notification email.
  *
  * @since MU
- * @uses apply_filters() Filter newuser_notify_siteadmin to change the content of the email message
  *
  * @param int $user_id The new user's ID.
  * @return bool
@@ -1354 +1329 @@
  * points to the new blog.
  *
  * @since MU
- * @uses make_db_current_silent()
- * @uses populate_roles()
  *
  * @param int $blog_id The value returned by insert_blog().
  * @param string $blog_title The title of the new site.
@@ -1408 +1381 @@
  * @since MU
  * @deprecated MU
  * @deprecated Use wp_install_defaults()
- * @uses wp_install_defaults()
  *
  * @param int $blog_id Ignored in this function.
  * @param int $user_id
@@ -1628 +1600 @@
  * the most recent post_date_gmt.
  *
  * @since MU
- * @uses get_blogs_of_user()
  *
  * @param int $user_id
  * @return array Contains the blog_id, post_id, post_date_gmt, and post_gmt_ts
@@ -1675 +1646 @@
  * a blog has exceeded its allowed upload space.
  *
  * @since MU
- * @uses recurse_dirsize()
  *
  * @param string $directory
  * @return int
@@ -1889 +1859 @@
  * Add a nonce field to the signup page.
  *
  * @since MU
- * @uses wp_nonce_field()
  */
 function signup_nonce_fields() {
         $id = mt_rand();
@@ -1901 +1870 @@
  * Process the signup nonce created in signup_nonce_fields().
  *
  * @since MU
- * @uses wp_create_nonce()
  *
  * @param array $result
  * @return array
@@ -1947 +1915 @@
  * added, as when a user is invited through the regular WP Add User interface.
  *
  * @since MU
- * @uses add_existing_user_to_blog()
  */
 function maybe_add_existing_user_to_blog() {
         if ( false === strpos( $_SERVER[ 'REQUEST_URI' ], '/newbloguser/' ) )
@@ -1973 +1940 @@
  * Add a user to a blog based on details from maybe_add_existing_user_to_blog().
  *
  * @since MU
- * @uses add_user_to_blog()
  *
  * @param array $details
  */
@@ -2031 +1997 @@
  * Check to see whether a user is marked as a spammer, based on user login.
  *
  * @since MU
- * @uses get_user_by()
  *
  * @param string|WP_User $user Optional. Defaults to current user. WP_User object,
  *      or user login name as a string.
@@ -2054 +2019 @@
  * Public blogs have a setting of 1, private blogs are 0.
  *
  * @since MU
- * @uses update_blog_status()
  *
  * @param int $old_value
  * @param int $value The new public value
@@ -2069 +2033 @@
  * Check whether a usermeta key has to do with the current blog.
  *
  * @since MU
- * @uses wp_get_current_user()
  *
  * @param string $key
  * @param int $user_id Optional. Defaults to current user.
@@ -2206 +2169 @@
  * on a network when a site is created or its status is updated.
  *
  * @since 3.7.0
- *
- * @uses wp_update_network_site_counts()
  */
 function wp_maybe_update_network_site_counts() {
         $is_small_network = ! wp_is_large_network( 'sites' );
@@ -2235 +2196 @@
  * on a network when a user is created or its status is updated.
  *
  * @since 3.7.0
- *
- * @uses wp_update_network_user_counts()
  */
 function wp_maybe_update_network_user_counts() {
         $is_small_network = ! wp_is_large_network( 'users' );

src/wp-includes/nav-menu.php

@@ -12 +12 @@
  *
  * @since 3.0.0
  *
- * @uses get_term
- * @uses get_term_by
- *
  * @param string $menu Menu ID, slug, or name.
  * @return mixed false if $menu param isn't supplied or term does not exist, menu object if successful.
  */

src/wp-includes/option.php

@@ -141 +141 @@
 /**
  * Print option value after sanitizing for forms.
  *
- * @uses attr Sanitizes value.
  * @since 1.5.0
  *
  * @param string $option Option name.

src/wp-includes/pluggable.php

@@ -72 +72 @@
  * @since 0.71
  *
  * @uses $current_user Checks if the current user is set
- * @uses wp_validate_auth_cookie() Retrieves current logged in user.
  *
  * @return bool|null False on XML-RPC Request and invalid auth cookie. Null when current user set.
  */
@@ -1215 +1214 @@
  *
  * @since 2.3.0
  *
- * @uses wp_validate_redirect() To validate the redirect is to an allowed host.
- *
  * @return void Does not return anything
  **/
 function wp_safe_redirect($location, $status = 302) {
@@ -1872 +1869 @@
  * Get hash of given string.
  *
  * @since 2.0.3
- * @uses wp_salt() Get WordPress salt
  *
  * @param string $data Plain text to hash
  * @return string Hash of $data
@@ -2069 +2065 @@
  * @since 2.5.0
  *
  * @uses $wpdb WordPress database object for queries
- * @uses wp_hash_password() Used to encrypt the user's password before passing to the database
  *
  * @param string $password The plaintext new user password
  * @param int $user_id User ID

src/wp-includes/plugin.php

@@ -357 +357 @@
  *
  * @since 3.9.0
  *
- * @uses current_filter()
- *
  * @return string Hook name of the current action.
  */
 function current_action() {
@@ -401 +399 @@
  *
  * @since 3.9.0
  *
- * @uses doing_filter()
- *
  * @param string|null $action Optional. Action to check. Defaults to null, which checks
  *                            if any action is currently being run.
  * @return bool Whether the action is currently in the stack.
@@ -421 +417 @@
  *
  * @since 1.2.0
  *
- * @uses add_filter() Adds an action. Parameter list and functionality are the same.
- *
  * @param string   $tag             The name of the action to which the $function_to_add is hooked.
  * @param callback $function_to_add The name of the function you wish to be called.
  * @param int      $priority        Optional. Used to specify the order in which the functions
@@ -646 +640 @@
  *
  * @since 1.5.0
  *
- * @uses WP_PLUGIN_DIR, WPMU_PLUGIN_DIR
- *
  * @param string $file The filename of plugin.
  * @return string The name of a plugin.
  */
@@ -832 +824 @@
  * @since 2.5.0
  * @access private
  *
- * @uses $wp_filter Used to process all of the functions in the 'all' hook.
- *
  * @param array $args The collected parameters from the hook that was called.
  */
 function _wp_call_all_hook($args) {

src/wp-includes/post-formats.php

@@ -36 +36 @@
  *
  * @since 3.1.0
  *
- * @uses has_term()
- *
  * @param string|array $format Optional. The format or formats to check.
  * @param object|int $post Optional. The post to check. If not supplied, defaults to the current post if used in the loop.
  * @return bool True if the post has any of the given formats (or any format, if no format specified), false otherwise.
@@ -108 +106 @@
  *
  * @since 3.1.0
  *
- * @uses get_post_format_strings()
- *
  * @return array The array of post format slugs.
  */
 function get_post_format_slugs() {
@@ -122 +118 @@
  *
  * @since 3.1.0
  *
- * @uses get_post_format_strings()
- *
  * @param string $slug A post format slug.
  * @return string The translated post format name.
  */

src/wp-includes/post-template.php

@@ -21 +21 @@
  * Retrieve the ID of the current item in the WordPress Loop.
  *
  * @since 2.1.0
- * @uses $post
  *
  * @return int|bool The ID of the current item in the WordPress Loop. False if $post is not set.
  */
@@ -907 +906 @@
  *
  * @internal This will probably change at some point...
  * @since 1.2.0
- * @uses apply_filters() Calls 'the_meta_key' on list item HTML content, with key and value as separate parameters.
  */
 function the_meta() {
         if ( $keys = get_post_custom_keys() ) {
@@ -1466 +1464 @@
  * Retrieve an attachment page link using an image or icon, if possible.
  *
  * @since 2.5.0
- * @uses apply_filters() Calls 'wp_get_attachment_link' filter on HTML content with same parameters as function.
  *
  * @param int|WP_Post $id Optional. Post ID or post object.
  * @param string $size Optional, default is 'thumbnail'. Size of image, either array or string.
@@ -1602 +1599 @@
  * specific to that template.
  *
  * @since 2.5.0
- * @uses $wp_query
  *
  * @param string $template The specific template name if specific matching is required.
  * @return bool True on success, false on failure.
@@ -1649 +1645 @@
  *
  * @since 2.6.0
  *
- * @uses date_i18n()
- *
  * @param int|object $revision Revision ID or revision object.
  * @param bool $link Optional, default is true. Link to revisions's page?
  * @return string i18n formatted datetimestamp or localized 'Current Revision'.
@@ -1686 +1680 @@
  *
  * @since 3.6.0
  *
- * @uses date_i18n()
- *
  * @param int|object $revision Revision ID or revision object.
  * @param bool $link Optional, default is true. Link to revisions's page?
  * @return string gravatar, user, i18n formatted datetimestamp or localized 'Current Revision'.
@@ -1737 +1729 @@
  *
  * @since 2.6.0
  *
- * @uses wp_get_post_revisions()
- * @uses wp_post_revision_title_expanded()
- * @uses get_edit_post_link()
- * @uses get_the_author_meta()
- *
  * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global $post.
  * @param string $type 'all' (default), 'revision' or 'autosave'
  * @return null

src/wp-includes/post.php

@@ -2942 +2942 @@
  *
  * @since 2.3.0
  *
- * @uses wp_get_object_terms()
- *
  * @param int   $post_id Optional. The Post ID. Does not default to the ID of the
  *                       global $post. Defualt 0.
  * @param array $args Optional. Overwrite the defaults
@@ -2962 +2960 @@
  *
  * @since 2.8.0
  *
- * @uses wp_get_object_terms()
- *
  * @param int    $post_id  Optional. The Post ID. Does not default to the ID of the
  *                         global $post. Default 0.
  * @param string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.

src/wp-includes/query.php

@@ -406 +406 @@
  *
  * @see WP_Query::is_front_page()
  * @since 2.5.0
- * @uses is_home()
- * @uses get_option()
  *
  * @return bool True, if front of site.
  */
@@ -2357 +2355 @@
          *
          * @since 1.5.0
          * @access public
-         * @uses do_action_ref_array() Calls 'pre_get_posts' hook before retrieving posts.
          *
          * @return array List of posts.
          */
@@ -3692 +3689 @@
          *
          * @since 1.5.0
          * @access public
-         * @uses $post
-         * @uses do_action_ref_array() Calls 'loop_start' if loop has just started
          */
         public function the_post() {
                 global $post;
@@ -3720 +3715 @@
          *
          * @since 1.5.0
          * @access public
-         * @uses do_action_ref_array() Calls 'loop_end' if loop is ended
          *
          * @return bool True if posts are available, false if end of loop.
          */
@@ -3778 +3772 @@
          * @since 2.2.0
          * @access public
          * @global object $comment Current comment.
-         * @uses do_action() Calls 'comment_loop_start' hook when first comment is processed.
          */
         public function the_comment() {
                 global $comment;
@@ -4280 +4273 @@
          * Otherwise the same as @see WP_Query::is_home()
          *
          * @since 3.1.0
-         * @uses is_home()
-         * @uses get_option()
          *
          * @return bool True, if front of site.
          */
@@ -4688 +4679 @@
  * @since 1.5.0
  *
  * @param object $post Post data.
- * @uses do_action_ref_array() Calls 'the_post'
  * @return bool True when finished.
  */
 function setup_postdata( $post ) {

src/wp-includes/revision.php

@@ -77 +77 @@
  *
  * @since 2.6.0
  *
- * @uses _wp_put_post_revision()
- *
  * @param int $post_id The ID of the post to save as a revision.
  * @return mixed Null or 0 if error, new revision ID, if success.
  */
@@ -192 +190 @@
  *
  * @since 2.6.0
  *
- * @uses wp_get_post_revisions()
- *
  * @param int $post_id The post ID.
  * @param int $user_id optional The post author ID.
  * @return object|bool The autosaved data or false on failure or when no autosave exists.
@@ -252 +248 @@
  * @since 2.6.0
  * @access private
  *
- * @uses wp_insert_post()
- *
  * @param int|object|array $post Post ID, post object OR post array.
  * @param bool $autosave Optional. Is the revision an autosave?
  * @return mixed WP_Error or 0 if error, new revision ID if success.
@@ -296 +290 @@
  *
  * @since 2.6.0
  *
- * @uses get_post()
- *
  * @param int|object $post The post ID or object.
  * @param string $output Optional. OBJECT, ARRAY_A, or ARRAY_N.
  * @param string $filter Optional sanitation filter. @see sanitize_post().
@@ -329 +321 @@
  *
  * @since 2.6.0
  *
- * @uses wp_get_post_revision()
- * @uses wp_update_post()
- *
  * @param int|object $revision_id Revision ID or revision object.
  * @param array $fields Optional. What fields to restore from. Defaults to all.
  * @return mixed Null if error, false if no fields to restore, (int) post ID if success.
@@ -390 +379 @@
  *
  * @since 2.6.0
  *
- * @uses wp_get_post_revision()
- * @uses wp_delete_post()
- *
  * @param int|object $revision_id Revision ID or revision object.
  * @return mixed Null or WP_Error if error, deleted post if success.
  */
@@ -424 +410 @@
  *
  * @since 2.6.0
  *
- * @uses get_children()
- *
  * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global $post.
  * @return array An array of revisions, or an empty array if none.
  */
@@ -453 +437 @@
  *
  * @since 3.6.0
  *
- * @uses wp_revisions_to_keep()
- *
  * @param object $post The post object.
  * @return bool True if number of revisions to keep isn't zero, false otherwise.
  */
@@ -468 +450 @@
  *
  * @since 3.6.0
  *
- * @uses post_type_supports()
- *
  * @param object $post The post object.
  * @return int The number of revisions to keep.
  */
@@ -587 +567 @@
  * @since 3.6.0
  * @access private
  *
- * @uses wp_get_post_revisions()
- *
  * @param object $post Post object
  * @param array $revisions Current revisions of the post
  * @return bool true if the revisions were upgraded, false if problems

src/wp-includes/shortcodes.php

@@ -185 +185 @@
  * @since 2.5.0
  *
  * @uses $shortcode_tags
- * @uses get_shortcode_regex() Gets the search pattern for searching shortcodes.
  *
  * @param string $content Content to search for shortcodes
  * @return string Content with shortcodes filtered out.

src/wp-includes/taxonomy.php

@@ -134 +134 @@
  *
  * @since 3.0.0
  * @uses $wp_taxonomies
- * @see register_taxonomy
  *
  * @param array $args An array of key => value arguments to match against the taxonomy objects.
  * @param string $output The type of output to return, either taxonomy 'names' or 'objects'. 'names' is the default.
@@ -200 +199 @@
  * @since 2.3.0
  *
  * @uses $wp_taxonomies
- * @uses taxonomy_exists() Checks whether taxonomy exists
  *
  * @param string $taxonomy Name of taxonomy object to return
  * @return object|bool The Taxonomy Object or false if $taxonomy doesn't exist
@@ -242 +240 @@
  *
  * @since 2.3.0
  *
- * @uses taxonomy_exists() Checks whether taxonomy exists
- * @uses get_taxonomy() Used to get the taxonomy object
- *
  * @param string $taxonomy Name of taxonomy object
  * @return bool Whether the taxonomy is hierarchical
  */
@@ -568 +563 @@
  * @since 2.3.0
  *
  * @uses $wpdb
- * @uses wp_parse_args() Creates an array from string $args.
  *
  * @param int|array $term_ids Term id or array of term ids of terms that will be used
  * @param string|array $taxonomies String of taxonomy name or Array of string values of taxonomy names
@@ -1268 +1262 @@
  * @since 2.3.0
  *
  * @uses $wpdb
- * @uses sanitize_term() Cleanses the term based on $filter context before returning.
  * @see sanitize_term_field() The $context param lists the available values for get_term_by() $filter param.
  *
  * @param int|object $term If integer, will get from database. If object will apply filters and return $term.
@@ -1364 +1357 @@
  * @since 2.3.0
  *
  * @uses $wpdb
- * @uses sanitize_term() Cleanses the term based on $filter context before returning.
  * @see sanitize_term_field() The $context param lists the available values for get_term_by() $filter param.
  *
  * @param string $field Either 'slug', 'name', 'id' (term_id), or 'term_taxonomy_id'
@@ -1455 +1447 @@
  * @since 2.3.0
  *
  * @uses $wpdb
- * @uses _get_term_hierarchy()
- * @uses get_term_children() Used to get the children of both $taxonomy and the parent $term
  *
  * @param string $term_id ID of Term to get children
  * @param string $taxonomy Taxonomy Name
@@ -1496 +1486 @@
  *
  * @since 2.3.0
  *
- * @uses sanitize_term_field() Passes the return value in sanitize_term_field on success.
- *
  * @param string $field Term field to fetch
  * @param int $term Term ID
  * @param string $taxonomy Taxonomy Name
@@ -1527 +1515 @@
  *
  * @since 2.3.0
  *
- * @uses sanitize_term() Passes the return value on success
- *
  * @param int|object $id Term ID or Object
  * @param string $taxonomy Taxonomy Name
  * @return mixed|null|WP_Error Will return empty string if $term is not an object.
@@ -2105 +2091 @@
  *
  * @since 2.3.0
  *
- * @uses sanitize_term_field Used to sanitize all fields in a term
- *
  * @param array|object $term The term to check
  * @param string $taxonomy The taxonomy name to use
  * @param string $context Default is 'display'.
@@ -2315 +2299 @@
  *
  * @since 2.3.0
  *
- * @uses get_terms()
- * @uses wp_parse_args() Turns strings into arrays and merges defaults into an array.
- *
  * @param string $taxonomy Taxonomy name
  * @param array|string $args Overwrite defaults. See get_terms()
  * @return int|WP_Error How many terms are in $taxonomy. WP_Error if $taxonomy does not exist.
@@ -2345 +2326 @@
  * taxonomy itself.
  *
  * @since 2.3.0
- * @uses wp_remove_object_terms()
  *
  * @param int $object_id The term Object Id that refers to the term
  * @param string|array $taxonomies List of Taxonomy Names or single Taxonomy name.
@@ -2544 +2524 @@
  * Deletes one existing category.
  *
  * @since 2.0.0
- * @uses wp_delete_term()
  *
  * @param int $cat_ID
  * @return mixed Returns true if completes delete action; false if term doesn't exist;
@@ -2967 +2946 @@
  * exists under.
  *
  * @since 2.3.0
- * @uses wp_remove_object_terms()
  *
  * @param int              $object_id The object to relate to.
  * @param array|int|string $terms     A single term slug, single term id, or array of either term slugs or ids.
@@ -3091 +3069 @@
  * Add term(s) associated with a given object.
  *
  * @since 3.6.0
- * @uses wp_set_object_terms()
  *
  * @param int $object_id The ID of the object to which the terms will be added.
  * @param array|int|string $terms The slug(s) or ID(s) of the term(s) to add.
@@ -3690 +3667 @@
  *
  * @since 2.3.0
  *
- * @uses wp_cache_get() Retrieves taxonomy relationship from cache
- *
  * @param int|array $id Term object ID
  * @param string $taxonomy Taxonomy Name
  * @return bool|array Empty array if $terms found, but not $taxonomy. False if nothing is in cache for $taxonomy and $id.
@@ -3715 +3690 @@
  * for each term and it also increases for each taxonomy the term belongs to.
  *
  * @since 2.3.0
- * @uses wp_get_object_terms() Used to get terms from the database to update
  *
  * @param string|array $object_ids Single or list of term object ID(s)
  * @param array|string $object_type The taxonomy object type
@@ -3806 +3780 @@
  * @access private
  * @since 2.3.0
  *
- * @uses update_option() Stores all of the children in "$taxonomy_children"
- *       option. That is the name of the taxonomy, immediately followed by '_children'.
- *
  * @param string $taxonomy Taxonomy Name
  * @return array Empty if $taxonomy isn't hierarchical or returns children as Term IDs.
  */
@@ -4136 +4107 @@
  * 'template' : The template to use for displaying the taxonomy terms.
  *
  * @since 2.5.0
- * @uses get_the_taxonomies()
  *
  * @param array $args Override the defaults.
  */
@@ -4214 +4184 @@
  *
  * @since 2.5.0
  *
- * @uses get_object_taxonomies()
- *
  * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
  * @return array
  */
@@ -4233 +4201 @@
  * If no terms are given, determines if object is associated with any terms in the given taxonomy.
  *
  * @since 2.7.0
- * @uses get_object_term_cache()
- * @uses wp_get_object_terms()
  *
  * @param int $object_id ID of the object (post ID, link ID, ...)
  * @param string $taxonomy Single taxonomy name
@@ -4279 +4245 @@
  * Determine if the given object type is associated with the given taxonomy.
  *
  * @since 3.0.0
- * @uses get_object_taxonomies()
  *
  * @param string $object_type Object type string
  * @param string $taxonomy Single taxonomy name
@@ -4361 +4326 @@
  * Attached to the wp_update_term_parent filter.
  *
  * @since 3.1.0
- * @uses wp_find_hierarchy_loop()
  *
  * @param int $parent term_id of the parent for the term we're checking.
  * @param int $term_id The term we're checking.

src/wp-includes/theme.php

@@ -271 +271 @@
  * Retrieve name of the current theme.
  *
  * @since 1.5.0
- * @uses apply_filters() Calls 'template' filter on template option.
  *
  * @return string Template name.
  */

src/wp-includes/user.php

@@ -316 +316 @@
  *
  * @since MU
  *
- * @uses wp_get_current_user
- *
  * @return int The current user's ID
  */
 function get_current_user_id() {
@@ -1111 +1109 @@
  * Find out whether a user is a member of a given blog.
  *
  * @since MU 1.1
- * @uses get_blogs_of_user()
  *
  * @param int $user_id Optional. The unique ID of the user. Defaults to the current user.
  * @param int $blog_id Optional. ID of the blog to check. Defaults to the current site.
@@ -1137 +1134 @@
  * Post meta data is called "Custom Fields" on the Administration Screens.
  *
  * @since 3.0.0
- * @uses add_metadata()
  * @link http://codex.wordpress.org/Function_Reference/add_user_meta
  *
  * @param int $user_id User ID.
@@ -1158 +1154 @@
  * allows removing all metadata matching key, if needed.
  *
  * @since 3.0.0
- * @uses delete_metadata()
  * @link http://codex.wordpress.org/Function_Reference/delete_user_meta
  *
  * @param int $user_id user ID
@@ -1174 +1169 @@
  * Retrieve user meta field for a user.
  *
  * @since 3.0.0
- * @uses get_metadata()
  * @link http://codex.wordpress.org/Function_Reference/get_user_meta
  *
  * @param int $user_id User ID.
@@ -1196 +1190 @@
  * If the meta field for the user does not exist, it will be added.
  *
  * @since 3.0.0
- * @uses update_metadata
  * @link http://codex.wordpress.org/Function_Reference/update_user_meta
  *
  * @param int $user_id User ID.
@@ -1639 +1632 @@
  * Checks whether an username is valid.
  *
  * @since 2.0.1
- * @uses apply_filters() Calls 'validate_username' hook on $valid check and $username as parameters
  *
  * @param string $username Username.
  * @return bool Whether username given is valid

src/wp-includes/widgets.php

@@ -554 +554 @@
  * @since 2.2.0
  *
  * @see register_sidebar() The second parameter is documented by register_sidebar() and is the same here.
- * @uses parse_str() Converts a string to an array to be used in the rest of the function.
- * @uses register_sidebar() Sends single sidebar information [name, id] to this
- *      function to handle building the sidebar.
  *
  * @param int $number Number of sidebars to create.
  * @param string|array $args Builds Sidebar based off of 'name' and 'id' values.
@@ -631 +628 @@
  *
  * @since 2.2.0
  * @uses $wp_registered_sidebars Stores the new sidebar in this array by sidebar ID.
- * @uses add_theme_support() to ensure widget support has been added.
  *
  * @param string|array $args Arguments for the sidebar being registered.
  * @return string Sidebar ID added to $wp_registered_sidebars global.
@@ -932 +928 @@
  * Remove control callback for widget.
  *
  * @since 2.2.0
- * @uses wp_register_widget_control() Unregisters by using empty callback.
  *
  * @param int|string $id Widget ID.
  */

src/wp-includes/wp-db.php

@@ -867 +867 @@
         /**
          * Gets blog prefix.
          *
-         * @uses is_multisite()
          * @since 3.0.0
          * @param int $blog_id Optional.
          * @return string Blog prefix.
@@ -906 +905 @@
          * @uses wpdb::$old_tables
          * @uses wpdb::$global_tables
          * @uses wpdb::$ms_global_tables
-         * @uses is_multisite()
          *
          * @param string $scope Optional. Can be all, global, ms_global, blog, or old tables. Defaults to all.
          * @param bool $prefix Optional. Whether to include table prefixes. Default true. If blog

src/wp-signup.php

@@ -153 +153 @@
  *
  * @since MU
  *
- * @uses wp_get_current_user() to retrieve the current user
- * @uses wpmu_validate_blog_signup() to validate new site signup for the current user
  * @return array Contains the new site data and error messages.
  */
 function validate_blog_form() {
@@ -208 +206 @@
  *
  * @since MU
  *
- * @uses wpmu_validate_user_signup() to retrieve an array of user data
  * @return array Contains username, email, and error messages.
  */
 function validate_user_form() {
@@ -220 +217 @@
  *
  * @since MU
  *
- * @uses wp_get_current_user() to get the current user
  * @param string $blogname The new site name
  * @param string $blog_title The new blog title
  * @param array $errors
@@ -303 +299 @@
  *
  * @since MU
  *
- * @uses wp_get_current_user() to retrieve the current user
- * @uses wpmu_create_blog() to add a new site
- * @uses confirm_another_blog_signup() to confirm the user's new site signup
  * @return bool True if blog signup was validated, false if error
  */
 function validate_another_blog_signup() {
@@ -394 +387 @@
  *
  * @since MU
  *
- * @uses apply_filters() filter $filtered_results
- * @uses show_user_form() to display the user registration form
  * @param string $user_name The username
  * @param string $user_email The user's email
  * @param array $errors
@@ -467 +458 @@
  *
  * @since MU
  *
- * @uses validate_user_form() to retrieve an array of the user data
- * @uses wpmu_signup_user() to signup the new user
- * @uses confirm_user_signup() to confirm the new user signup
  * @return bool True if new user signup was validated, false if error
  */
 function validate_user_signup() {
@@ -519 +507 @@
  *
  * @since MU
  *
- * @uses apply_filters() to filter $filtered_results
- * @uses show_blog_form() to display the blog signup form
  * @param string $user_name The username
  * @param string $user_email The user's email address
  * @param string $blogname The site name
@@ -584 +570 @@
  *
  * @since MU
  *
- * @uses wpmu_validate_user_signup() to retrieve an array of the new user data and errors
- * @uses wpmu_validate_blog_signup() to retrieve an array of the new site data and errors
- * @uses apply_filters() to make signup $meta filterable
- * @uses signup_user() to signup a new user
- * @uses signup_blog() to signup a the new user to a new site
  * @return bool True if the site signup was validated, false if error
  */
 function validate_blog_signup() {