[PHP-DOC] Error in PHP manual of 04-01-2004, function imagettftext

[Stefan Probst]

Dear Authors,

first, thanks for excellent documentation.

There is however an erroneous explanation in function description of 
imagettftext

The concerned sentence reads:
<quote>
/text/ is the text string which may include UTF-8 character sequences (of 
the form: &#123;) to access characters in a font beyond the first 255.
<unquote>

The form "&#123;" is a "Numeric Character Reference" (NCR). NCR's use only 
ASCII characters (the ampersand, a rail-road crossing, an optional letter 
"x", and decimal or hex digits). Therefore, if Unicode characters are 
represented with NCR's, then no UTF-8 (file) encoding is necessary at all.
I am using this function with "real" UTF-8 encoded text, coming from either 
the UTF-8 encoded php-file, or from a database, where text is stored in 
UTF-8 form, and it works fine.

So, a correct (yet not fully explaining) version of your text would be, if 
you replace the "of the form" with "or the form":
<quote>
/text/ is the text string which may include UTF-8 character sequences (or 
the form: &#123;) to access characters in a font beyond the first 255.
<unquote>

My proposal:
<quote>
/text/ is the text string which may include UTF-8 character sequences or 
NCRs (in the form: &#123;) to access characters in a font beyond the first 255.
<unquote>

Best Regards,
Stefan