php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #29936 Depricated but valid php 4 postgres functions not listed
Submitted: 2004-09-01 21:36 UTC Modified: 2004-09-14 17:08 UTC
From: jason at linenplace dot com Assigned:
Status: Not a bug Package: Documentation problem
PHP Version: Irrelevant OS: Website problem
Private report: No CVE-ID: None
View Add Comment Developer Edit
 [2004-09-01 21:36 UTC] 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

Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2004-09-14 11:40 UTC] 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-14 12:40 UTC] 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 12:56 UTC] 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 16:06 UTC] 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 17:08 UTC] philip@php.net 
Duplicate of PHP bug #17795 so please add comments there.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved. 		Last updated: Thu Apr 25 16:01:28 2024 UTC