Doc #63295 [Asn->Csd]: Missing information about function alias

Edit report at https://bugs.php.net/bug.php?id=63295&edit=1 ID: 63295 Updated by: philip@php.net Reported by: dreen1 at gmail dot com Summary: Missing information about function alias -Status: Assigned +Status: Closed Type: Documentation Problem Package: MySQL related Operating System: any PHP Version: Irrelevant Assigned To: philip Block user comment: N Private report: N New Comment: Thank you for the bug report, this has been fixed. And as this entire extension is now deprecated, we have decided to keep it simple by only including the single changelog entry for all of these old aliases. It can be seen here: http://php.net/manual/en/changelog.mysql.php Previous Comments: ------------------------------------------------------------------------ [2012-12-07 08:30:12] philip@php.net Automatic comment from SVN on behalf of philip Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=328703 Log: Moved generated changelog to a new changelog.xml, and added deprecated aliases as per PHP Bug #63295. ------------------------------------------------------------------------ [2012-10-25 12:00:47] uw@php.net I've deprecated all undocumented functions alias in PHP 5.5, http://news.php.net/php.cvs/70459 . As I do not know how to properly document it (changelog is auto generated and those functions have never been documented, thus auto generation cannot cover them), I leave the documentation task to the experts - the docs team. ------------------------------------------------------------------------ [2012-10-25 09:57:00] uw@php.net I think, we should change all undocumented PHP_FALIAS into PHP_DEP_FALIAS to cause deprecation warnings. This change should then be noted in the docs together with the deprecated functions. Ulf /* for downwards compatability */ PHP_FALIAS(mysql, mysql_db_query, arginfo_mysql_db_query) --> undocumented PHP_FALIAS(mysql_fieldname, mysql_field_name, arginfo_mysql_field_name) --> undocumented PHP_FALIAS(mysql_fieldtable, mysql_field_table, arginfo_mysql_field_seek) --> undocumented PHP_FALIAS(mysql_fieldlen, mysql_field_len, arginfo_mysql_field_seek) --> undocumented PHP_FALIAS(mysql_fieldtype, mysql_field_type, arginfo_mysql_field_seek) --> undocumented PHP_FALIAS(mysql_fieldflags, mysql_field_flags, arginfo_mysql_field_seek) --> undocumented PHP_FALIAS(mysql_selectdb, mysql_select_db, arginfo_mysql_select_db) --> undocumented #ifndef NETWARE /* The below two functions not supported on NetWare */ #if MYSQL_VERSION_ID < 40000 PHP_DEP_FALIAS(mysql_createdb, mysql_create_db, arginfo_mysql_select_db) --> undocumented PHP_DEP_FALIAS(mysql_dropdb, mysql_drop_db, arginfo_mysql_select_db) --> undocumented #endif #endif /* NETWARE */ PHP_FALIAS(mysql_freeresult, mysql_free_result, arginfo__result_mysql_arg) --> undocumented PHP_FALIAS(mysql_numfields, mysql_num_fields, arginfo__result_mysql_arg) --> undocumented PHP_FALIAS(mysql_numrows, mysql_num_rows, arginfo__result_mysql_arg) --> undocumented PHP_FALIAS(mysql_listdbs, mysql_list_dbs, arginfo__optional_mysql_link) --> undocumented PHP_DEP_FALIAS(mysql_listtables,mysql_list_tables, arginfo_mysql_select_db) --> undocumented PHP_FALIAS(mysql_listfields, mysql_list_fields, arginfo_mysql_list_fields) --> undocumented PHP_FALIAS(mysql_db_name, mysql_result, arginfo_mysql_result) --> ATTN: documented PHP_FALIAS(mysql_dbname, mysql_result, arginfo_mysql_result) --> undocumented PHP_FALIAS(mysql_tablename, mysql_result, arginfo_mysql_result) --> ATTN: documented PHP_FALIAS(mysql_table_name, mysql_result, arginfo_mysql_result) --> ATTN: undocumented although it seems to follow naming of documented ones ------------------------------------------------------------------------ [2012-10-16 23:02:59] dreen1 at gmail dot com Description: ------------ mysql() is an alias to mysql_db_query() which itself is deprecated. this fact is undocumented and left me wondering for a long time why I can't define mysql(). Reading source code revealed the truth. Test script: --------------- <?php function mysql() { return "nope"; } ?> ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=63295&edit=1