Ticket #11386: function-deprecated_argument-sample-uses.diff

author-template.php

@@ -41 +41 @@
  * @link http://codex.wordpress.org/Template_Tags/the_author
  *
  * @param string $deprecated Deprecated.
- * @param string $deprecated_echo Echo the string or return it.
+ * @param string $deprecated_echo Deprecated. Use get_the_author(). Echo the string or return it.
  * @return string The author's display name, from get_the_author().
  */
 function the_author($deprecated = '', $deprecated_echo = true) {
+        if ( !empty($deprecated) )
+                _deprecated_argument(__FUNCTION__, 'deprecated', '1.5');
+        if ( $deprecated_echo !== true )
+                _deprecated_argument(__FUNCTION__, 'deprecated_echo', '1.5', 'get_the_author');
         if ( $deprecated_echo )
                 echo get_the_author();
         return get_the_author();
@@ -177 +181 @@
  * @param string $deprecated Deprecated.
  */
 function the_author_posts_link($deprecated = '') {
+        if ( !empty( $deprecated ) )
+                _deprecated_argument(__FUNCTION__, 'deprecated', '0.0');
+
         global $authordata;
         $link = sprintf(
                 '<a href="%1$s" title="%2$s">%3$s</a>',

comment-template.php

@@ -503 +503 @@
  *
  * @since 0.71
  *
- * @param string $deprecated Not Used
- * @param bool $deprecated Not Used
+ * @param string $deprecated_1 Not Used
+ * @param bool $deprecated_2 Not Used
  */
-function comments_link( $deprecated = '', $deprecated = '' ) {
+function comments_link( $deprecated_1 = '', $deprecated_2 = '' ) {
+        if ( !empty( $deprecated_1 ) )
+                _deprecated_argument(__FUNCTION__, 'deprecated_1', '0.0');
+        if ( !empty( $deprecated_2 ) )
+                _deprecated_argument(__FUNCTION__, 'deprecated_2', '0.0');
+
         echo get_comments_link();
 }
 

comment.php

@@ -1511 +1511 @@
  * @param int $deprecated Not Used.
  * @return bool|string False on failure, string containing URI on success.
  */
-function discover_pingback_server_uri($url, $deprecated = 2048) {
+function discover_pingback_server_uri($url, $deprecated = '') {
+        if ( !empty($deprecated) )
+                _deprecated_argument(__FUNCTION__, 'deprecated', '0.0');
 
         $pingback_str_dquote = 'rel="pingback"';
         $pingback_str_squote = 'rel=\'pingback\'';

cron.php

@@ -135 +135 @@
 function wp_clear_scheduled_hook( $hook, $args = array() ) {
         // Backward compatibility
         // Previously this function took the arguments as discrete vars rather than an array like the rest of the API
-        if ( !is_array($args) )
+        if ( !is_array($args) ) {
+                _deprecated_argument(__FUNCTION__, 'args', '3.0.0', 'array');
                 $args = array_slice( func_get_args(), 1 );
+        }
 
         while ( $timestamp = wp_next_scheduled( $hook, $args ) )
                 wp_unschedule_event( $timestamp, $hook, $args );

post-template.php

@@ -246 +246 @@
  * @return string
  */
 function get_the_excerpt($deprecated = '') {
+        if ( !empty( $deprecated ) )
+                _deprecated_argument(__FUNCTION__, 'deprecated', '2.3');
+
         global $post;
         $output = $post->post_excerpt;
         if ( post_password_required($post) ) {

widgets.php

@@ -980 +980 @@
  * @since 2.2.0
  * @access private
  *
- * @param bool $update Optional, deprecated.
+ * @param bool $deprecated. Not used.
  * @return array Upgraded list of widgets to version 3 array format when called from the admin.
  */
 function wp_get_sidebars_widgets($deprecated = true) {
+        if ( $deprecated !== true )
+                _deprecated_argument(__FUNCTION__, 'deprecated', '0.0');
+
         global $wp_registered_widgets, $wp_registered_sidebars, $_wp_sidebars_widgets;
 
         // If loading from front page, consult $_wp_sidebars_widgets rather than options