ID: 22282
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
Status: Open
Bug Type: Documentation problem
Operating System: ANY
PHP Version: 4.3.0
New Comment:
According to funcsummary.txt in phpdoc/, this is the function layout
string dba_fetch(string key, [int skip ,] int handle)
Fetches the data associated with key
Is this possible to implement in the documentation without making the
third param optional?
Previous Comments:
------------------------------------------------------------------------
[2003-04-01 17:49:52] [EMAIL PROTECTED]
See:
http://cvs.php.net/cvs.php/phpdoc/en/reference/dba/functions/dba-fetch.xml
Hasn't been touched in four months while the manual was last built two
months ago, reopening...
Although personally I don't understand how a middle parameter can be
optional...
------------------------------------------------------------------------
[2003-04-01 17:27:34] [EMAIL PROTECTED]
If it's fixed in the XML file, the documentation probably hasn't
updated (there has been some problem with that lately). Should be
fixed when documentation starts updating again...
------------------------------------------------------------------------
[2003-02-18 14:25:26] [EMAIL PROTECTED]
The documentation says both skip and handle parameter are optional,
that is wrong.
string dba_fetch ( string key [, int skip, resource handle])
Instead only the skip parameter is optional. A look at the xml file
snippet below shows it is correct.
<methodsynopsis>
<type>string</type><methodname>dba_fetch</methodname>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>skip</parameter></methodparam>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
</methodsynopsis>
Therefore the documentation should state:
string dba_fetch ( string key [, int skip], resource handle)
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=22282&edit=1
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
