Could you please explain what this means, and how/what ibase documentation should be changed?

No feedback was provided for this bug for over a week, so it is
being suspended automatically. If you are able to provide the
information that was originally requested, please do so and change
the status of the bug back to "Open".

bool ibase_add_user ( resource service_handle, string user_name, string password [, string first_name [, string middle_name [, string last_name]]] )

i'm talking about the first paramater service_handle of function. in earler versions it wasn't there. this may cause problems on upgrade, cause this change is not backward-compatible.

is there any section, where php programmers can see the dangerous areas, that must be changed when upgrading? it would be nice if there'd be in documentation of ibase_add_user, ibase_modify_user etc a note/warning, that this function has changed in php5 and that these changes are not backward compatible.

I don't notice a code difference but AFAICT in PHP 5 the following happened:

* interbase.c was split up into multiple files
* Using ibase_add_user() as an example, the following code remains the same:

PHP_FUNCTION(ibase_add_user)
{
_php_ibase_user(INTERNAL_FUNCTION_PARAM_PASSTHRU, isc_action_svc_add_user);
}

* but the paramaters apparently changed, here's the proto definition in the source:

PHP 4:
/* {{{ proto bool ibase_add_user(string server, string dba_user_name, string dba _password, string user_name, string password [, string first_name [, string middle_name [, string last_name]]]) Add an user to security database (only for IB6 or later) */

PHP 5:
/* {{{ proto bool ibase_add_user(resource service_handle, string user_name, string password [, string first_name [, string middle_name [, string last_name]]]) Add a user to security database */

Someone who knows ibase, and/or can confidently understand php-src, should add appropriate CHANGELOG entries to the appropriate ibase docs rather than depend only the on prototype comments.

I assume service_handle comes from ibase_connect(), right?

It had been documented at 2004/11/04 - before this bug was created.