#32960 [Opn->Csd]: English : dio, error logic + examples
| From: | vrana@php.net | Date: | Fri, 06 May 2005 14:06:30 +0000 |
| Subject: | #32960 [Opn->Csd]: English : dio, error logic + examples | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969368192@lists.php.net to get a copy of this message | ||
ID: 32960
Updated by: vrana@php.net
Reported By: jsgoupil@php.net
-Status: Open
+Status: Closed
Bug Type: Documentation problem
PHP Version: Irrelevant
New Comment:
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation
better.
Next, 2nd and 3rd parameters in dio_seek() examples were swapped.
Previous Comments:
------------------------------------------------------------------------
[2005-05-06 06:29:27] jsgoupil@php.net
By the way, check the example title of dio-open.xml, dio-seek.xml
They all have :
"<title>Setting the baud rate on a serial port</title>"
------------------------------------------------------------------------
[2005-05-06 06:13:48] jsgoupil@php.net
Description:
------------
reference/dio/functions/dio-seek.xml
In the new doc you said :
"SEEK_END - Specifies that pos is a count of characters from the end of
the file. A negative count specifies a position within the current
extent of the file; a positive count specifies a position past the
current end. If you set the position past the current end, and actually
write data, you will extend the file with zeros up to that position."
And in the example :
"dio_seek($fd, SEEK_END, -10);
// position is now at 10 characters past the end of the file.
// The 10 characters between the end of the file and the current
// position are filled with zeros."
I think you do the inverse... ? you said in the doc that - remain in
the file, and + pad with 0, but in the example it seems to be the
inverse. You do -10, and you said it goes after the end...
If the doc is ok, it should be a little bit more explicit.
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=32960&edit=1