On Jul 19, 2006, at 10:41 AM, Sean Coates wrote:
Welcome,
I just wanted to shoot a quick email to the list to see when we could
start work on docs for Unicode upgrades (PHP 6). The main thing,
IMO, is
having a way to mark functions as Unicode compatible and also have a
section (per-function) for any Unicode-related notes. Any other
thoughts
on this?
A few things..
First, phpdoc contribution seems to be at a low. There's not much
going
on right now, and seemingly not many people willing to pitch in
(myself
included -- I've been lax lately).
That said, technically, we could probably pretty easily add a proto
"U"
parser and add a &unicode.safe; entity to most applicable
functions/sections.
Adding unicode notes could be done on a function-by-function basis; no
need for a dedicated section, as this hopefully won't affect most
functions. If the same issues affect a large subset of functions,
we can
come up with entities for this, too.
Another thing that you and I have discussed, but I've never passed
on to
the list is the new proto markup for traditional strings vs. unicode
strings vs. binary strings. Anyone got thoughts on this?
Since all appropriate functions will be unicode compatible in PHP
6.0.0 this seems like information overload and not something that
should be mentioned in every functions documentation. Perhaps have a
list offsite, maybe on docweb, for alpha/beta testers.
Regards,
Philip
