#29936 [Opn->Bgs]: Depricated but valid php 4 postgres functions not listed

ID: 29936 Updated by: philip@php.net Reported By: jason at linenplace dot com -Status: Open +Status: Bogus Bug Type: Documentation problem Operating System: Website problem PHP Version: Irrelevant New Comment: Duplicate of PHP bug #17795 so please add comments there. Previous Comments: ------------------------------------------------------------------------ [2004-09-14 16:06:17] jason at linenplace dot com pg_exec() is depricated relative to the latest versions of php. However, in earlier versions still fully supported on the website, pg_exec() is a valid function without alias. Documentation standards such as: "Functions which are kept only for backwards compatibility should be listed under their current parent names, and not documented as separate functions." are very reasonable. However, that does not apply yet. We are not talking about some function from a version of PHP that practically no one runs anymore. A large percentage of webservers still run on php 4.0-4.2. Thus, for many users, the function pg_exec is neither depricated nor aliased. ------------------------------------------------------------------------ [2004-09-14 12:56:06] vrana@php.net So also http://www.php.net/manual/howto/chapter-what-to-document.html should be changed: "Only major functions should be documented; functions which are deprecated variants may be mentioned, but should not be documented as separate functions. They instead should be referenced in the parent function as an alias." ------------------------------------------------------------------------ [2004-09-14 12:40:10] derick@php.net They should be, as the documentation is for 4.0.0-4.3.8 and people looking for a function used in an application that they maintain should not be made harder. ------------------------------------------------------------------------ [2004-09-14 11:40:25] vrana@php.net There's a note at http://www.php.net/manual/en/function.pg-query.php and there's a list of deprecated functions at http://www.php.net/manual/en/ref.pgsql.php#AEN102913. Deprecated functions should not be listed in the function list. ------------------------------------------------------------------------ [2004-09-01 21:36:28] jason at linenplace dot com Description: ------------ I just started working with php's postgres functions. I found out (after hours of frustration some of which is admittedly my fault) that there are depricated names for certain functions. For example, pg_exec was replaced with pg_query in php <= 4.2 All php programmers access the same function list. pg_exec is a valid function for many of us. It should be on the function list as long as the website provides support for versions < 4.2 Thank you very much for your consideration. Jason Reproduce code: --------------- n/a Expected result: ---------------- n/a Actual result: -------------- n/a ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=29936&edit=1