[wp-trac] [WordPress Trac] #11388: Deprecated functions: Formally deprecate and/or move to deprecated.php

[WordPress Trac]

#11388: Deprecated functions: Formally deprecate and/or move to deprecated.php
--------------------------+-------------------------------------------------
 Reporter:  nacin         |       Owner:              
     Type:  defect (bug)  |      Status:  new         
 Priority:  low           |   Milestone:  3.0         
Component:  Inline Docs   |     Version:              
 Severity:  normal        |    Keywords:  dev-feedback
--------------------------+-------------------------------------------------
 A few functions that should be moved to deprecated.php, found when going
 through deprecated code and phpdoc in #7493 and #11386. Many are missing
 the _deprecated_function() call but are marked as deprecated in phpdoc.
 Some have the call and just need to be moved.

 Move to deprecated.php and improve phpdoc, unless there is a reason to
 keep these in 110n.php --
 {{{
 __ngettext()
 __ngettext_noop()
 }}}

 Move to deprecated.php, improve phpdoc, and add _deprecated_function()
 call --
 {{{
 get_the_attachment_link()
 get_attachment_icon_src()
 get_attachment_icon()
 get_attachment_innerHTML()
 get_link()
 dropdown_categories()
 dropdown_link_categories()
 }}}

 Additionally, dev-feedback is necessary for two situations:

  1. To consider the pre-2.8 escape functions in formatting.php as
 candidates for formal deprecation.

  2. To consider a new pluggable-deprecated.php (or deprecated-
 pluggable.php) file to hold pluggable functions that have since been
 deprecated, to discourage their use and lower their profile. They are
 wp_setcookie(), wp_clearcookie(), wp_get_cookie_login(), and wp_login().
 Or, at the very least, wp_login() needs a _deprecated_function() call
 added.

 Waiting to formally patch, pending traction and feedback on all of this.

-- 
Ticket URL: <http://core.trac.wordpress.org/ticket/11388>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software