| Gabor Hojtsy 2006-07-19, 6:58 pm |
| 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
|