Added note for output_handler usage. (with Marcus and Adam's fix)

diff --git a/php.ini-dist b/php.ini-dist
index 97ec48f59f5272420bbdf80bd9f76cda261e355f..cfd948c7b7edc0680d734292774223c4461b5d54 100644 (file)
--- a/php.ini-dist
+++ b/php.ini-dist
@@ -89,9 +89,15 @@ y2k_compliance = Off
 output_buffering = Off
 
 ; You can redirect all of the output of your scripts to a function.  For
-; example, if you set output_handler to "ob_gzhandler", output will be
-; transparently compressed for browsers that support gzip or deflate encoding.
-; Setting an output handler automatically turns on output buffering.
+; example, if you set output_handler to "mb_output_handler", character
+; encoding will be transparently converted to the specified encoding.
+; Setting any output handler automatically turns on output buffering.
+; NOTE: People who wrote portable scripts should not depend on this ini
+; directive. Instead, explicitly set the output handler using ob_start().
+; Using this ini directive may cause problems unless you know what script 
+: is doing.
+; NOTE: You cannot use both "mb_output_handler" with "ob_inconv_handler"
+; and you cannot use both "ob_gzhandler" and "zlib.output_compression". 
 output_handler =
 
 ; The unserialize callback function will called (with the undefind class'

diff --git a/php.ini-recommended b/php.ini-recommended
index acd545906069343386335abf52e325ff92ba200c..036c7fb87df8ebe710bc1203f3929e3a58618311 100644 (file)
--- a/php.ini-recommended
+++ b/php.ini-recommended
@@ -102,9 +102,15 @@ y2k_compliance = Off
 output_buffering = 4096
 
 ; You can redirect all of the output of your scripts to a function.  For
-; example, if you set output_handler to "ob_gzhandler", output will be
-; transparently compressed for browsers that support gzip or deflate encoding.
-; Setting an output handler automatically turns on output buffering.
+; example, if you set output_handler to "mb_output_handler", character
+; encoding will be transparently converted to the specified encoding.
+; Setting any output handler automatically turns on output buffering.
+; NOTE: People who wrote portable scripts should not depend on this ini
+; directive. Instead, explicitly set the output handler using ob_start().
+; Using this ini directive may cause problems unless you know what script 
+: is doing.
+; NOTE: You cannot use both "mb_output_handler" with "ob_inconv_handler"
+; and you cannot use both "ob_gzhandler" and "zlib.output_compression". 
 output_handler =
 
 ; Transparent output compression using the zlib library