WordPress.org

Make WordPress Core

Ticket #7493: 7493-deprecated-docs.diff

File 7493-deprecated-docs.diff, 36.0 KB (added by nacin, 6 years ago)
  • wp-includes/deprecated.php

     
    8282 * Entire Post data. 
    8383 * 
    8484 * @since 0.71 
     85 * @deprecated 1.5.1 
    8586 * @deprecated Use get_post() 
    8687 * @see get_post() 
    8788 * 
     
    8990 * @return array 
    9091 */ 
    9192function get_postdata($postid) { 
    92         _deprecated_function(__FUNCTION__, '0.0', 'get_post()'); 
     93        _deprecated_function(__FUNCTION__, '1.5.1', 'get_post()'); 
    9394 
    9495        $post = &get_post($postid); 
    9596 
     
    118119 * Sets up the WordPress Loop. 
    119120 * 
    120121 * @since 1.0.1 
    121  * @deprecated Since 1.5 - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop} 
     122 * @deprecated 1.5 
     123 * @deprecated Use The Loop - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop} 
    122124 */ 
    123125function start_wp() { 
    124126        global $wp_query, $post; 
     
    135137 * Return or Print Category ID. 
    136138 * 
    137139 * @since 0.71 
     140 * @deprecated 0.71 
    138141 * @deprecated use get_the_category() 
    139142 * @see get_the_category() 
    140143 * 
     
    142145 * @return null|int 
    143146 */ 
    144147function the_category_ID($echo = true) { 
    145         _deprecated_function(__FUNCTION__, '0.0', 'get_the_category()'); 
     148        _deprecated_function(__FUNCTION__, '0.71', 'get_the_category()'); 
    146149 
    147150        // Grab the first cat in the list. 
    148151        $categories = get_the_category(); 
     
    158161 * Print category with optional text before and after. 
    159162 * 
    160163 * @since 0.71 
     164 * @deprecated 0.71 
    161165 * @deprecated use get_the_category_by_ID() 
    162166 * @see get_the_category_by_ID() 
    163167 * 
     
    167171function the_category_head($before='', $after='') { 
    168172        global $currentcat, $previouscat; 
    169173 
    170         _deprecated_function(__FUNCTION__, '0.0', 'get_the_category_by_ID()'); 
     174        _deprecated_function(__FUNCTION__, '0.71', 'get_the_category_by_ID()'); 
    171175 
    172176        // Grab the first cat in the list. 
    173177        $categories = get_the_category(); 
     
    184188 * Prints link to the previous post. 
    185189 * 
    186190 * @since 1.5 
     191 * @deprecated 2.0 
    187192 * @deprecated Use previous_post_link() 
    188193 * @see previous_post_link() 
    189194 * 
     
    196201 */ 
    197202function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') { 
    198203 
    199         _deprecated_function(__FUNCTION__, '0.0', 'previous_post_link()'); 
     204        _deprecated_function(__FUNCTION__, '2.0', 'previous_post_link()'); 
    200205 
    201206        if ( empty($in_same_cat) || 'no' == $in_same_cat ) 
    202207                $in_same_cat = false; 
     
    220225 * Prints link to the next post. 
    221226 * 
    222227 * @since 0.71 
     228 * @deprecated 2.0 
    223229 * @deprecated Use next_post_link() 
    224230 * @see next_post_link() 
    225231 * 
     
    231237 * @param string $excluded_categories 
    232238 */ 
    233239function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') { 
    234         _deprecated_function(__FUNCTION__, '0.0', 'next_post_link()'); 
     240        _deprecated_function(__FUNCTION__, '2.0', 'next_post_link()'); 
    235241 
    236242        if ( empty($in_same_cat) || 'no' == $in_same_cat ) 
    237243                $in_same_cat = false; 
     
    255261 * Whether user can create a post. 
    256262 * 
    257263 * @since 1.5 
     264 * @deprecated 2.0 
    258265 * @deprecated Use current_user_can() 
    259266 * @see current_user_can() 
    260267 * 
     
    264271 * @return bool 
    265272 */ 
    266273function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') { 
    267         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()'); 
     274        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    268275 
    269276        $author_data = get_userdata($user_id); 
    270277        return ($author_data->user_level > 1); 
     
    274281 * Whether user can create a post. 
    275282 * 
    276283 * @since 1.5 
     284 * @deprecated 2.0 
    277285 * @deprecated Use current_user_can() 
    278286 * @see current_user_can() 
    279287 * 
     
    283291 * @return bool 
    284292 */ 
    285293function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') { 
    286         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()'); 
     294        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    287295 
    288296        $author_data = get_userdata($user_id); 
    289297        return ($author_data->user_level >= 1); 
     
    293301 * Whether user can edit a post. 
    294302 * 
    295303 * @since 1.5 
     304 * @deprecated 2.0 
    296305 * @deprecated Use current_user_can() 
    297306 * @see current_user_can() 
    298307 * 
     
    302311 * @return bool 
    303312 */ 
    304313function user_can_edit_post($user_id, $post_id, $blog_id = 1) { 
    305         _deprecated_function(__FUNCTION__, '0', 'current_user_can()'); 
     314        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    306315 
    307316        $author_data = get_userdata($user_id); 
    308317        $post = get_post($post_id); 
     
    321330 * Whether user can delete a post. 
    322331 * 
    323332 * @since 1.5 
     333 * @deprecated 2.0 
    324334 * @deprecated Use current_user_can() 
    325335 * @see current_user_can() 
    326336 * 
     
    330340 * @return bool 
    331341 */ 
    332342function user_can_delete_post($user_id, $post_id, $blog_id = 1) { 
    333         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()'); 
     343        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    334344 
    335345        // right now if one can edit, one can delete 
    336346        return user_can_edit_post($user_id, $post_id, $blog_id); 
     
    340350 * Whether user can set new posts' dates. 
    341351 * 
    342352 * @since 1.5 
     353 * @deprecated 2.0 
    343354 * @deprecated Use current_user_can() 
    344355 * @see current_user_can() 
    345356 * 
     
    349360 * @return bool 
    350361 */ 
    351362function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') { 
    352         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()'); 
     363        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    353364 
    354365        $author_data = get_userdata($user_id); 
    355366        return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id)); 
     
    359370 * Whether user can delete a post. 
    360371 * 
    361372 * @since 1.5 
     373 * @deprecated 2.0 
    362374 * @deprecated Use current_user_can() 
    363375 * @see current_user_can() 
    364376 * 
     
    368380 * @return bool returns true if $user_id can edit $post_id's date 
    369381 */ 
    370382function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) { 
    371         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()'); 
     383        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    372384 
    373385        $author_data = get_userdata($user_id); 
    374386        return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id)); 
     
    378390 * Whether user can delete a post. 
    379391 * 
    380392 * @since 1.5 
     393 * @deprecated 2.0 
    381394 * @deprecated Use current_user_can() 
    382395 * @see current_user_can() 
    383396 * 
     
    387400 * @return bool returns true if $user_id can edit $post_id's comments 
    388401 */ 
    389402function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) { 
    390         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()'); 
     403        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    391404 
    392405        // right now if one can edit a post, one can edit comments made on it 
    393406        return user_can_edit_post($user_id, $post_id, $blog_id); 
     
    397410 * Whether user can delete a post. 
    398411 * 
    399412 * @since 1.5 
     413 * @deprecated 2.0 
    400414 * @deprecated Use current_user_can() 
    401415 * @see current_user_can() 
    402416 * 
     
    406420 * @return bool returns true if $user_id can delete $post_id's comments 
    407421 */ 
    408422function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) { 
    409         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()'); 
     423        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    410424 
    411425        // right now if one can edit comments, one can delete comments 
    412426        return user_can_edit_post_comments($user_id, $post_id, $blog_id); 
     
    416430 * Can user can edit other user. 
    417431 * 
    418432 * @since 1.5 
     433 * @deprecated 2.0 
    419434 * @deprecated Use current_user_can() 
    420435 * @see current_user_can() 
    421436 * 
     
    424439 * @return bool 
    425440 */ 
    426441function user_can_edit_user($user_id, $other_user) { 
    427         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()'); 
     442        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()'); 
    428443 
    429444        $user  = get_userdata($user_id); 
    430445        $other = get_userdata($other_user); 
     
    438453 * Gets the links associated with category $cat_name. 
    439454 * 
    440455 * @since 0.71 
    441  * @deprecated Use get_links() 
    442  * @see get_links() 
     456 * @deprecated 2.1 
     457 * @deprecated Use get_bookmarks() 
     458 * @see get_bookmarks() 
    443459 * 
    444460 * @param string $cat_name Optional. The category name to use. If no match is found uses all. 
    445461 * @param string $before Optional. The html to output before the link. 
     
    457473function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id', 
    458474                                                 $show_description = true, $show_rating = false, 
    459475                                                 $limit = -1, $show_updated = 0) { 
    460         _deprecated_function(__FUNCTION__, '0.0', 'get_links()'); 
     476        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()'); 
    461477 
    462478        $cat_id = -1; 
    463479        $cat = get_term_by('name', $cat_name, 'link_category'); 
     
    471487 * Gets the links associated with the named category. 
    472488 * 
    473489 * @since 1.0.1 
    474  * @deprecated Use wp_get_links() 
    475  * @see wp_get_links() 
     490 * @deprecated 2.1 
     491 * @deprecated Use wp_list_bookmarks() 
     492 * @see wp_list_bookmarks() 
    476493 * 
    477494 * @param string $category The category to use. 
    478495 * @param string $args 
    479496 * @return bool|null 
    480497 */ 
    481498function wp_get_linksbyname($category, $args = '') { 
    482         _deprecated_function(__FUNCTION__, '0.0', 'wp_get_links()'); 
     499        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()'); 
    483500 
    484         $cat = get_term_by('name', $category, 'link_category'); 
    485         if ( !$cat ) 
    486                 return false; 
    487         $cat_id = $cat->term_id; 
     501        $defaults = array( 
     502                'after' => '<br />', 
     503                'before' => '', 
     504                'categorize' => 0, 
     505                'category_after' => '', 
     506                'category_before' => '', 
     507                'category_name' => $category, 
     508                'show_description' => 1, 
     509                'title_li' => '', 
     510        ); 
    488511 
    489         $args = add_query_arg('category', $cat_id, $args); 
    490         wp_get_links($args); 
     512        $r = wp_parse_args( $args, $defaults ); 
     513        return wp_list_bookmarks( $r ); 
    491514} 
    492515 
    493516/** 
     
    501524 * </code> 
    502525 * 
    503526 * @since 1.0.1 
    504  * @deprecated Use get_linkobjects() 
    505  * @see get_linkobjects() 
     527 * @deprecated 2.1 
     528 * @deprecated Use get_bookmarks() 
     529 * @see get_bookmarks() 
    506530 * 
    507531 * @param string $cat_name The category name to use. If no match is found uses all. 
    508532 * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'. 
     
    512536 * @return unknown 
    513537 */ 
    514538function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) { 
    515         _deprecated_function(__FUNCTION__, '0.0', 'get_linkobjects()'); 
     539        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()'); 
    516540 
    517541        $cat_id = -1; 
    518542        $cat = get_term_by('name', $cat_name, 'link_category'); 
     
    553577 * </ol> 
    554578 * 
    555579 * @since 1.0.1 
     580 * @deprecated 2.1 
    556581 * @deprecated Use get_bookmarks() 
    557582 * @see get_bookmarks() 
    558583 * 
     
    565590 * @return unknown 
    566591 */ 
    567592function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) { 
    568         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()'); 
     593        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()'); 
    569594 
    570595        $links = get_bookmarks("category=$category&orderby=$orderby&limit=$limit"); 
    571596 
     
    580605 * Gets the links associated with category 'cat_name' and display rating stars/chars. 
    581606 * 
    582607 * @since 0.71 
     608 * @deprecated 2.1 
    583609 * @deprecated Use get_bookmarks() 
    584610 * @see get_bookmarks() 
    585611 * 
     
    598624 */ 
    599625function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ", 
    600626                                                                        $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { 
    601         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()'); 
     627        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()'); 
    602628 
    603629        get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); 
    604630} 
     
    607633 * Gets the links associated with category n and display rating stars/chars. 
    608634 * 
    609635 * @since 0.71 
     636 * @deprecated 2.1 
    610637 * @deprecated Use get_bookmarks() 
    611638 * @see get_bookmarks() 
    612639 * 
     
    625652 */ 
    626653function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true, 
    627654                                                          $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { 
    628         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()'); 
     655        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()'); 
    629656 
    630657        get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); 
    631658} 
     
    640667 * @return int Only returns 0. 
    641668 */ 
    642669function get_autotoggle($id = 0) { 
    643         _deprecated_function(__FUNCTION__, '0.0' ); 
     670        _deprecated_function(__FUNCTION__, '2.1' ); 
    644671        return 0; 
    645672} 
    646673 
    647674/** 
    648675 * @since 0.71 
     676 * @deprecated 2.1 
    649677 * @deprecated Use wp_list_categories() 
    650678 * @see wp_list_categories() 
    651679 * 
     
    672700function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0, 
    673701                                   $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0, 
    674702                                   $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) { 
    675         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_categories()'); 
     703        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()'); 
    676704 
    677705        $query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children', 
    678706                'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical'); 
     
    681709 
    682710/** 
    683711 * @since 1.2 
     712 * @deprecated 2.1 
    684713 * @deprecated Use wp_list_categories() 
    685714 * @see wp_list_categories() 
    686715 * 
     
    688717 * @return unknown 
    689718 */ 
    690719function wp_list_cats($args = '') { 
    691         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_categories()'); 
     720        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()'); 
    692721 
    693722        $r = wp_parse_args( $args ); 
    694723 
     
    730759function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc', 
    731760                $show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false, 
    732761                $selected = 0, $exclude = 0) { 
    733         _deprecated_function(__FUNCTION__, '0.0', 'wp_dropdown_categories()'); 
     762        _deprecated_function(__FUNCTION__, '2.1', 'wp_dropdown_categories()'); 
    734763 
    735764        $show_option_all = ''; 
    736765        if ( $optionall ) 
     
    748777 
    749778/** 
    750779 * @since 2.1 
     780 * @deprecated 2.1 
    751781 * @deprecated Use wp_tiny_mce(). 
    752782 * @see wp_tiny_mce() 
    753783 */ 
    754784function tinymce_include() { 
    755         _deprecated_function(__FUNCTION__, '0.0', 'wp_tiny_mce()'); 
     785        _deprecated_function(__FUNCTION__, '2.1', 'wp_tiny_mce()'); 
    756786 
    757787        wp_tiny_mce(); 
    758788} 
    759789 
    760790/** 
    761791 * @since 1.2 
     792 * @deprecated 2.1 
    762793 * @deprecated Use wp_list_authors() 
    763794 * @see wp_list_authors() 
    764795 * 
     
    771802 * @return unknown 
    772803 */ 
    773804function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') { 
    774         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_authors()'); 
     805        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_authors()'); 
    775806 
    776807        $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image'); 
    777808        return wp_list_authors($args); 
     
    779810 
    780811/** 
    781812 * @since 1.0.1 
     813 * @deprecated 2.1 
    782814 * @deprecated Use wp_get_post_categories() 
    783815 * @see wp_get_post_categories() 
    784816 * 
     
    787819 * @return unknown 
    788820 */ 
    789821function wp_get_post_cats($blogid = '1', $post_ID = 0) { 
    790         _deprecated_function(__FUNCTION__, '0.0', 'wp_get_post_categories()'); 
     822        _deprecated_function(__FUNCTION__, '2.1', 'wp_get_post_categories()'); 
    791823        return wp_get_post_categories($post_ID); 
    792824} 
    793825 
     
    795827 * Sets the categories that the post id belongs to. 
    796828 * 
    797829 * @since 1.0.1 
     830 * @deprecated 2.1 
    798831 * @deprecated Use wp_set_post_categories() 
    799832 * @see wp_set_post_categories() 
    800833 * 
     
    804837 * @return unknown 
    805838 */ 
    806839function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) { 
    807         _deprecated_function(__FUNCTION__, '0.0', 'wp_set_post_categories()'); 
     840        _deprecated_function(__FUNCTION__, '2.1', 'wp_set_post_categories()'); 
    808841        return wp_set_post_categories($post_ID, $post_categories); 
    809842} 
    810843 
    811844/** 
    812845 * @since 0.71 
     846 * @deprecated 2.1 
    813847 * @deprecated Use wp_get_archives() 
    814848 * @see wp_get_archives() 
    815849 * 
     
    822856 * @return unknown 
    823857 */ 
    824858function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) { 
    825         _deprecated_function(__FUNCTION__, '0.0', 'wp_get_archives()'); 
     859        _deprecated_function(__FUNCTION__, '2.1', 'wp_get_archives()'); 
    826860        $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count'); 
    827861        return wp_get_archives($args); 
    828862} 
     
    831865 * Returns or Prints link to the author's posts. 
    832866 * 
    833867 * @since 1.2 
     868 * @deprecated 2.1 
    834869 * @deprecated Use get_author_posts_url() 
    835870 * @see get_author_posts_url() 
    836871 * 
     
    840875 * @return string|null 
    841876 */ 
    842877function get_author_link($echo = false, $author_id, $author_nicename = '') { 
    843         _deprecated_function(__FUNCTION__, '0.0', 'get_author_posts_url()'); 
     878        _deprecated_function(__FUNCTION__, '2.1', 'get_author_posts_url()'); 
    844879 
    845880        $link = get_author_posts_url($author_id, $author_nicename); 
    846881 
     
    853888 * Print list of pages based on arguments. 
    854889 * 
    855890 * @since 0.71 
     891 * @deprecated 2.1 
    856892 * @deprecated Use wp_link_pages() 
    857893 * @see wp_link_pages() 
    858894 * 
     
    867903 */ 
    868904function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page', 
    869905                                        $pagelink='%', $more_file='') { 
    870         _deprecated_function(__FUNCTION__, '0.0', 'wp_link_pages()'); 
     906        _deprecated_function(__FUNCTION__, '2.1', 'wp_link_pages()'); 
    871907 
    872908        $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file'); 
    873909        return wp_link_pages($args); 
     
    877913 * Get value based on option. 
    878914 * 
    879915 * @since 0.71 
     916 * @deprecated 2.1 
    880917 * @deprecated Use get_option() 
    881918 * @see get_option() 
    882919 * 
     
    884921 * @return string 
    885922 */ 
    886923function get_settings($option) { 
    887         _deprecated_function(__FUNCTION__, '0.0', 'get_option()'); 
     924        _deprecated_function(__FUNCTION__, '2.1', 'get_option()'); 
    888925 
    889926        return get_option($option); 
    890927} 
     
    893930 * Print the permalink of the current post in the loop. 
    894931 * 
    895932 * @since 0.71 
     933 * @deprecated 1.2 
    896934 * @deprecated Use the_permalink() 
    897935 * @see the_permalink() 
    898936 */ 
    899937function permalink_link() { 
    900         _deprecated_function(__FUNCTION__, '0.0', 'the_permalink()'); 
     938        _deprecated_function(__FUNCTION__, '1.2', 'the_permalink()'); 
    901939        the_permalink(); 
    902940} 
    903941 
     
    905943 * Print the permalink to the RSS feed. 
    906944 * 
    907945 * @since 0.71 
     946 * @deprecated 2.3 
    908947 * @deprecated Use the_permalink_rss() 
    909948 * @see the_permalink_rss() 
    910949 * 
    911950 * @param string $file 
    912951 */ 
    913952function permalink_single_rss($deprecated = '') { 
    914         _deprecated_function(__FUNCTION__, '0.0', 'the_permalink_rss()'); 
     953        _deprecated_function(__FUNCTION__, '2.3', 'the_permalink_rss()'); 
    915954        the_permalink_rss(); 
    916955} 
    917956 
    918957/** 
    919958 * Gets the links associated with category. 
    920959 * 
    921  * @see get_links() for argument information that can be used in $args 
    922960 * @since 1.0.1 
    923  * @deprecated Use get_bookmarks() 
    924  * @see get_bookmarks() 
     961 * @deprecated 2.1 
     962 * @deprecated Use wp_list_bookmarks() 
     963 * @see wp_list_bookmarks() 
    925964 * 
    926965 * @param string $args a query string 
    927966 * @return null|string 
    928967 */ 
    929968function wp_get_links($args = '') { 
    930         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()'); 
     969        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()'); 
    931970 
    932971        if ( strpos( $args, '=' ) === false ) { 
    933972                $cat_id = $args; 
     
    935974        } 
    936975 
    937976        $defaults = array( 
    938                 'category' => -1, 'before' => '', 
    939                 'after' => '<br />', 'between' => ' ', 
    940                 'show_images' => true, 'orderby' => 'name', 
    941                 'show_description' => true, 'show_rating' => false, 
    942                 'limit' => -1, 'show_updated' => true, 
    943                 'echo' => true 
     977                'after' => '<br />', 
     978                'before' => '', 
     979                'between' => ' ', 
     980                'categorize' => 0, 
     981                'category' => '', 
     982                'echo' => true, 
     983                'limit' => -1, 
     984                'orderby' => 'name', 
     985                'show_description' => true, 
     986                'show_images' => true, 
     987                'show_rating' => false, 
     988                'show_updated' => true, 
     989                'title_li' => '', 
    944990        ); 
    945991 
    946992        $r = wp_parse_args( $args, $defaults ); 
    947         extract( $r, EXTR_SKIP ); 
    948993 
    949         return get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated, $echo); 
     994        return wp_list_bookmarks( $r ); 
    950995} 
    951996 
    952997/** 
    953998 * Gets the links associated with category by id. 
    954999 * 
    9551000 * @since 0.71 
     1001 * @deprecated 2.1 
    9561002 * @deprecated Use get_bookmarks() 
    9571003 * @see get_bookmarks() 
    9581004 * 
     
    9751021 */ 
    9761022function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name', 
    9771023                        $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) { 
    978         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()'); 
     1024        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()'); 
    9791025 
    9801026        $order = 'ASC'; 
    9811027        if ( substr($orderby, 0, 1) == '_' ) { 
     
    10621108 * 
    10631109 * @author Dougal 
    10641110 * @since 1.0.1 
     1111 * @deprecated 2.1 
    10651112 * @deprecated Use wp_list_bookmarks() 
    10661113 * @see wp_list_bookmarks() 
    10671114 * 
     
    10691116 * @param string $$deprecated Not Used 
    10701117 */ 
    10711118function get_links_list($order = 'name', $deprecated = '') { 
    1072         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_bookmarks()'); 
     1119        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()'); 
    10731120 
    10741121        $order = strtolower($order); 
    10751122 
     
    11081155 * @link http://sprite.csr.unibo.it/fullo/ 
    11091156 * 
    11101157 * @since 0.71 
     1158 * @deprecated 2.1 
    11111159 * @deprecated {@internal Use function instead is unknown}} 
    11121160 * 
    11131161 * @param string $text the text of the link 
     
    11171165 * @param bool $count the number of links in the db 
    11181166 */ 
    11191167function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) { 
    1120         _deprecated_function(__FUNCTION__, '0.0' ); 
     1168        _deprecated_function(__FUNCTION__, '2.1' ); 
    11211169 
    11221170        if ( $count ) 
    11231171                $counts = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->links"); 
     
    11341182 
    11351183/** 
    11361184 * @since 1.0.1 
     1185 * @deprecated 2.1 
    11371186 * @deprecated Use sanitize_bookmark_field() 
    11381187 * @see sanitize_bookmark_field() 
    11391188 * 
     
    11411190 * @return unknown 
    11421191 */ 
    11431192function get_linkrating($link) { 
    1144         _deprecated_function(__FUNCTION__, '0.0', 'sanitize_bookmark_field()'); 
     1193        _deprecated_function(__FUNCTION__, '2.1', 'sanitize_bookmark_field()'); 
    11451194        return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display'); 
    11461195} 
    11471196 
     
    11491198 * Gets the name of category by id. 
    11501199 * 
    11511200 * @since 0.71 
     1201 * @deprecated 2.1 
    11521202 * @deprecated Use get_category() 
    11531203 * @see get_category() 
    11541204 * 
     
    11561206 * @return string 
    11571207 */ 
    11581208function get_linkcatname($id = 0) { 
    1159         _deprecated_function(__FUNCTION__, '0.0', 'get_category()'); 
     1209        _deprecated_function(__FUNCTION__, '2.1', 'get_category()'); 
    11601210 
    11611211        $id = (int) $id; 
    11621212 
     
    11781228 * Print RSS comment feed link. 
    11791229 * 
    11801230 * @since 1.0.1 
     1231 * @deprecated 2.5 
    11811232 * @deprecated Use post_comments_feed_link() 
    11821233 * @see post_comments_feed_link() 
    11831234 * 
     
    11851236 * @param string $deprecated Not used 
    11861237 */ 
    11871238function comments_rss_link($link_text = 'Comments RSS', $deprecated = '') { 
    1188         _deprecated_function(__FUNCTION__, '0.0', 'post_comments_feed_link()'); 
     1239        _deprecated_function(__FUNCTION__, '2.5', 'post_comments_feed_link()'); 
    11891240        post_comments_feed_link($link_text); 
    11901241} 
    11911242 
     
    11931244 * Print/Return link to category RSS2 feed. 
    11941245 * 
    11951246 * @since 1.2 
     1247 * @deprecated 2.5 
    11961248 * @deprecated Use get_category_feed_link() 
    11971249 * @see get_category_feed_link() 
    11981250 * 
     
    12021254 * @return string|null 
    12031255 */ 
    12041256function get_category_rss_link($echo = false, $cat_ID = 1, $deprecated = '') { 
    1205         _deprecated_function(__FUNCTION__, '0.0', 'get_category_feed_link()'); 
     1257        _deprecated_function(__FUNCTION__, '2.5', 'get_category_feed_link()'); 
    12061258 
    12071259        $link = get_category_feed_link($cat_ID, 'rss2'); 
    12081260 
     
    12151267 * Print/Return link to author RSS feed. 
    12161268 * 
    12171269 * @since 1.2 
     1270 * @deprecated 2.5 
    12181271 * @deprecated Use get_author_feed_link() 
    12191272 * @see get_author_feed_link() 
    12201273 * 
     
    12241277 * @return string|null 
    12251278 */ 
    12261279function get_author_rss_link($echo = false, $author_id = 1, $deprecated = '') { 
    1227         _deprecated_function(__FUNCTION__, '0.0', 'get_author_feed_link()'); 
     1280        _deprecated_function(__FUNCTION__, '2.5', 'get_author_feed_link()'); 
    12281281 
    12291282        $link = get_author_feed_link($author_id); 
    12301283        if ( $echo ) 
     
    12361289 * Return link to the post RSS feed. 
    12371290 * 
    12381291 * @since 1.5 
     1292 * @deprecated 2.2 
    12391293 * @deprecated Use get_post_comments_feed_link() 
    12401294 * @see get_post_comments_feed_link() 
    12411295 * 
     
    12501304/** 
    12511305 * An alias of wp_create_user(). 
    12521306 * 
     1307 * @since 2.0 
     1308 * @deprecated 2.0 
     1309 * @deprecated Use wp_create_user() 
     1310 * @see wp_create_user() 
     1311 * 
    12531312 * @param string $username The user's username. 
    12541313 * @param string $password The user's password. 
    12551314 * @param string $email The user's email (optional). 
    12561315 * @return int The new user's ID. 
    1257  * @deprecated Use wp_create_user() 
    1258  * @see wp_create_user() 
    12591316 */ 
    12601317function create_user($username, $password, $email) { 
    12611318        _deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' ); 
     
    12661323 * Unused Admin function. 
    12671324 * 
    12681325 * @since 2.0 
     1326 * @deprecated 2.5 
     1327 * 
    12691328 * @param string $deprecated Unknown 
    1270  * @deprecated 2.5 
    12711329 */ 
    12721330function documentation_link( $deprecated = '' ) { 
    12731331        _deprecated_function( __FUNCTION__, '2.5', '' ); 
     
    12861344/** 
    12871345 * Retrieve an array of comment data about comment $comment_ID. 
    12881346 * 
     1347 * @since 0.71 
     1348 * @deprecated 2.7 
    12891349 * @deprecated Use get_comment() 
    12901350 * @see get_comment() 
    1291  * @since 0.71 
    12921351 * 
    1293  * @uses $id 
    1294  * @uses $wpdb Database Object 
    1295  * 
    12961352 * @param int $comment_ID The ID of the comment 
    12971353 * @param int $no_cache Whether to use the cache or not (casted to bool) 
    12981354 * @param bool $include_unapproved Whether to include unapproved comments or not 
     
    13071363 * Retrieve the category name by the category ID. 
    13081364 * 
    13091365 * @since 0.71 
     1366 * @deprecated 2.8 
    13101367 * @deprecated Use get_cat_name() 
    1311  * @see get_cat_name() get_catname() is deprecated in favor of get_cat_name(). 
     1368 * @see get_cat_name() 
    13121369 * 
    13131370 * @param int $cat_ID Category ID 
    13141371 * @return string category name 
     
    13221379 * Retrieve category children list separated before and after the term IDs. 
    13231380 * 
    13241381 * @since 1.2.0 
     1382 * @deprecated 2.8 
     1383 * @deprecated Use get_term_children() 
     1384 * @see get_term_children() 
    13251385 * 
    13261386 * @param int $id Category ID to retrieve children. 
    13271387 * @param string $before Optional. Prepend before category term ID. 
     
    13581418 * 
    13591419 * @since 1.5 
    13601420 * @deprecated 2.8 
    1361  * @uses $authordata The current author's DB object. 
     1421 * @deprecated Use the_author_meta('description') 
     1422 * @see get_the_author_meta() 
     1423 * 
    13621424 * @return string The author's description. 
    1363  * @deprecated Use the_author_meta('description') 
    13641425 */ 
    13651426function get_the_author_description() { 
    13661427        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' ); 
     
    13701431/** 
    13711432 * Display the description of the author of the current post. 
    13721433 * 
    1373  * @link http://codex.wordpress.org/Template_Tags/the_author_description 
    13741434 * @since 1.0.0 
    13751435 * @deprecated 2.8 
    13761436 * @deprecated Use the_author_meta('description') 
     1437 * @see the_author_meta() 
    13771438 */ 
    13781439function the_author_description() { 
    13791440        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'description\')' ); 
     
    13851446 * 
    13861447 * @since 1.5 
    13871448 * @deprecated 2.8 
    1388  * @uses $authordata The current author's DB object. 
     1449 * @deprecated Use the_author_meta('login') 
     1450 * @see get_the_author_meta() 
     1451 * 
    13891452 * @return string The author's login name (username). 
    1390  * @deprecated Use the_author_meta('login') 
    13911453 */ 
    13921454function get_the_author_login() { 
    13931455        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' ); 
     
    13971459/** 
    13981460 * Display the login name of the author of the current post. 
    13991461 * 
    1400  * @link http://codex.wordpress.org/Template_Tags/the_author_login 
    14011462 * @since 0.71 
    14021463 * @deprecated 2.8 
    14031464 * @deprecated Use the_author_meta('login') 
     1465 * @see the_author_meta() 
    14041466 */ 
    14051467function the_author_login() { 
    14061468        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'login\')' ); 
     
    14121474 * 
    14131475 * @since 1.5 
    14141476 * @deprecated 2.8 
    1415  * @uses $authordata The current author's DB object. 
     1477 * @deprecated Use the_author_meta('first_name') 
     1478 * @see get_the_author_meta() 
     1479 * 
    14161480 * @return string The author's first name. 
    1417  * @deprecated Use the_author_meta('first_name') 
    14181481 */ 
    14191482function get_the_author_firstname() { 
    14201483        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' ); 
     
    14241487/** 
    14251488 * Display the first name of the author of the current post. 
    14261489 * 
    1427  * @link http://codex.wordpress.org/Template_Tags/the_author_firstname 
    14281490 * @since 0.71 
    14291491 * @deprecated 2.8 
    14301492 * @deprecated Use the_author_meta('first_name') 
     1493 * @see the_author_meta() 
    14311494 */ 
    14321495function the_author_firstname() { 
    14331496        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' ); 
     
    14391502 * 
    14401503 * @since 1.5 
    14411504 * @deprecated 2.8 
    1442  * @uses $authordata The current author's DB object. 
     1505 * @deprecated Use get_the_author_meta('last_name') 
     1506 * @see get_the_author_meta() 
     1507 * 
    14431508 * @return string The author's last name. 
    1444  * @deprecated Use the_author_meta('last_name') 
    14451509 */ 
    14461510function get_the_author_lastname() { 
    14471511        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' ); 
     
    14511515/** 
    14521516 * Display the last name of the author of the current post. 
    14531517 * 
    1454  * @link http://codex.wordpress.org/Template_Tags/the_author_lastname 
    14551518 * @since 0.71 
    14561519 * @deprecated 2.8 
    14571520 * @deprecated Use the_author_meta('last_name') 
     1521 * @see the_author_meta() 
    14581522 */ 
    14591523function the_author_lastname() { 
    14601524        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' ); 
     
    14661530 * 
    14671531 * @since 1.5 
    14681532 * @deprecated 2.8 
    1469  * @uses $authordata The current author's DB object. 
     1533 * @deprecated Use get_the_author_meta('nickname') 
     1534 * @see get_the_author_meta() 
     1535 * 
    14701536 * @return string The author's nickname. 
    1471  * @deprecated Use the_author_meta('nickname') 
    14721537 */ 
    14731538function get_the_author_nickname() { 
    14741539        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' ); 
     
    14781543/** 
    14791544 * Display the nickname of the author of the current post. 
    14801545 * 
    1481  * @link http://codex.wordpress.org/Template_Tags/the_author_nickname 
    14821546 * @since 0.71 
    14831547 * @deprecated 2.8 
    14841548 * @deprecated Use the_author_meta('nickname') 
     1549 * @see the_author_meta() 
    14851550 */ 
    14861551function the_author_nickname() { 
    14871552        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' ); 
     
    14931558 * 
    14941559 * @since 1.5 
    14951560 * @deprecated 2.8 
    1496  * @uses $authordata The current author's DB object. 
     1561 * @deprecated Use get_the_author_meta('email') 
     1562 * @see get_the_author_meta() 
     1563 * 
    14971564 * @return string The author's username. 
    1498  * @deprecated Use the_author_meta('email') 
    14991565 */ 
    15001566function get_the_author_email() { 
    15011567        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' ); 
     
    15051571/** 
    15061572 * Display the email of the author of the current post. 
    15071573 * 
    1508  * @link http://codex.wordpress.org/Template_Tags/the_author_email 
    15091574 * @since 0.71 
    15101575 * @deprecated 2.8 
    15111576 * @deprecated Use the_author_meta('email') 
     1577 * @see the_author_meta() 
    15121578 */ 
    15131579function the_author_email() { 
    15141580        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'email\')' ); 
     
    15201586 * 
    15211587 * @since 1.5 
    15221588 * @deprecated 2.8 
    1523  * @uses $authordata The current author's DB object. 
     1589 * @deprecated Use get_the_author_meta('icq') 
     1590 * @see get_the_author_meta() 
     1591 * 
    15241592 * @return string The author's ICQ number. 
    1525  * @deprecated Use the_author_meta('icq') 
    15261593 */ 
    15271594function get_the_author_icq() { 
    15281595        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' ); 
     
    15321599/** 
    15331600 * Display the ICQ number of the author of the current post. 
    15341601 * 
    1535  * @link http://codex.wordpress.org/Template_Tags/the_author_icq 
    15361602 * @since 0.71 
    15371603 * @deprecated 2.8 
    1538  * @see get_the_author_icq() 
    15391604 * @deprecated Use the_author_meta('icq') 
     1605 * @see the_author_meta() 
    15401606 */ 
    15411607function the_author_icq() { 
    15421608        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'icq\')' ); 
     
    15481614 * 
    15491615 * @since 1.5 
    15501616 * @deprecated 2.8 
    1551  * @uses $authordata The current author's DB object. 
     1617 * @deprecated Use get_the_author_meta('yim') 
     1618 * @see get_the_author_meta() 
     1619 * 
    15521620 * @return string The author's Yahoo! IM name. 
    1553  * @deprecated Use the_author_meta('yim') 
    15541621 */ 
    15551622function get_the_author_yim() { 
    15561623        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' ); 
     
    15601627/** 
    15611628 * Display the Yahoo! IM name of the author of the current post. 
    15621629 * 
    1563  * @link http://codex.wordpress.org/Template_Tags/the_author_yim 
    15641630 * @since 0.71 
    15651631 * @deprecated 2.8 
    15661632 * @deprecated Use the_author_meta('yim') 
     1633 * @see the_author_meta() 
    15671634 */ 
    15681635function the_author_yim() { 
    15691636        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'yim\')' ); 
     
    15751642 * 
    15761643 * @since 1.5 
    15771644 * @deprecated 2.8 
    1578  * @uses $authordata The current author's DB object. 
     1645 * @deprecated Use get_the_author_meta('msn') 
     1646 * @see get_the_author_meta() 
     1647 * 
    15791648 * @return string The author's MSN address. 
    1580  * @deprecated Use the_author_meta('msn') 
    15811649 */ 
    15821650function get_the_author_msn() { 
    15831651        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' ); 
     
    15871655/** 
    15881656 * Display the MSN address of the author of the current post. 
    15891657 * 
    1590  * @link http://codex.wordpress.org/Template_Tags/the_author_msn 
    15911658 * @since 0.71 
    15921659 * @deprecated 2.8 
    1593  * @see get_the_author_msn() 
    15941660 * @deprecated Use the_author_meta('msn') 
     1661 * @see the_author_meta() 
    15951662 */ 
    15961663function the_author_msn() { 
    15971664        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'msn\')' ); 
     
    16031670 * 
    16041671 * @since 1.5 
    16051672 * @deprecated 2.8 
    1606  * @uses $authordata The current author's DB object. 
     1673 * @deprecated Use get_the_author_meta('aim') 
     1674 * @see get_the_author_meta() 
     1675 * 
    16071676 * @return string The author's AIM address. 
    1608  * @deprecated Use the_author_meta('aim') 
    16091677 */ 
    16101678function get_the_author_aim() { 
    16111679        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' ); 
     
    16151683/** 
    16161684 * Display the AIM address of the author of the current post. 
    16171685 * 
    1618  * @link http://codex.wordpress.org/Template_Tags/the_author_aim 
    16191686 * @since 0.71 
     1687 * @see the_author_meta() 
    16201688 * @deprecated 2.8 
    1621  * @see get_the_author_aim() 
    16221689 * @deprecated Use the_author_meta('aim') 
    16231690 */ 
    16241691function the_author_aim() { 
     
    16311698 * 
    16321699 * @since 1.0.0 
    16331700 * @deprecated 2.8 
     1701 * @deprecated Use get_the_author_meta('display_name') 
     1702 * @see get_the_author_meta() 
     1703 * 
    16341704 * @param int $auth_id The ID of the author. 
    16351705 * @return string The author's display name. 
    1636  * @deprecated Use the_author_meta('display_name') 
    16371706 */ 
    16381707function get_author_name( $auth_id = false ) { 
    16391708        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' ); 
     
    16451714 * 
    16461715 * @since 1.5 
    16471716 * @deprecated 2.8 
    1648  * @uses $authordata The current author's DB object. 
     1717 * @deprecated Use get_the_author_meta('url') 
     1718 * @see get_the_author_meta() 
     1719 * 
    16491720 * @return string The URL to the author's page. 
    16501721 */ 
    16511722function get_the_author_url() { 
     
    16561727/** 
    16571728 * Display the URL to the home page of the author of the current post. 
    16581729 * 
    1659  * @link http://codex.wordpress.org/Template_Tags/the_author_url 
    16601730 * @since 0.71 
    16611731 * @deprecated 2.8 
     1732 * @deprecated Use the_author_meta('url') 
     1733 * @see the_author_meta() 
    16621734 */ 
    16631735function the_author_url() { 
    16641736        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'url\')' ); 
     
    16701742 * 
    16711743 * @since 1.5 
    16721744 * @deprecated 2.8 
     1745 * @deprecated Use get_the_author_meta('ID') 
     1746 * @see get_the_author_meta() 
     1747 * 
    16731748 * @return int The author's ID. 
    16741749 */ 
    16751750function get_the_author_ID() { 
     
    16801755/** 
    16811756 * Display the ID of the author of the current post. 
    16821757 * 
    1683  * @link http://codex.wordpress.org/Template_Tags/the_author_ID 
    16841758 * @since 0.71 
    16851759 * @deprecated 2.8 
    1686  * @uses get_the_author_ID() 
     1760 * @deprecated Use the_author_meta('ID') 
     1761 * @see the_author_meta() 
    16871762*/ 
    16881763function the_author_ID() { 
    16891764        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'ID\')' ); 
     
    17151790 *              parameters. 
    17161791 * 
    17171792 * @deprecated 2.9.0 
     1793 * @deprecated Use the_content_feed() 
     1794 * @see the_content_feed() 
    17181795 * 
    17191796 * @param string $more_link_text Optional. Text to display when more content is available but not displayed. 
    17201797 * @param int|bool $stripteaser Optional. Default is 0. 
     
    18011878 * 
    18021879 * @since 2.2.0 
    18031880 * @deprecated 2.9.0 
     1881 * @deprecated Use _x() 
     1882 * @see _x() 
    18041883 * 
    18051884 * @param string $text Text to translate 
    18061885 * @param string $domain Optional. Domain to retrieve the translated text