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