Changeset 19935 for trunk/wp-includes/deprecated.php

Timestamp:

02/17/2012 12:02:42 AM (13 years ago)

Author:

nacin

Message:

Deprecate ancient "debugging" tools.

• logIO() and the global $xmlrpc_logging in XML-RPC.
• log_app() and the global $app_logging in APP.
• debug_fwrite(), debug_fopen(), debug_fclose(), and $debug.

see #20051.

File:

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

trunk/wp-includes/deprecated.php

@@ -2565 +2565 @@
  *
  * @since 1.5.0
- * @deprecated 3.1
+ * @deprecated 3.1.0
  * @deprecated Use global $plugin_page and/or get_plugin_page_hookname() hooks.
  *
@@ -2591 +2591 @@
  *
  * @since 1.5.0
- * @deprecated 3.1
+ * @deprecated 3.1.0
  *
  * @return bool Always return True
@@ -2605 +2605 @@
  *
  * @since 2.9.0
- * @deprecated 3.2
+ * @deprecated 3.2.0
  *
  * @return bool
@@ -2619 +2619 @@
  *
  * @since 2.1.0
- * @deprecated 3.3
+ * @deprecated 3.3.0
+ * @deprecated Use wp_editor()
+ * @see wp_editor()
  *
  * @param string $content Textarea content.
@@ -2628 +2630 @@
  */
 function the_editor($content, $id = 'content', $prev_id = 'title', $media_buttons = true, $tab_index = 2, $extended = true) {
+    _deprecated_function( __FUNCTION__, '3.3', 'wp_editor()' );
 
     wp_editor( $content, $id, array( 'media_buttons' => $media_buttons ) );
@@ -2637 +2640 @@
  *
  * @since 3.0.0
+ * @deprecated 3.3.0
+ *
  * @param array $ids User ID numbers list.
  * @return array of arrays. The array is indexed by user_id, containing $metavalues object arrays.
@@ -2669 +2674 @@
  * @since 2.3.0
  * @deprecated 3.3.0
- * @uses sanitize_user_field() Used to sanitize the fields.
  *
  * @param object|array $user The User Object or Array
@@ -2706 +2710 @@
  *
  * @since 2.8.0
- * @deprecated 3.3
+ * @deprecated 3.3.0
  *
  * @param string $title Optional. Link title format.
@@ -2746 +2750 @@
  *
  * @since 2.8.0
- * @deprecated 3.3
+ * @deprecated 3.3.0
  *
  * @param string $title Optional. Link title format.
@@ -2762 +2766 @@
  *
  * @since 2.8.0
- * @deprecated 3.3
+ * @deprecated 3.3.0
  *
  * @return string
@@ -2777 +2781 @@
  *
  * @since 2.8.0
- * @deprecated 3.3
+ * @deprecated 3.3.0
  */
 function index_rel_link() {
@@ -2789 +2793 @@
  *
  * @since 2.8.0
- * @deprecated 3.3
+ * @deprecated 3.3.0
  *
  * @param string $title Optional. Link title format.
@@ -2820 +2824 @@
  *
  * @since 2.8.0
- * @deprecated 3.3
+ * @deprecated 3.3.0
  */
 function parent_post_rel_link($title = '%title') {
@@ -2832 +2836 @@
  *
  * @since 3.2.0
- * @deprecated 3.3
+ * @deprecated 3.3.0
  */
 function wp_admin_bar_dashboard_view_site_menu( $wp_admin_bar ) {
@@ -2853 +2857 @@
  *
  * @since MU
- * @deprecated 3.3
+ * @deprecated 3.3.0
  * @deprecated Use is_user_member_of_blog()
  * @see is_user_member_of_blog()
@@ -2865 +2869 @@
     return is_user_member_of_blog( get_current_user_id(), $blog_id );
 }
+
+/**
+ * Open the file handle for debugging. 
+ *
+ * @since 0.71
+ * @deprecated Use error_log()
+ * @link http://www.php.net/manual/en/function.error-log.php
+ * @deprecated 3.4.0
+ */
+function debug_fopen( $filename, $mode ) {
+    _deprecated_function( __FUNCTION__, 'error_log()' );
+    return false;
+}
+
+/**
+ * Write contents to the file used for debugging.
+ *
+ * @since 0.71
+ * @deprecated Use error_log() instead.
+ * @link http://www.php.net/manual/en/function.error-log.php
+ * @deprecated 3.4.0
+ */
+function debug_fwrite( $fp, $string ) {
+    _deprecated_function( __FUNCTION__, 'error_log()' );
+    if ( ! empty( $GLOBALS['debug'] ) )
+        error_log( $string );
+}
+
+/**
+ * Close the debugging file handle.
+ *
+ * @since 0.71
+ * @deprecated Use error_log()
+ * @link http://www.php.net/manual/en/function.error-log.php
+ * @deprecated 3.4.0
+ */
+function debug_fclose( $fp ) {
+    _deprecated_function( __FUNCTION__, 'error_log()' );
+}