Index: formatting.php
===================================================================
--- formatting.php	(revision 46568)
+++ formatting.php	(working copy)
@@ -10,6 +10,8 @@
 /**
  * Replaces common plain text characters into formatted entities
  *
+ * This returns given text with transformations of quotes to smart quotes,
+ * apostrophes, dashes, ellipses, the trademark symbol, and the multiplication symbol.
  * As an example,
  *
  *     'cause today's effort makes it worth tomorrow's "holiday" ...
@@ -23,6 +25,7 @@
  * Do not use this function before the {@see 'init'} action hook; everything will break.
  *
  * @since 0.71
+ * @since 4.0  Revised to improve performance and to resolve many bugs. Added the run_wptexturize filter to allow a theme or plugin to permanently disable this feature.
  *
  * @global array $wp_cockneyreplace Array of formatted entities for certain common phrases
  * @global array $shortcode_tags