Changeset 33673

Timestamp:

08/20/2015 10:10:20 PM (9 years ago)

Author:

DrewAPicture

Message:

Docs: Standardize @deprecated tag formatting and add missing DocBlock summaries to deprecated functions in wp-includes/deprecated.php.

Props Alphawolf for the initial patch.
Props DrewAPicture.

See #28806.

File:

• trunk/src/wp-includes/deprecated.php (modified) (134 diffs)

trunk/src/wp-includes/deprecated.php

@@ -17 +17 @@
  *
  * @since 0.71
- * @deprecated 1.5.1
- * @deprecated Use get_post()
+ * @deprecated 1.5.1 Use get_post()
  * @see get_post()
  *
@@ -53 +52 @@
  * Sets up the WordPress Loop.
  *
+ * Use The Loop instead.
+ *
+ * @link https://codex.wordpress.org/The_Loop
+ *
  * @since 1.0.1
  * @deprecated 1.5.0
- * @deprecated Use The Loop - {@link https://codex.wordpress.org/The_Loop Use new WordPress Loop}
  */
 function start_wp() {
@@ -72 +74 @@
  *
  * @since 0.71
- * @deprecated 0.71
- * @deprecated use get_the_category()
+ * @deprecated 0.71 Use get_the_category()
  * @see get_the_category()
  *
@@ -96 +97 @@
  *
  * @since 0.71
- * @deprecated 0.71
- * @deprecated use get_the_category_by_ID()
+ * @deprecated 0.71 Use get_the_category_by_ID()
  * @see get_the_category_by_ID()
  *
@@ -123 +123 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use previous_post_link()
+ * @deprecated 2.0.0 Use previous_post_link()
  * @see previous_post_link()
  *
@@ -160 +159 @@
  *
  * @since 0.71
- * @deprecated 2.0.0
- * @deprecated Use next_post_link()
+ * @deprecated 2.0.0 Use next_post_link()
  * @see next_post_link()
  *
@@ -196 +194 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -216 +213 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -236 +232 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -265 +260 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -285 +279 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -305 +298 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -325 +317 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -345 +336 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -365 +355 @@
  *
  * @since 1.5.0
- * @deprecated 2.0.0
- * @deprecated Use current_user_can()
+ * @deprecated 2.0.0 Use current_user_can()
  * @see current_user_can()
  *
@@ -388 +377 @@
  *
  * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use get_bookmarks()
+ * @deprecated 2.1.0 Use get_bookmarks()
  * @see get_bookmarks()
  *
@@ -422 +410 @@
  *
  * @since 1.0.1
- * @deprecated 2.1.0
- * @deprecated Use wp_list_bookmarks()
+ * @deprecated 2.1.0 Use wp_list_bookmarks()
  * @see wp_list_bookmarks()
  *
@@ -458 +445 @@
  *
  * @since 1.0.1
- * @deprecated 2.1.0
- * @deprecated Use get_bookmarks()
+ * @deprecated 2.1.0 Use get_bookmarks()
  * @see get_bookmarks()
  *
@@ -509 +495 @@
  *
  * @since 1.0.1
- * @deprecated 2.1.0
- * @deprecated Use get_bookmarks()
+ * @deprecated 2.1.0 Use get_bookmarks()
  * @see get_bookmarks()
  *
@@ -537 +522 @@
  *
  * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use get_bookmarks()
+ * @deprecated 2.1.0 Use get_bookmarks()
  * @see get_bookmarks()
  *
@@ -565 +549 @@
  *
  * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use get_bookmarks()
+ * @deprecated 2.1.0 Use get_bookmarks()
  * @see get_bookmarks()
  *
@@ -594 +577 @@
  * @since 0.71
  * @deprecated 2.1.0
- * @deprecated No alternative function available
  *
  * @param int $id The category to get. If no category supplied uses 0
@@ -605 +587 @@
 
 /**
- * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use wp_list_categories()
+ * Lists categories.
+ *
+ * @since 0.71
+ * @deprecated 2.1.0 Use wp_list_categories()
  * @see wp_list_categories()
  *
@@ -641 +624 @@
 
 /**
+ * Lists categories.
+ *
  * @since 1.2.0
- * @deprecated 2.1.0
- * @deprecated Use wp_list_categories()
+ * @deprecated 2.1.0 Use wp_list_categories()
  * @see wp_list_categories()
  *
@@ -673 +657 @@
 
 /**
- * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use wp_dropdown_categories()
+ * Deprecated method for generating a drop-down of categories.
+ *
+ * @since 0.71
+ * @deprecated 2.1.0 Use wp_dropdown_categories()
  * @see wp_dropdown_categories()
  *
@@ -710 +695 @@
 
 /**
- * List authors.
+ * Lists authors.
  *
  * @since 1.2.0
- * @deprecated 2.1.0
- * @deprecated Use wp_list_authors()
+ * @deprecated 2.1.0 Use wp_list_authors()
  * @see wp_list_authors()
  *
@@ -733 +717 @@
 
 /**
+ * Retrieves a list of post categories.
+ *
  * @since 1.0.1
- * @deprecated 2.1.0
- * @deprecated Use wp_get_post_categories()
+ * @deprecated 2.1.0 Use wp_get_post_categories()
  * @see wp_get_post_categories()
  *
@@ -766 +751 @@
 
 /**
- * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use wp_get_archives()
+ * Retrieves a list of archives.
+ *
+ * @since 0.71
+ * @deprecated 2.1.0 Use wp_get_archives()
  * @see wp_get_archives()
  *
@@ -789 +775 @@
  *
  * @since 1.2.0
- * @deprecated 2.1.0
- * @deprecated Use get_author_posts_url()
+ * @deprecated 2.1.0 Use get_author_posts_url()
  * @see get_author_posts_url()
  *
@@ -812 +797 @@
  *
  * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use wp_link_pages()
+ * @deprecated 2.1.0 Use wp_link_pages()
  * @see wp_link_pages()
  *
@@ -837 +821 @@
  *
  * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use get_option()
+ * @deprecated 2.1.0 Use get_option()
  * @see get_option()
  *
@@ -854 +837 @@
  *
  * @since 0.71
- * @deprecated 1.2.0
- * @deprecated Use the_permalink()
+ * @deprecated 1.2.0 Use the_permalink()
  * @see the_permalink()
  */
@@ -867 +849 @@
  *
  * @since 0.71
- * @deprecated 2.3.0
- * @deprecated Use the_permalink_rss()
+ * @deprecated 2.3.0 Use the_permalink_rss()
  * @see the_permalink_rss()
  *
@@ -881 +862 @@
  * Gets the links associated with category.
  *
- * @see get_links() for argument information that can be used in $args
  * @since 1.0.1
- * @deprecated 2.1.0
- * @deprecated Use wp_list_bookmarks()
+ * @deprecated 2.1.0 Use wp_list_bookmarks()
  * @see wp_list_bookmarks()
  *
@@ -923 +902 @@
  *
  * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use get_bookmarks()
+ * @deprecated 2.1.0 Use get_bookmarks()
  * @see get_bookmarks()
  *
@@ -1032 +1010 @@
  *
  * @since 1.0.1
- * @deprecated 2.1.0
- * @deprecated Use wp_list_bookmarks()
+ * @deprecated 2.1.0 Use wp_list_bookmarks()
  * @see wp_list_bookmarks()
  *
@@ -1076 +1053 @@
  * @since 0.71
  * @deprecated 2.1.0
- * @deprecated {@internal Use function instead is unknown}}
  *
  * @param string $text the text of the link
@@ -1090 +1066 @@
 /**
  * @since 1.0.1
- * @deprecated 2.1.0
- * @deprecated Use sanitize_bookmark_field()
+ * @deprecated 2.1.0 Use sanitize_bookmark_field()
  * @see sanitize_bookmark_field()
  *
@@ -1106 +1081 @@
  *
  * @since 0.71
- * @deprecated 2.1.0
- * @deprecated Use get_category()
+ * @deprecated 2.1.0 Use get_category()
  * @see get_category()
  *
@@ -1136 +1110 @@
  *
  * @since 1.0.1
- * @deprecated 2.5.0
- * @deprecated Use post_comments_feed_link()
+ * @deprecated 2.5.0 Use post_comments_feed_link()
  * @see post_comments_feed_link()
  *
@@ -1151 +1124 @@
  *
  * @since 1.2.0
- * @deprecated 2.5.0
- * @deprecated Use get_category_feed_link()
+ * @deprecated 2.5.0 Use get_category_feed_link()
  * @see get_category_feed_link()
  *
@@ -1173 +1145 @@
  *
  * @since 1.2.0
- * @deprecated 2.5.0
- * @deprecated Use get_author_feed_link()
+ * @deprecated 2.5.0 Use get_author_feed_link()
  * @see get_author_feed_link()
  *
@@ -1194 +1165 @@
  *
  * @since 1.5.0
- * @deprecated 2.2.0
- * @deprecated Use get_post_comments_feed_link()
+ * @deprecated 2.2.0 Use get_post_comments_feed_link()
  * @see get_post_comments_feed_link()
  *
@@ -1209 +1179 @@
  *
  * @since 2.0.0
- * @deprecated 2.0.0
- * @deprecated Use wp_create_user()
+ * @deprecated 2.0.0 Use wp_create_user()
  * @see wp_create_user()
  *
@@ -1237 +1206 @@
  *
  * @since 0.71
- * @deprecated 2.7.0
- * @deprecated Use get_comment()
+ * @deprecated 2.7.0 Use get_comment()
  * @see get_comment()
  *
@@ -1255 +1223 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use get_cat_name()
+ * @deprecated 2.8.0 Use get_cat_name()
  * @see get_cat_name()
  *
@@ -1271 +1238 @@
  *
  * @since 1.2.0
- * @deprecated 2.8.0
- * @deprecated Use get_term_children()
+ * @deprecated 2.8.0 Use get_term_children()
  * @see get_term_children()
  *
@@ -1309 +1275 @@
  *
  * @since 2.0.0
- * @deprecated 4.0.0 Use get_terms() instead.
+ * @deprecated 4.0.0 Use get_terms()
  * @see get_terms()
+ *
  * @link https://codex.wordpress.org/Function_Reference/get_all_category_ids
  *
@@ -1330 +1297 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('description')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1345 +1311 @@
  *
  * @since 1.0.0
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('description')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1358 +1323 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('login')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1373 +1337 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('login')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1386 +1349 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('first_name')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1401 +1363 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('first_name')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1414 +1375 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('last_name')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1429 +1389 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('last_name')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1442 +1401 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('nickname')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1457 +1415 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('nickname')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1470 +1427 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('email')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1485 +1441 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('email')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1498 +1453 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('icq')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1513 +1467 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('icq')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1526 +1479 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('yim')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1541 +1493 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('yim')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1554 +1505 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('msn')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1569 +1519 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('msn')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1582 +1531 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('aim')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1597 +1545 @@
  *
  * @since 0.71
+ * @deprecated 2.8.0 Use the_author_meta('aim')
  * @see the_author_meta()
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('aim')
  */
 function the_author_aim() {
@@ -1610 +1557 @@
  *
  * @since 1.0.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('display_name')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1626 +1572 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('url')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1641 +1586 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('url')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
  */
@@ -1654 +1598 @@
  *
  * @since 1.5.0
- * @deprecated 2.8.0
- * @deprecated Use get_the_author_meta('ID')
+ * @deprecated 2.8.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  *
@@ -1669 +1612 @@
  *
  * @since 0.71
- * @deprecated 2.8.0
- * @deprecated Use the_author_meta('ID')
+ * @deprecated 2.8.0 Use the_author_meta()
  * @see the_author_meta()
 */
@@ -1697 +1639 @@
  * @since 0.71
  *
- * @deprecated 2.9.0
- * @deprecated Use the_content_feed()
+ * @deprecated 2.9.0 Use the_content_feed()
  * @see the_content_feed()
  *
@@ -1785 +1726 @@
  *
  * @since 2.2.0
- * @deprecated 2.9.0
- * @deprecated Use _x()
+ * @deprecated 2.9.0 Use _x()
  * @see _x()
  *
@@ -1803 +1743 @@
  *
  * @since 2.5.0
- * @deprecated 3.0.0
- * @deprecated Use _x()
+ * @deprecated 3.0.0 Use _x()
  * @see _x()
  *
@@ -1821 +1760 @@
  *
  * @since 2.7.0
- * @deprecated 3.0.0
- * @deprecated Use _nx()
+ * @deprecated 3.0.0 Use _nx()
  * @see _nx()
- * @see _n() For parameters.
- * @see _c() For parameters. _c() is deprecated.
- *
  */
 function _nc( $single, $plural, $number, $domain = 'default' ) {
@@ -1837 +1772 @@
  *
  * @since 1.2.0
- * @deprecated 2.8.0
- * @deprecated Use _n()
+ * @deprecated 2.8.0 Use _n()
  * @see _n()
  */
@@ -1851 +1785 @@
  *
  * @since 2.5.0
- * @deprecated 2.8.0
- * @deprecated Use _n_noop()
+ * @deprecated 2.8.0 Use _n_noop()
  * @see _n_noop()
  */
@@ -1866 +1799 @@
  *
  * @since 1.0.0
- * @deprecated 3.0.0
- * @deprecated Use wp_load_alloptions())
+ * @deprecated 3.0.0 Use wp_load_alloptions())
  * @see wp_load_alloptions()
  *
@@ -1881 +1813 @@
  *
  * @since 2.0.0
- * @deprecated 2.5.0
- * @deprecated Use wp_get_attachment_link()
+ * @deprecated 2.5.0 Use wp_get_attachment_link()
  * @see wp_get_attachment_link()
  *
@@ -1912 +1843 @@
  *
  * @since 2.1.0
- * @deprecated 2.5.0
- * @deprecated Use wp_get_attachment_image_src()
+ * @deprecated 2.5.0 Use wp_get_attachment_image_src()
  * @see wp_get_attachment_image_src()
  *
@@ -1954 +1884 @@
  *
  * @since 2.0.0
- * @deprecated 2.5.0
- * @deprecated Use wp_get_attachment_image()
+ * @deprecated 2.5.0 Use wp_get_attachment_image()
  * @see wp_get_attachment_image()
  *
@@ -2011 +1940 @@
  *
  * @since 2.0.0
- * @deprecated 2.5.0
- * @deprecated Use wp_get_attachment_image()
+ * @deprecated 2.5.0 Use wp_get_attachment_image()
  * @see wp_get_attachment_image()
  *
@@ -2038 +1966 @@
  *
  * @since 2.0.0
- * @deprecated 2.1.0
- * @deprecated Use get_bookmark()
+ * @deprecated 2.1.0 Use get_bookmark()
  * @see get_bookmark()
  *
@@ -2055 +1982 @@
  *
  * @since 2.3.1
- * @deprecated 2.8.0
- * @deprecated Use esc_url_raw()
+ * @deprecated 2.8.0 Use esc_url_raw()
  * @see esc_url_raw()
  *
@@ -2076 +2002 @@
  *
  * @since 1.2.0
- * @deprecated 3.0.0
- * @deprecated Use esc_url()
+ * @deprecated 3.0.0 Use esc_url()
  * @see Alias for esc_url()
  *
@@ -2099 +2024 @@
  *
  * @since 2.0.4
- * @deprecated 2.8.0
- * @deprecated Use esc_js()
+ * @deprecated 2.8.0 Use esc_js()
  * @see esc_js()
  *
@@ -2114 +2038 @@
  * Escaping for HTML blocks.
  *
- * @deprecated 2.8.0
- * @deprecated Use esc_html()
+ * @deprecated 2.8.0 Use esc_html()
  * @see esc_html()
  */
@@ -2132 +2055 @@
  *
  * @since 2.0.6
- * @deprecated 2.8.0
- * @deprecated Use esc_attr()
+ * @deprecated 2.8.0 Use esc_attr()
  * @see esc_attr()
  *
@@ -2155 +2077 @@
  *
  * @since 2.2.0
- * @deprecated 2.8.0
- * @deprecated Use wp_register_sidebar_widget()
+ * @deprecated 2.8.0 Use wp_register_sidebar_widget()
  * @see wp_register_sidebar_widget()
  *
@@ -2190 +2111 @@
  *
  * @since 2.2.0
- * @deprecated 2.8.0
- * @deprecated Use wp_unregister_sidebar_widget()
+ * @deprecated 2.8.0 Use wp_unregister_sidebar_widget()
  * @see wp_unregister_sidebar_widget()
  *
@@ -2208 +2128 @@
  * the array for the name.
  *
- * Passes to {@link wp_register_widget_control()} after the argument list has
+ * Passes to wp_register_widget_control() after the argument list has
  * been compiled.
  *
  * @since 2.2.0
- * @deprecated 2.8.0
- * @deprecated Use wp_register_widget_control()
+ * @deprecated 2.8.0 Use wp_register_widget_control()
  * @see wp_register_widget_control()
  *
@@ -2246 +2165 @@
 
 /**
- * Alias of {@link wp_unregister_widget_control()}.
+ * Alias of wp_unregister_widget_control().
  *
  * @since 2.2.0
- * @deprecated 2.8.0
- * @deprecated Use wp_unregister_widget_control()
+ * @deprecated 2.8.0 Use wp_unregister_widget_control()
  * @see wp_unregister_widget_control()
  *
@@ -2264 +2182 @@
  *
  * @since 2.0.0
- * @deprecated 3.0.0
- * @deprecated Use delete_user_meta()
+ * @deprecated 3.0.0 Use delete_user_meta()
  * @see delete_user_meta()
  *
@@ -2312 +2229 @@
  *
  * @since 2.0.0
- * @deprecated 3.0.0
- * @deprecated Use get_user_meta()
+ * @deprecated 3.0.0 Use get_user_meta()
  * @see get_user_meta()
  *
@@ -2365 +2281 @@
  *
  * @since 2.0.0
- * @deprecated 3.0.0
- * @deprecated Use update_user_meta()
+ * @deprecated 3.0.0 Use update_user_meta()
  * @see update_user_meta()
  *
@@ -2420 +2335 @@
  *
  * @since 2.2.0
- * @deprecated 3.1.0
+ * @deprecated 3.1.0 Use get_users()
+ * @see get_users()
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -2443 +2359 @@
  *
  * @since 2.8.0
- * @deprecated 3.0.0
- * @deprecated Use add_theme_support( 'automatic-feed-links' )
+ * @deprecated 3.0.0 Use add_theme_support()
+ * @see add_theme_support()
  *
  * @param bool $add Optional, default is true. Add or remove links. Defaults to true.
@@ -2461 +2377 @@
  *
  * @since 1.5.0
- * @deprecated 3.0.0
- * @deprecated Use get_the_author_meta()
+ * @deprecated 3.0.0 Use get_the_author_meta()
  * @see get_the_author_meta()
  */
@@ -2478 +2393 @@
  *
  * @since 0.71
- * @deprecated 3.0.0
- * @deprecated Use count_user_posts()
+ * @deprecated 3.0.0 Use count_user_posts()
  * @see count_user_posts()
  */
@@ -2507 +2421 @@
  *
  * @since 1.5.0
+ * @deprecated 3.0.0
+ *
  * @uses $is_macIE
  * @uses $is_winIE
- * @deprecated 3.0.0
  *
  * @param string $text Text to be made safe.
@@ -2531 +2446 @@
  *
  * @since 2.3.0
- * @deprecated 3.0.0
- * @deprecated Use taxonomy_exists()
+ * @deprecated 3.0.0 Use taxonomy_exists()
  * @see taxonomy_exists()
  *
@@ -2547 +2461 @@
  *
  * @since 2.3.0
- * @deprecated 3.0.0
- * @deprecated Use term_exists()
+ * @deprecated 3.0.0 Use term_exists()
  * @see term_exists()
  *
@@ -2564 +2477 @@
  * Is the current admin page generated by a plugin?
  *
+ * Use global $plugin_page and/or get_plugin_page_hookname() hooks.
+ *
  * @since 1.5.0
  * @deprecated 3.1.0
- * @deprecated Use global $plugin_page and/or get_plugin_page_hookname() hooks.
  *
  * @global $plugin_page
@@ -2619 +2533 @@
  *
  * @since 2.1.0
- * @deprecated 3.3.0
- * @deprecated Use wp_editor()
+ * @deprecated 3.3.0 Use wp_editor()
  * @see wp_editor()
  *
@@ -2856 +2769 @@
  *
  * @since MU
- * @deprecated 3.3.0
- * @deprecated Use is_user_member_of_blog()
+ * @deprecated 3.3.0 Use is_user_member_of_blog()
  * @see is_user_member_of_blog()
  *
@@ -2873 +2785 @@
  *
  * @since 0.71
- * @deprecated Use error_log()
+ * @deprecated 3.4.0 Use error_log()
+ * @see error_log()
+ *
  * @link http://www.php.net/manual/en/function.error-log.php
- * @deprecated 3.4.0
  */
 function debug_fopen( $filename, $mode ) {
@@ -2886 +2799 @@
  *
  * @since 0.71
- * @deprecated Use error_log() instead.
+ * @deprecated 3.4.0 Use error_log()
+ * @see error_log()
+ *
  * @link http://www.php.net/manual/en/function.error-log.php
- * @deprecated 3.4.0
  */
 function debug_fwrite( $fp, $string ) {
@@ -2900 +2814 @@
  *
  * @since 0.71
- * @deprecated Use error_log()
+ * @deprecated 3.4.0 Use error_log()
+ * @see error_log()
+ *
  * @link http://www.php.net/manual/en/function.error-log.php
- * @deprecated 3.4.0
  */
 function debug_fclose( $fp ) {
@@ -2916 +2831 @@
  *
  * @since 1.5.0
- * @deprecated 3.4.0
- * @deprecated Use wp_get_themes()
+ * @deprecated 3.4.0 Use wp_get_themes()
  * @see wp_get_themes()
  *
@@ -2947 +2861 @@
  *
  * @since 1.5.0
- * @deprecated 3.4.0
- * @deprecated Use wp_get_theme()
+ * @deprecated 3.4.0 Use wp_get_theme()
  * @see wp_get_theme()
  *
@@ -2967 +2880 @@
  *
  * @since 1.5.0
- * @deprecated 3.4.0
- * @deprecated Use (string) wp_get_theme()
+ * @deprecated 3.4.0 Use wp_get_theme()
  * @see wp_get_theme()
  *
@@ -3014 +2926 @@
  *
  * @since 2.1.0
- * @deprecated 3.4.0
- * @deprecated Use add_theme_support('custom-header', $args)
+ * @deprecated 3.4.0 Use add_theme_support()
  * @see add_theme_support()
  *
@@ -3037 +2948 @@
  *
  * @since 3.1.0
- * @deprecated 3.4.0
- * @deprecated Use remove_theme_support('custom-header')
+ * @deprecated 3.4.0 Use remove_theme_support()
  * @see remove_theme_support()
  *
@@ -3052 +2962 @@
  *
  * @since 3.0.0
- * @deprecated 3.4.0
- * @deprecated Use add_theme_support('custom-background, $args)
+ * @deprecated 3.4.0 Use add_theme_support()
  * @see add_theme_support()
  *
@@ -3076 +2985 @@
  *
  * @since 3.1.0
+ * @deprecated 3.4.0 Use add_custom_background()
  * @see add_custom_background()
  *
@@ -3089 +2999 @@
  *
  * @since 1.5.0
- * @deprecated 3.4.0
- * @deprecated Use wp_get_theme()
+ * @deprecated 3.4.0 Use wp_get_theme()
  * @see wp_get_theme()
  *
@@ -3128 +3037 @@
  *
  * @since 1.5.1
- * @deprecated 3.4.0
+ * @deprecated 3.4.0 Use update_post_cache()
+ * @see update_post_cache()
  *
  * @param array $pages list of page objects
@@ -3145 +3055 @@
  *
  * @since 2.0.0
- * @deprecated 3.4.0
+ * @deprecated 3.4.0 Use clean_post_cache
+ * @see clean_post_cache()
  *
  * @param int $id Page ID to clean
@@ -3161 +3072 @@
  *
  * @since 2.0.4
- * @deprecated 3.4.1
- * @deprecated Use wp_nonce_ays()
+ * @deprecated 3.4.1 Use wp_nonce_ays()
  * @see wp_nonce_ays()
  *
@@ -3177 +3087 @@
  *
  * @since 2.7.0
- * @deprecated 3.5.0
- * @deprecated Use post_class()
+ * @deprecated 3.5.0 Use post_class()
  * @see post_class()
  *
@@ -3196 +3105 @@
  *
  * @since 2.3.4
- * @deprecated 3.5.0
+ * @deprecated 3.5.0 Use get_post_ancestors()
  * @see get_post_ancestors()
  */
@@ -3207 +3116 @@
  *
  * @since 2.1.0
- * @deprecated 3.5.0
+ * @deprecated 3.5.0 Use wp_get_image_editor()
  * @see wp_get_image_editor()
  *
@@ -3247 +3156 @@
  *
  * @since 2.5.0
- * @deprecated 3.5.0
+ * @deprecated 3.5.0 Use wp_get_image_editor()
  * @see wp_get_image_editor()
  *
@@ -3287 +3196 @@
  *
  * @since 1.0.0
- * @deprecated 3.5.0
+ * @deprecated 3.5.0 Use get_post()
  * @see get_post()
  *
@@ -3303 +3212 @@
  *
  * @since 0.71
- * @deprecated 3.5.0
- * @deprecated Use wp_authenticate()
+ * @deprecated 3.5.0 Use wp_authenticate()
  * @see wp_authenticate()
  *
@@ -3332 +3240 @@
  *
  * @since 2.9.0
- * @deprecated 3.5.0
+ * @deprecated 3.5.0 Use wp_image_editor_supports()
  * @see wp_image_editor_supports()
  *
@@ -3367 +3275 @@
  *
  * @since 2.3.0
- * @deprecated 3.6.0
- * @deprecated Use size_format()
+ * @deprecated 3.6.0 Use size_format()
+ * @see size_format()
  *
  * @param int $bytes An integer byte value.
@@ -3394 +3302 @@
  * Formerly used internally to tidy up the search terms.
  *
+ * @since 2.9.0
  * @access private
- * @since 2.9.0
  * @deprecated 3.7.0
  */
@@ -3428 +3336 @@
  *
  * @since 2.7.0
+ * @access private
  * @deprecated 3.9.0
- * @access private
  */
 function default_topic_count_text( $count ) {
@@ -3455 +3363 @@
  *
  * @since 2.5.0
- * @deprecated 4.0.0
- * @deprecated Use wpdb::esc_like()
+ * @deprecated 4.0.0 Use wpdb::esc_like()
+ * @see wpdb::esc_like()
  *
  * @param string $text The text to be escaped.
@@ -3615 +3523 @@
  *
  * @since 2.5.0
- * @deprecated 4.3.0
+ * @deprecated 4.3.0 Use format_for_editor()
+ * @see format_for_editor()
  *
  * @param string $output The text to be formatted.
@@ -3641 +3550 @@
  *
  * @since 1.0.0
- * @deprecated 4.4.0
+ * @deprecated 4.4.0 Use get_permalink()
+ * @see get_permalink()
  *
  * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global $post.