Just document the preferred way to use any function. Like in this case, the correct way is to use all parameters:
If the documentation points out more than one syntax, I consider it confusing to not provide that optional syntax as one of the prototypes.
The way I see it either remove the references to the old syntax entirely, or include both prototypes regardless of what might be the "correct way" (although that can be noted).
Jani, I wonder why an "incorrect way" is supported by PHP, and if it is supported, why it should not be documented?
Goba
-- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
