Philip, I assumed what is supposed to be documented is not just a boolean switch: "this is unicode compatible" / "this is not yet unicode compatible", but there are behaviour changes, special options, or anything (I am not actually following PHP 6 development). In case it is just a boolean switch, then indeed there is no point in documenting it. It seems Andrei tries to push the point across that we are not talking about boolean switches.

Gabor

On Wed, 19 Jul 2006, Philip Olson wrote:


I'm unsure if I follow what you mean here Gabor, please clarify.

If we do this soon then later we'll undo it all because when PHP 6.0.0 is released every [appropriate] function will be unicode compatible so repeating this thousands of times throughout the manual won't be useful. The appropriate place to document "the progress" of unicode support for pre PHP 6 should not be in all these manual pages as we do not document alpha/beta releases. If for some reason a function is missed and support is given in, for example, PHP 6.0.1 then we will mention this in the CHANGELOG for said function. But as it stands, everyone is expected to assume unicode support everywhere as that's what PHP 6 is all about.

So, it feels right to document unicode compatibility in a few places like the language reference, features, migration sections, related extension docs (mbstring/iconv/...)... but not per function. In the end people will see the light but not be blinded by it ;-) Also it might be appropriate to document it for each extensions reference.xml as it will be informative and also help promote this new feature.

Regards,
Philip

Reply via email to