Re: #29936 [Opn]: Depricated but valid php 4 postgres functions not listed

Goba, please say what's the right way. > ID: 29936 > User updated by: jason at linenplace dot com > Reported By: jason at linenplace dot com > Status: Open > Bug Type: Documentation problem > Operating System: Website problem > PHP Version: Irrelevant > New Comment: > 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. > Previous Comments: > ------------------------------------------------------------------------ > [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.