ID:               29936
 Updated by:       [EMAIL PROTECTED]
 Reported By:      jason at linenplace dot com
 Status:           Open
 Bug Type:         Documentation problem
 Operating System: Website problem
 PHP Version:      Irrelevant
 New Comment:

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."


Previous Comments:
------------------------------------------------------------------------

[2004-09-14 12:40:10] [EMAIL PROTECTED]

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] [EMAIL PROTECTED]

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

Reply via email to