Ticket #7493: 7493-deprecated-docs.2.diff

File 7493-deprecated-docs.2.diff, 41.9 KB (added by nacin, 3 years ago)

Updated patch also removes $deprecated args that don't affect argument order -- see #11386. Also, some whitespace improvements for _deprecated_function() calls.

Line 
1Index: deprecated.php
2===================================================================
3--- deprecated.php      (revision 12364)
4+++ deprecated.php      (working copy)
5@@ -82,6 +82,7 @@
6  * Entire Post data.
7  *
8  * @since 0.71
9+ * @deprecated 1.5.1
10  * @deprecated Use get_post()
11  * @see get_post()
12  *
13@@ -89,7 +90,7 @@
14  * @return array
15  */
16 function get_postdata($postid) {
17-       _deprecated_function(__FUNCTION__, '0.0', 'get_post()');
18+       _deprecated_function( __FUNCTION__, '1.5.1', 'get_post()' );
19 
20        $post = &get_post($postid);
21 
22@@ -118,12 +119,13 @@
23  * Sets up the WordPress Loop.
24  *
25  * @since 1.0.1
26- * @deprecated Since 1.5 - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop}
27+ * @deprecated 1.5
28+ * @deprecated Use The Loop - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop}
29  */
30 function start_wp() {
31        global $wp_query, $post;
32 
33-       _deprecated_function(__FUNCTION__, '1.5', __('new WordPress Loop') );
34+       _deprecated_function( __FUNCTION__, '1.5', __('new WordPress Loop')  );
35 
36        // Since the old style loop is being used, advance the query iterator here.
37        $wp_query->next_post();
38@@ -135,6 +137,7 @@
39  * Return or Print Category ID.
40  *
41  * @since 0.71
42+ * @deprecated 0.71
43  * @deprecated use get_the_category()
44  * @see get_the_category()
45  *
46@@ -142,7 +145,7 @@
47  * @return null|int
48  */
49 function the_category_ID($echo = true) {
50-       _deprecated_function(__FUNCTION__, '0.0', 'get_the_category()');
51+       _deprecated_function( __FUNCTION__, '0.71', 'get_the_category()' );
52 
53        // Grab the first cat in the list.
54        $categories = get_the_category();
55@@ -158,6 +161,7 @@
56  * Print category with optional text before and after.
57  *
58  * @since 0.71
59+ * @deprecated 0.71
60  * @deprecated use get_the_category_by_ID()
61  * @see get_the_category_by_ID()
62  *
63@@ -167,7 +171,7 @@
64 function the_category_head($before='', $after='') {
65        global $currentcat, $previouscat;
66 
67-       _deprecated_function(__FUNCTION__, '0.0', 'get_the_category_by_ID()');
68+       _deprecated_function( __FUNCTION__, '0.71', 'get_the_category_by_ID()' );
69 
70        // Grab the first cat in the list.
71        $categories = get_the_category();
72@@ -184,6 +188,7 @@
73  * Prints link to the previous post.
74  *
75  * @since 1.5
76+ * @deprecated 2.0
77  * @deprecated Use previous_post_link()
78  * @see previous_post_link()
79  *
80@@ -196,7 +201,7 @@
81  */
82 function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') {
83 
84-       _deprecated_function(__FUNCTION__, '0.0', 'previous_post_link()');
85+       _deprecated_function( __FUNCTION__, '2.0', 'previous_post_link()' );
86 
87        if ( empty($in_same_cat) || 'no' == $in_same_cat )
88                $in_same_cat = false;
89@@ -220,6 +225,7 @@
90  * Prints link to the next post.
91  *
92  * @since 0.71
93+ * @deprecated 2.0
94  * @deprecated Use next_post_link()
95  * @see next_post_link()
96  *
97@@ -231,7 +237,7 @@
98  * @param string $excluded_categories
99  */
100 function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') {
101-       _deprecated_function(__FUNCTION__, '0.0', 'next_post_link()');
102+       _deprecated_function( __FUNCTION__, '2.0', 'next_post_link()' );
103 
104        if ( empty($in_same_cat) || 'no' == $in_same_cat )
105                $in_same_cat = false;
106@@ -255,6 +261,7 @@
107  * Whether user can create a post.
108  *
109  * @since 1.5
110+ * @deprecated 2.0
111  * @deprecated Use current_user_can()
112  * @see current_user_can()
113  *
114@@ -264,7 +271,7 @@
115  * @return bool
116  */
117 function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') {
118-       _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
119+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
120 
121        $author_data = get_userdata($user_id);
122        return ($author_data->user_level > 1);
123@@ -274,6 +281,7 @@
124  * Whether user can create a post.
125  *
126  * @since 1.5
127+ * @deprecated 2.0
128  * @deprecated Use current_user_can()
129  * @see current_user_can()
130  *
131@@ -283,7 +291,7 @@
132  * @return bool
133  */
134 function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {
135-       _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
136+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
137 
138        $author_data = get_userdata($user_id);
139        return ($author_data->user_level >= 1);
140@@ -293,6 +301,7 @@
141  * Whether user can edit a post.
142  *
143  * @since 1.5
144+ * @deprecated 2.0
145  * @deprecated Use current_user_can()
146  * @see current_user_can()
147  *
148@@ -302,7 +311,7 @@
149  * @return bool
150  */
151 function user_can_edit_post($user_id, $post_id, $blog_id = 1) {
152-       _deprecated_function(__FUNCTION__, '0', 'current_user_can()');
153+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
154 
155        $author_data = get_userdata($user_id);
156        $post = get_post($post_id);
157@@ -321,6 +330,7 @@
158  * Whether user can delete a post.
159  *
160  * @since 1.5
161+ * @deprecated 2.0
162  * @deprecated Use current_user_can()
163  * @see current_user_can()
164  *
165@@ -330,7 +340,7 @@
166  * @return bool
167  */
168 function user_can_delete_post($user_id, $post_id, $blog_id = 1) {
169-       _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
170+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
171 
172        // right now if one can edit, one can delete
173        return user_can_edit_post($user_id, $post_id, $blog_id);
174@@ -340,6 +350,7 @@
175  * Whether user can set new posts' dates.
176  *
177  * @since 1.5
178+ * @deprecated 2.0
179  * @deprecated Use current_user_can()
180  * @see current_user_can()
181  *
182@@ -349,7 +360,7 @@
183  * @return bool
184  */
185 function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') {
186-       _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
187+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
188 
189        $author_data = get_userdata($user_id);
190        return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id));
191@@ -359,6 +370,7 @@
192  * Whether user can delete a post.
193  *
194  * @since 1.5
195+ * @deprecated 2.0
196  * @deprecated Use current_user_can()
197  * @see current_user_can()
198  *
199@@ -368,7 +380,7 @@
200  * @return bool returns true if $user_id can edit $post_id's date
201  */
202 function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) {
203-       _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
204+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
205 
206        $author_data = get_userdata($user_id);
207        return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id));
208@@ -378,6 +390,7 @@
209  * Whether user can delete a post.
210  *
211  * @since 1.5
212+ * @deprecated 2.0
213  * @deprecated Use current_user_can()
214  * @see current_user_can()
215  *
216@@ -387,7 +400,7 @@
217  * @return bool returns true if $user_id can edit $post_id's comments
218  */
219 function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {
220-       _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
221+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
222 
223        // right now if one can edit a post, one can edit comments made on it
224        return user_can_edit_post($user_id, $post_id, $blog_id);
225@@ -397,6 +410,7 @@
226  * Whether user can delete a post.
227  *
228  * @since 1.5
229+ * @deprecated 2.0
230  * @deprecated Use current_user_can()
231  * @see current_user_can()
232  *
233@@ -406,7 +420,7 @@
234  * @return bool returns true if $user_id can delete $post_id's comments
235  */
236 function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) {
237-       _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
238+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
239 
240        // right now if one can edit comments, one can delete comments
241        return user_can_edit_post_comments($user_id, $post_id, $blog_id);
242@@ -416,6 +430,7 @@
243  * Can user can edit other user.
244  *
245  * @since 1.5
246+ * @deprecated 2.0
247  * @deprecated Use current_user_can()
248  * @see current_user_can()
249  *
250@@ -424,7 +439,7 @@
251  * @return bool
252  */
253 function user_can_edit_user($user_id, $other_user) {
254-       _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
255+       _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
256 
257        $user  = get_userdata($user_id);
258        $other = get_userdata($other_user);
259@@ -438,8 +453,9 @@
260  * Gets the links associated with category $cat_name.
261  *
262  * @since 0.71
263- * @deprecated Use get_links()
264- * @see get_links()
265+ * @deprecated 2.1
266+ * @deprecated Use get_bookmarks()
267+ * @see get_bookmarks()
268  *
269  * @param string $cat_name Optional. The category name to use. If no match is found uses all.
270  * @param string $before Optional. The html to output before the link.
271@@ -457,7 +473,7 @@
272 function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
273                                                 $show_description = true, $show_rating = false,
274                                                 $limit = -1, $show_updated = 0) {
275-       _deprecated_function(__FUNCTION__, '0.0', 'get_links()');
276+       _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
277 
278        $cat_id = -1;
279        $cat = get_term_by('name', $cat_name, 'link_category');
280@@ -471,23 +487,30 @@
281  * Gets the links associated with the named category.
282  *
283  * @since 1.0.1
284- * @deprecated Use wp_get_links()
285- * @see wp_get_links()
286+ * @deprecated 2.1
287+ * @deprecated Use wp_list_bookmarks()
288+ * @see wp_list_bookmarks()
289  *
290  * @param string $category The category to use.
291  * @param string $args
292  * @return bool|null
293  */
294 function wp_get_linksbyname($category, $args = '') {
295-       _deprecated_function(__FUNCTION__, '0.0', 'wp_get_links()');
296+       _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' );
297 
298-       $cat = get_term_by('name', $category, 'link_category');
299-       if ( !$cat )
300-               return false;
301-       $cat_id = $cat->term_id;
302+       $defaults = array(
303+               'after' => '<br />',
304+               'before' => '',
305+               'categorize' => 0,
306+               'category_after' => '',
307+               'category_before' => '',
308+               'category_name' => $category,
309+               'show_description' => 1,
310+               'title_li' => '',
311+       );
312 
313-       $args = add_query_arg('category', $cat_id, $args);
314-       wp_get_links($args);
315+       $r = wp_parse_args( $args, $defaults );
316+       return wp_list_bookmarks( $r );
317 }
318 
319 /**
320@@ -501,8 +524,9 @@
321  * </code>
322  *
323  * @since 1.0.1
324- * @deprecated Use get_linkobjects()
325- * @see get_linkobjects()
326+ * @deprecated 2.1
327+ * @deprecated Use get_bookmarks()
328+ * @see get_bookmarks()
329  *
330  * @param string $cat_name The category name to use. If no match is found uses all.
331  * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.
332@@ -512,7 +536,7 @@
333  * @return unknown
334  */
335 function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
336-       _deprecated_function(__FUNCTION__, '0.0', 'get_linkobjects()');
337+       _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
338 
339        $cat_id = -1;
340        $cat = get_term_by('name', $cat_name, 'link_category');
341@@ -553,6 +577,7 @@
342  * </ol>
343  *
344  * @since 1.0.1
345+ * @deprecated 2.1
346  * @deprecated Use get_bookmarks()
347  * @see get_bookmarks()
348  *
349@@ -565,7 +590,7 @@
350  * @return unknown
351  */
352 function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
353-       _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
354+       _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
355 
356        $links = get_bookmarks("category=$category&orderby=$orderby&limit=$limit");
357 
358@@ -580,6 +605,7 @@
359  * Gets the links associated with category 'cat_name' and display rating stars/chars.
360  *
361  * @since 0.71
362+ * @deprecated 2.1
363  * @deprecated Use get_bookmarks()
364  * @see get_bookmarks()
365  *
366@@ -598,7 +624,7 @@
367  */
368 function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
369                                                                        $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
370-       _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
371+       _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
372 
373        get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
374 }
375@@ -607,6 +633,7 @@
376  * Gets the links associated with category n and display rating stars/chars.
377  *
378  * @since 0.71
379+ * @deprecated 2.1
380  * @deprecated Use get_bookmarks()
381  * @see get_bookmarks()
382  *
383@@ -625,7 +652,7 @@
384  */
385 function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
386                                                          $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
387-       _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
388+       _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
389 
390        get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
391 }
392@@ -640,12 +667,13 @@
393  * @return int Only returns 0.
394  */
395 function get_autotoggle($id = 0) {
396-       _deprecated_function(__FUNCTION__, '0.0' );
397+       _deprecated_function( __FUNCTION__, '2.1'  );
398        return 0;
399 }
400 
401 /**
402  * @since 0.71
403+ * @deprecated 2.1
404  * @deprecated Use wp_list_categories()
405  * @see wp_list_categories()
406  *
407@@ -672,7 +700,7 @@
408 function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,
409                                   $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,
410                                   $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
411-       _deprecated_function(__FUNCTION__, '0.0', 'wp_list_categories()');
412+       _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );
413 
414        $query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children',
415                'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');
416@@ -681,6 +709,7 @@
417 
418 /**
419  * @since 1.2
420+ * @deprecated 2.1
421  * @deprecated Use wp_list_categories()
422  * @see wp_list_categories()
423  *
424@@ -688,7 +717,7 @@
425  * @return unknown
426  */
427 function wp_list_cats($args = '') {
428-       _deprecated_function(__FUNCTION__, '0.0', 'wp_list_categories()');
429+       _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );
430 
431        $r = wp_parse_args( $args );
432 
433@@ -730,7 +759,7 @@
434 function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc',
435                $show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false,
436                $selected = 0, $exclude = 0) {
437-       _deprecated_function(__FUNCTION__, '0.0', 'wp_dropdown_categories()');
438+       _deprecated_function( __FUNCTION__, '2.1', 'wp_dropdown_categories()' );
439 
440        $show_option_all = '';
441        if ( $optionall )
442@@ -748,17 +777,19 @@
443 
444 /**
445  * @since 2.1
446+ * @deprecated 2.1
447  * @deprecated Use wp_tiny_mce().
448  * @see wp_tiny_mce()
449  */
450 function tinymce_include() {
451-       _deprecated_function(__FUNCTION__, '0.0', 'wp_tiny_mce()');
452+       _deprecated_function( __FUNCTION__, '2.1', 'wp_tiny_mce()' );
453 
454        wp_tiny_mce();
455 }
456 
457 /**
458  * @since 1.2
459+ * @deprecated 2.1
460  * @deprecated Use wp_list_authors()
461  * @see wp_list_authors()
462  *
463@@ -771,7 +802,7 @@
464  * @return unknown
465  */
466 function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') {
467-       _deprecated_function(__FUNCTION__, '0.0', 'wp_list_authors()');
468+       _deprecated_function( __FUNCTION__, '2.1', 'wp_list_authors()' );
469 
470        $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image');
471        return wp_list_authors($args);
472@@ -779,6 +810,7 @@
473 
474 /**
475  * @since 1.0.1
476+ * @deprecated 2.1
477  * @deprecated Use wp_get_post_categories()
478  * @see wp_get_post_categories()
479  *
480@@ -787,7 +819,7 @@
481  * @return unknown
482  */
483 function wp_get_post_cats($blogid = '1', $post_ID = 0) {
484-       _deprecated_function(__FUNCTION__, '0.0', 'wp_get_post_categories()');
485+       _deprecated_function( __FUNCTION__, '2.1', 'wp_get_post_categories()' );
486        return wp_get_post_categories($post_ID);
487 }
488 
489@@ -795,6 +827,7 @@
490  * Sets the categories that the post id belongs to.
491  *
492  * @since 1.0.1
493+ * @deprecated 2.1
494  * @deprecated Use wp_set_post_categories()
495  * @see wp_set_post_categories()
496  *
497@@ -804,12 +837,13 @@
498  * @return unknown
499  */
500 function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) {
501-       _deprecated_function(__FUNCTION__, '0.0', 'wp_set_post_categories()');
502+       _deprecated_function( __FUNCTION__, '2.1', 'wp_set_post_categories()' );
503        return wp_set_post_categories($post_ID, $post_categories);
504 }
505 
506 /**
507  * @since 0.71
508+ * @deprecated 2.1
509  * @deprecated Use wp_get_archives()
510  * @see wp_get_archives()
511  *
512@@ -822,7 +856,7 @@
513  * @return unknown
514  */
515 function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) {
516-       _deprecated_function(__FUNCTION__, '0.0', 'wp_get_archives()');
517+       _deprecated_function( __FUNCTION__, '2.1', 'wp_get_archives()' );
518        $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count');
519        return wp_get_archives($args);
520 }
521@@ -831,6 +865,7 @@
522  * Returns or Prints link to the author's posts.
523  *
524  * @since 1.2
525+ * @deprecated 2.1
526  * @deprecated Use get_author_posts_url()
527  * @see get_author_posts_url()
528  *
529@@ -840,7 +875,7 @@
530  * @return string|null
531  */
532 function get_author_link($echo = false, $author_id, $author_nicename = '') {
533-       _deprecated_function(__FUNCTION__, '0.0', 'get_author_posts_url()');
534+       _deprecated_function( __FUNCTION__, '2.1', 'get_author_posts_url()' );
535 
536        $link = get_author_posts_url($author_id, $author_nicename);
537 
538@@ -853,6 +888,7 @@
539  * Print list of pages based on arguments.
540  *
541  * @since 0.71
542+ * @deprecated 2.1
543  * @deprecated Use wp_link_pages()
544  * @see wp_link_pages()
545  *
546@@ -867,7 +903,7 @@
547  */
548 function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',
549                                        $pagelink='%', $more_file='') {
550-       _deprecated_function(__FUNCTION__, '0.0', 'wp_link_pages()');
551+       _deprecated_function( __FUNCTION__, '2.1', 'wp_link_pages()' );
552 
553        $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file');
554        return wp_link_pages($args);
555@@ -877,6 +913,7 @@
556  * Get value based on option.
557  *
558  * @since 0.71
559+ * @deprecated 2.1
560  * @deprecated Use get_option()
561  * @see get_option()
562  *
563@@ -884,7 +921,7 @@
564  * @return string
565  */
566 function get_settings($option) {
567-       _deprecated_function(__FUNCTION__, '0.0', 'get_option()');
568+       _deprecated_function( __FUNCTION__, '2.1', 'get_option()' );
569 
570        return get_option($option);
571 }
572@@ -893,11 +930,12 @@
573  * Print the permalink of the current post in the loop.
574  *
575  * @since 0.71
576+ * @deprecated 1.2
577  * @deprecated Use the_permalink()
578  * @see the_permalink()
579  */
580 function permalink_link() {
581-       _deprecated_function(__FUNCTION__, '0.0', 'the_permalink()');
582+       _deprecated_function( __FUNCTION__, '1.2', 'the_permalink()' );
583        the_permalink();
584 }
585 
586@@ -905,29 +943,30 @@
587  * Print the permalink to the RSS feed.
588  *
589  * @since 0.71
590+ * @deprecated 2.3
591  * @deprecated Use the_permalink_rss()
592  * @see the_permalink_rss()
593  *
594  * @param string $file
595  */
596-function permalink_single_rss($deprecated = '') {
597-       _deprecated_function(__FUNCTION__, '0.0', 'the_permalink_rss()');
598+function permalink_single_rss() {
599+       _deprecated_function( __FUNCTION__, '2.3', 'the_permalink_rss()' );
600        the_permalink_rss();
601 }
602 
603 /**
604  * Gets the links associated with category.
605  *
606- * @see get_links() for argument information that can be used in $args
607  * @since 1.0.1
608- * @deprecated Use get_bookmarks()
609- * @see get_bookmarks()
610+ * @deprecated 2.1
611+ * @deprecated Use wp_list_bookmarks()
612+ * @see wp_list_bookmarks()
613  *
614  * @param string $args a query string
615  * @return null|string
616  */
617 function wp_get_links($args = '') {
618-       _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
619+       _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' );
620 
621        if ( strpos( $args, '=' ) === false ) {
622                $cat_id = $args;
623@@ -935,24 +974,31 @@
624        }
625 
626        $defaults = array(
627-               'category' => -1, 'before' => '',
628-               'after' => '<br />', 'between' => ' ',
629-               'show_images' => true, 'orderby' => 'name',
630-               'show_description' => true, 'show_rating' => false,
631-               'limit' => -1, 'show_updated' => true,
632-               'echo' => true
633+               'after' => '<br />',
634+               'before' => '',
635+               'between' => ' ',
636+               'categorize' => 0,
637+               'category' => '',
638+               'echo' => true,
639+               'limit' => -1,
640+               'orderby' => 'name',
641+               'show_description' => true,
642+               'show_images' => true,
643+               'show_rating' => false,
644+               'show_updated' => true,
645+               'title_li' => '',
646        );
647 
648        $r = wp_parse_args( $args, $defaults );
649-       extract( $r, EXTR_SKIP );
650 
651-       return get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated, $echo);
652+       return wp_list_bookmarks( $r );
653 }
654 
655 /**
656  * Gets the links associated with category by id.
657  *
658  * @since 0.71
659+ * @deprecated 2.1
660  * @deprecated Use get_bookmarks()
661  * @see get_bookmarks()
662  *
663@@ -975,7 +1021,7 @@
664  */
665 function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
666                        $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {
667-       _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
668+       _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
669 
670        $order = 'ASC';
671        if ( substr($orderby, 0, 1) == '_' ) {
672@@ -1062,14 +1108,14 @@
673  *
674  * @author Dougal
675  * @since 1.0.1
676+ * @deprecated 2.1
677  * @deprecated Use wp_list_bookmarks()
678  * @see wp_list_bookmarks()
679  *
680  * @param string $order Sort link categories by 'name' or 'id'
681- * @param string $$deprecated Not Used
682  */
683-function get_links_list($order = 'name', $deprecated = '') {
684-       _deprecated_function(__FUNCTION__, '0.0', 'wp_list_bookmarks()');
685+function get_links_list($order = 'name') {
686+       _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' );
687 
688        $order = strtolower($order);
689 
690@@ -1108,6 +1154,7 @@
691  * @link http://sprite.csr.unibo.it/fullo/
692  *
693  * @since 0.71
694+ * @deprecated 2.1
695  * @deprecated {@internal Use function instead is unknown}}
696  *
697  * @param string $text the text of the link
698@@ -1117,7 +1164,7 @@
699  * @param bool $count the number of links in the db
700  */
701 function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) {
702-       _deprecated_function(__FUNCTION__, '0.0' );
703+       _deprecated_function( __FUNCTION__, '2.1'  );
704 
705        if ( $count )
706                $counts = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->links");
707@@ -1134,6 +1181,7 @@
708 
709 /**
710  * @since 1.0.1
711+ * @deprecated 2.1
712  * @deprecated Use sanitize_bookmark_field()
713  * @see sanitize_bookmark_field()
714  *
715@@ -1141,7 +1189,7 @@
716  * @return unknown
717  */
718 function get_linkrating($link) {
719-       _deprecated_function(__FUNCTION__, '0.0', 'sanitize_bookmark_field()');
720+       _deprecated_function( __FUNCTION__, '2.1', 'sanitize_bookmark_field()' );
721        return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');
722 }
723 
724@@ -1149,6 +1197,7 @@
725  * Gets the name of category by id.
726  *
727  * @since 0.71
728+ * @deprecated 2.1
729  * @deprecated Use get_category()
730  * @see get_category()
731  *
732@@ -1156,7 +1205,7 @@
733  * @return string
734  */
735 function get_linkcatname($id = 0) {
736-       _deprecated_function(__FUNCTION__, '0.0', 'get_category()');
737+       _deprecated_function( __FUNCTION__, '2.1', 'get_category()' );
738 
739        $id = (int) $id;
740 
741@@ -1178,14 +1227,14 @@
742  * Print RSS comment feed link.
743  *
744  * @since 1.0.1
745+ * @deprecated 2.5
746  * @deprecated Use post_comments_feed_link()
747  * @see post_comments_feed_link()
748  *
749  * @param string $link_text
750- * @param string $deprecated Not used
751  */
752-function comments_rss_link($link_text = 'Comments RSS', $deprecated = '') {
753-       _deprecated_function(__FUNCTION__, '0.0', 'post_comments_feed_link()');
754+function comments_rss_link($link_text = 'Comments RSS') {
755+       _deprecated_function( __FUNCTION__, '2.5', 'post_comments_feed_link()' );
756        post_comments_feed_link($link_text);
757 }
758 
759@@ -1193,16 +1242,16 @@
760  * Print/Return link to category RSS2 feed.
761  *
762  * @since 1.2
763+ * @deprecated 2.5
764  * @deprecated Use get_category_feed_link()
765  * @see get_category_feed_link()
766  *
767  * @param bool $echo
768  * @param int $cat_ID
769- * @param string $deprecated Not used
770  * @return string|null
771  */
772-function get_category_rss_link($echo = false, $cat_ID = 1, $deprecated = '') {
773-       _deprecated_function(__FUNCTION__, '0.0', 'get_category_feed_link()');
774+function get_category_rss_link($echo = false, $cat_ID = 1) {
775+       _deprecated_function( __FUNCTION__, '2.5', 'get_category_feed_link()' );
776 
777        $link = get_category_feed_link($cat_ID, 'rss2');
778 
779@@ -1215,16 +1264,16 @@
780  * Print/Return link to author RSS feed.
781  *
782  * @since 1.2
783+ * @deprecated 2.5
784  * @deprecated Use get_author_feed_link()
785  * @see get_author_feed_link()
786  *
787  * @param bool $echo
788  * @param int $author_id
789- * @param string $deprecated Not used
790  * @return string|null
791  */
792-function get_author_rss_link($echo = false, $author_id = 1, $deprecated = '') {
793-       _deprecated_function(__FUNCTION__, '0.0', 'get_author_feed_link()');
794+function get_author_rss_link($echo = false, $author_id = 1) {
795+       _deprecated_function( __FUNCTION__, '2.5', 'get_author_feed_link()' );
796 
797        $link = get_author_feed_link($author_id);
798        if ( $echo )
799@@ -1236,26 +1285,29 @@
800  * Return link to the post RSS feed.
801  *
802  * @since 1.5
803+ * @deprecated 2.2
804  * @deprecated Use get_post_comments_feed_link()
805  * @see get_post_comments_feed_link()
806  *
807- * @param string $deprecated Not used
808  * @return string
809  */
810-function comments_rss($deprecated = '') {
811-       _deprecated_function(__FUNCTION__, '2.2', 'get_post_comments_feed_link()');
812+function comments_rss() {
813+       _deprecated_function( __FUNCTION__, '2.2', 'get_post_comments_feed_link()' );
814        return get_post_comments_feed_link();
815 }
816 
817 /**
818  * An alias of wp_create_user().
819  *
820+ * @since 2.0
821+ * @deprecated 2.0
822+ * @deprecated Use wp_create_user()
823+ * @see wp_create_user()
824+ *
825  * @param string $username The user's username.
826  * @param string $password The user's password.
827  * @param string $email The user's email (optional).
828  * @return int The new user's ID.
829- * @deprecated Use wp_create_user()
830- * @see wp_create_user()
831  */
832 function create_user($username, $password, $email) {
833        _deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' );
834@@ -1266,10 +1318,10 @@
835  * Unused Admin function.
836  *
837  * @since 2.0
838- * @param string $deprecated Unknown
839  * @deprecated 2.5
840+ *
841  */
842-function documentation_link( $deprecated = '' ) {
843+function documentation_link() {
844        _deprecated_function( __FUNCTION__, '2.5', '' );
845        return;
846 }
847@@ -1280,19 +1332,18 @@
848  * @deprecated 2.5
849 */
850 function gzip_compression() {
851+       _deprecated_function( __FUNCTION__, '2.5', '' );
852        return false;
853 }
854 
855 /**
856  * Retrieve an array of comment data about comment $comment_ID.
857  *
858+ * @since 0.71
859+ * @deprecated 2.7
860  * @deprecated Use get_comment()
861  * @see get_comment()
862- * @since 0.71
863  *
864- * @uses $id
865- * @uses $wpdb Database Object
866- *
867  * @param int $comment_ID The ID of the comment
868  * @param int $no_cache Whether to use the cache or not (casted to bool)
869  * @param bool $include_unapproved Whether to include unapproved comments or not
870@@ -1307,14 +1358,15 @@
871  * Retrieve the category name by the category ID.
872  *
873  * @since 0.71
874+ * @deprecated 2.8
875  * @deprecated Use get_cat_name()
876- * @see get_cat_name() get_catname() is deprecated in favor of get_cat_name().
877+ * @see get_cat_name()
878  *
879  * @param int $cat_ID Category ID
880  * @return string category name
881  */
882 function get_catname( $cat_ID ) {
883-       _deprecated_function(__FUNCTION__, '2.8', 'get_cat_name()');
884+       _deprecated_function( __FUNCTION__, '2.8', 'get_cat_name()' );
885        return get_cat_name( $cat_ID );
886 }
887 
888@@ -1322,6 +1374,9 @@
889  * Retrieve category children list separated before and after the term IDs.
890  *
891  * @since 1.2.0
892+ * @deprecated 2.8
893+ * @deprecated Use get_term_children()
894+ * @see get_term_children()
895  *
896  * @param int $id Category ID to retrieve children.
897  * @param string $before Optional. Prepend before category term ID.
898@@ -1330,7 +1385,7 @@
899  * @return string
900  */
901 function get_category_children( $id, $before = '/', $after = '', $visited = array() ) {
902-       _deprecated_function(__FUNCTION__, '2.8', 'get_term_children()');
903+       _deprecated_function( __FUNCTION__, '2.8', 'get_term_children()' );
904        if ( 0 == $id )
905                return '';
906 
907@@ -1358,25 +1413,26 @@
908  *
909  * @since 1.5
910  * @deprecated 2.8
911- * @uses $authordata The current author's DB object.
912+ * @deprecated Use the_author_meta('description')
913+ * @see get_the_author_meta()
914+ *
915  * @return string The author's description.
916- * @deprecated Use the_author_meta('description')
917  */
918 function get_the_author_description() {
919-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' );
920+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'description\')'  );
921        return get_the_author_meta('description');
922 }
923 
924 /**
925  * Display the description of the author of the current post.
926  *
927- * @link http://codex.wordpress.org/Template_Tags/the_author_description
928  * @since 1.0.0
929  * @deprecated 2.8
930  * @deprecated Use the_author_meta('description')
931+ * @see the_author_meta()
932  */
933 function the_author_description() {
934-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'description\')' );
935+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'description\')'  );
936        the_author_meta('description');
937 }
938 
939@@ -1385,25 +1441,26 @@
940  *
941  * @since 1.5
942  * @deprecated 2.8
943- * @uses $authordata The current author's DB object.
944+ * @deprecated Use the_author_meta('login')
945+ * @see get_the_author_meta()
946+ *
947  * @return string The author's login name (username).
948- * @deprecated Use the_author_meta('login')
949  */
950 function get_the_author_login() {
951-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' );
952+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'login\')'  );
953        return get_the_author_meta('login');
954 }
955 
956 /**
957  * Display the login name of the author of the current post.
958  *
959- * @link http://codex.wordpress.org/Template_Tags/the_author_login
960  * @since 0.71
961  * @deprecated 2.8
962  * @deprecated Use the_author_meta('login')
963+ * @see the_author_meta()
964  */
965 function the_author_login() {
966-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'login\')' );
967+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'login\')'  );
968        the_author_meta('login');
969 }
970 
971@@ -1412,25 +1469,26 @@
972  *
973  * @since 1.5
974  * @deprecated 2.8
975- * @uses $authordata The current author's DB object.
976+ * @deprecated Use the_author_meta('first_name')
977+ * @see get_the_author_meta()
978+ *
979  * @return string The author's first name.
980- * @deprecated Use the_author_meta('first_name')
981  */
982 function get_the_author_firstname() {
983-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' );
984+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')'  );
985        return get_the_author_meta('first_name');
986 }
987 
988 /**
989  * Display the first name of the author of the current post.
990  *
991- * @link http://codex.wordpress.org/Template_Tags/the_author_firstname
992  * @since 0.71
993  * @deprecated 2.8
994  * @deprecated Use the_author_meta('first_name')
995+ * @see the_author_meta()
996  */
997 function the_author_firstname() {
998-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' );
999+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'first_name\')'  );
1000        the_author_meta('first_name');
1001 }
1002 
1003@@ -1439,25 +1497,26 @@
1004  *
1005  * @since 1.5
1006  * @deprecated 2.8
1007- * @uses $authordata The current author's DB object.
1008+ * @deprecated Use get_the_author_meta('last_name')
1009+ * @see get_the_author_meta()
1010+ *
1011  * @return string The author's last name.
1012- * @deprecated Use the_author_meta('last_name')
1013  */
1014 function get_the_author_lastname() {
1015-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' );
1016+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')'  );
1017        return get_the_author_meta('last_name');
1018 }
1019 
1020 /**
1021  * Display the last name of the author of the current post.
1022  *
1023- * @link http://codex.wordpress.org/Template_Tags/the_author_lastname
1024  * @since 0.71
1025  * @deprecated 2.8
1026  * @deprecated Use the_author_meta('last_name')
1027+ * @see the_author_meta()
1028  */
1029 function the_author_lastname() {
1030-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' );
1031+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'last_name\')'  );
1032        the_author_meta('last_name');
1033 }
1034 
1035@@ -1466,25 +1525,26 @@
1036  *
1037  * @since 1.5
1038  * @deprecated 2.8
1039- * @uses $authordata The current author's DB object.
1040+ * @deprecated Use get_the_author_meta('nickname')
1041+ * @see get_the_author_meta()
1042+ *
1043  * @return string The author's nickname.
1044- * @deprecated Use the_author_meta('nickname')
1045  */
1046 function get_the_author_nickname() {
1047-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' );
1048+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')'  );
1049        return get_the_author_meta('nickname');
1050 }
1051 
1052 /**
1053  * Display the nickname of the author of the current post.
1054  *
1055- * @link http://codex.wordpress.org/Template_Tags/the_author_nickname
1056  * @since 0.71
1057  * @deprecated 2.8
1058  * @deprecated Use the_author_meta('nickname')
1059+ * @see the_author_meta()
1060  */
1061 function the_author_nickname() {
1062-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' );
1063+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'nickname\')'  );
1064        the_author_meta('nickname');
1065 }
1066 
1067@@ -1493,25 +1553,26 @@
1068  *
1069  * @since 1.5
1070  * @deprecated 2.8
1071- * @uses $authordata The current author's DB object.
1072+ * @deprecated Use get_the_author_meta('email')
1073+ * @see get_the_author_meta()
1074+ *
1075  * @return string The author's username.
1076- * @deprecated Use the_author_meta('email')
1077  */
1078 function get_the_author_email() {
1079-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' );
1080+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'email\')'  );
1081        return get_the_author_meta('email');
1082 }
1083 
1084 /**
1085  * Display the email of the author of the current post.
1086  *
1087- * @link http://codex.wordpress.org/Template_Tags/the_author_email
1088  * @since 0.71
1089  * @deprecated 2.8
1090  * @deprecated Use the_author_meta('email')
1091+ * @see the_author_meta()
1092  */
1093 function the_author_email() {
1094-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'email\')' );
1095+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'email\')'  );
1096        the_author_meta('email');
1097 }
1098 
1099@@ -1520,26 +1581,26 @@
1100  *
1101  * @since 1.5
1102  * @deprecated 2.8
1103- * @uses $authordata The current author's DB object.
1104+ * @deprecated Use get_the_author_meta('icq')
1105+ * @see get_the_author_meta()
1106+ *
1107  * @return string The author's ICQ number.
1108- * @deprecated Use the_author_meta('icq')
1109  */
1110 function get_the_author_icq() {
1111-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' );
1112+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')'  );
1113        return get_the_author_meta('icq');
1114 }
1115 
1116 /**
1117  * Display the ICQ number of the author of the current post.
1118  *
1119- * @link http://codex.wordpress.org/Template_Tags/the_author_icq
1120  * @since 0.71
1121  * @deprecated 2.8
1122- * @see get_the_author_icq()
1123  * @deprecated Use the_author_meta('icq')
1124+ * @see the_author_meta()
1125  */
1126 function the_author_icq() {
1127-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'icq\')' );
1128+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'icq\')'  );
1129        the_author_meta('icq');
1130 }
1131 
1132@@ -1548,25 +1609,26 @@
1133  *
1134  * @since 1.5
1135  * @deprecated 2.8
1136- * @uses $authordata The current author's DB object.
1137+ * @deprecated Use get_the_author_meta('yim')
1138+ * @see get_the_author_meta()
1139+ *
1140  * @return string The author's Yahoo! IM name.
1141- * @deprecated Use the_author_meta('yim')
1142  */
1143 function get_the_author_yim() {
1144-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' );
1145+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')'  );
1146        return get_the_author_meta('yim');
1147 }
1148 
1149 /**
1150  * Display the Yahoo! IM name of the author of the current post.
1151  *
1152- * @link http://codex.wordpress.org/Template_Tags/the_author_yim
1153  * @since 0.71
1154  * @deprecated 2.8
1155  * @deprecated Use the_author_meta('yim')
1156+ * @see the_author_meta()
1157  */
1158 function the_author_yim() {
1159-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'yim\')' );
1160+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'yim\')'  );
1161        the_author_meta('yim');
1162 }
1163 
1164@@ -1575,26 +1637,26 @@
1165  *
1166  * @since 1.5
1167  * @deprecated 2.8
1168- * @uses $authordata The current author's DB object.
1169+ * @deprecated Use get_the_author_meta('msn')
1170+ * @see get_the_author_meta()
1171+ *
1172  * @return string The author's MSN address.
1173- * @deprecated Use the_author_meta('msn')
1174  */
1175 function get_the_author_msn() {
1176-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' );
1177+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')'  );
1178        return get_the_author_meta('msn');
1179 }
1180 
1181 /**
1182  * Display the MSN address of the author of the current post.
1183  *
1184- * @link http://codex.wordpress.org/Template_Tags/the_author_msn
1185  * @since 0.71
1186  * @deprecated 2.8
1187- * @see get_the_author_msn()
1188  * @deprecated Use the_author_meta('msn')
1189+ * @see the_author_meta()
1190  */
1191 function the_author_msn() {
1192-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'msn\')' );
1193+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'msn\')'  );
1194        the_author_meta('msn');
1195 }
1196 
1197@@ -1603,26 +1665,26 @@
1198  *
1199  * @since 1.5
1200  * @deprecated 2.8
1201- * @uses $authordata The current author's DB object.
1202+ * @deprecated Use get_the_author_meta('aim')
1203+ * @see get_the_author_meta()
1204+ *
1205  * @return string The author's AIM address.
1206- * @deprecated Use the_author_meta('aim')
1207  */
1208 function get_the_author_aim() {
1209-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' );
1210+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')'  );
1211        return get_the_author_meta('aim');
1212 }
1213 
1214 /**
1215  * Display the AIM address of the author of the current post.
1216  *
1217- * @link http://codex.wordpress.org/Template_Tags/the_author_aim
1218  * @since 0.71
1219+ * @see the_author_meta()
1220  * @deprecated 2.8
1221- * @see get_the_author_aim()
1222  * @deprecated Use the_author_meta('aim')
1223  */
1224 function the_author_aim() {
1225-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'aim\')' );
1226+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'aim\')'  );
1227        the_author_meta('aim');
1228 }
1229 
1230@@ -1631,12 +1693,14 @@
1231  *
1232  * @since 1.0.0
1233  * @deprecated 2.8
1234+ * @deprecated Use get_the_author_meta('display_name')
1235+ * @see get_the_author_meta()
1236+ *
1237  * @param int $auth_id The ID of the author.
1238  * @return string The author's display name.
1239- * @deprecated Use the_author_meta('display_name')
1240  */
1241 function get_author_name( $auth_id = false ) {
1242-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' );
1243+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')'  );
1244        return get_the_author_meta('display_name', $auth_id);
1245 }
1246 
1247@@ -1645,23 +1709,26 @@
1248  *
1249  * @since 1.5
1250  * @deprecated 2.8
1251- * @uses $authordata The current author's DB object.
1252+ * @deprecated Use get_the_author_meta('url')
1253+ * @see get_the_author_meta()
1254+ *
1255  * @return string The URL to the author's page.
1256  */
1257 function get_the_author_url() {
1258-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'url\')' );
1259+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'url\')'  );
1260        return get_the_author_meta('url');
1261 }
1262 
1263 /**
1264  * Display the URL to the home page of the author of the current post.
1265  *
1266- * @link http://codex.wordpress.org/Template_Tags/the_author_url
1267  * @since 0.71
1268  * @deprecated 2.8
1269+ * @deprecated Use the_author_meta('url')
1270+ * @see the_author_meta()
1271  */
1272 function the_author_url() {
1273-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'url\')' );
1274+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'url\')'  );
1275        the_author_meta('url');
1276 }
1277 
1278@@ -1670,23 +1737,26 @@
1279  *
1280  * @since 1.5
1281  * @deprecated 2.8
1282+ * @deprecated Use get_the_author_meta('ID')
1283+ * @see get_the_author_meta()
1284+ *
1285  * @return int The author's ID.
1286  */
1287 function get_the_author_ID() {
1288-       _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')' );
1289+       _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')'  );
1290        return get_the_author_meta('ID');
1291 }
1292 
1293 /**
1294  * Display the ID of the author of the current post.
1295  *
1296- * @link http://codex.wordpress.org/Template_Tags/the_author_ID
1297  * @since 0.71
1298  * @deprecated 2.8
1299- * @uses get_the_author_ID()
1300+ * @deprecated Use the_author_meta('ID')
1301+ * @see the_author_meta()
1302 */
1303 function the_author_ID() {
1304-       _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'ID\')' );
1305+       _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')'  );
1306        the_author_meta('ID');
1307 }
1308 
1309@@ -1715,6 +1785,8 @@
1310  *             parameters.
1311  *
1312  * @deprecated 2.9.0
1313+ * @deprecated Use the_content_feed()
1314+ * @see the_content_feed()
1315  *
1316  * @param string $more_link_text Optional. Text to display when more content is available but not displayed.
1317  * @param int|bool $stripteaser Optional. Default is 0.
1318@@ -1723,7 +1795,7 @@
1319  * @param int $encode_html Optional. How to encode the content.
1320  */
1321 function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
1322-       _deprecated_function(__FUNCTION__, '2.9', 'the_content_feed' );
1323+       _deprecated_function( __FUNCTION__, '2.9', 'the_content_feed'  );
1324        $content = get_the_content($more_link_text, $stripteaser, $more_file);
1325        $content = apply_filters('the_content_rss', $content);
1326        if ( $cut && !$encode_html )
1327@@ -1769,7 +1841,7 @@
1328  * @return string HTML stripped out of content with links at the bottom.
1329  */
1330 function make_url_footnote( $content ) {
1331-       _deprecated_function(__FUNCTION__, '2.9', '' );
1332+       _deprecated_function( __FUNCTION__, '2.9', ''  );
1333        preg_match_all( '/<a(.+?)href=\"(.+?)\"(.*?)>(.+?)<\/a>/', $content, $matches );
1334        $links_summary = "\n";
1335        for ( $i=0; $i<count($matches[0]); $i++ ) {
1336@@ -1801,13 +1873,15 @@
1337  *
1338  * @since 2.2.0
1339  * @deprecated 2.9.0
1340+ * @deprecated Use _x()
1341+ * @see _x()
1342  *
1343  * @param string $text Text to translate
1344  * @param string $domain Optional. Domain to retrieve the translated text
1345  * @return string Translated context string without pipe
1346  */
1347 function _c( $text, $domain = 'default' ) {
1348-       _deprecated_function(__FUNCTION__, '2.9', '_x' );
1349+       _deprecated_function( __FUNCTION__, '2.9', '_x'  );
1350        return translate_with_context( $text, $domain );
1351 }
1352 ?>
1353\ No newline at end of file