Note.

diff --git a/ext/standard/basic_functions.c b/ext/standard/basic_functions.c
index 85de37ba99fef3faebfaa9e7592be465f4d0b98e..fdf43890f9512e0cb4a769e174db558a26bcc488 100644 (file)
--- a/ext/standard/basic_functions.c
+++ b/ext/standard/basic_functions.c
@@ -5479,6 +5479,12 @@ PHP_FUNCTION(php_strip_whitespace)
 
 /* {{{ proto bool highlight_string(string string [, bool return] ) U
    Syntax highlight a string or optionally return it */
+
+/* TODO documentation:
+ * This function will return/ouput UTF-8 if the arg is a Unicode string. Users
+ * should switch their output encoding to UTF-8 when highlighting or manually
+ * convert result to their desired encoding.
+ */
 PHP_FUNCTION(highlight_string)
 {
        zval **expr;