cvs: phpdoc /en/reference/dio/functions dio-close.xml dio-fcntl.xml dio-open.xml dio-read.xml dio-seek.xml dio-truncate.xml

betz Sun Jun 29 12:59:53 2003 EDT Modified files: /phpdoc/en/reference/dio/functions dio-close.xml dio-fcntl.xml dio-open.xml dio-read.xml dio-seek.xml dio-truncate.xml Log: grammar and logical errors.

Index: phpdoc/en/reference/dio/functions/dio-close.xml diff -u phpdoc/en/reference/dio/functions/dio-close.xml:1.2 phpdoc/en/reference/dio/functions/dio-close.xml:1.3 --- phpdoc/en/reference/dio/functions/dio-close.xml:1.2 Wed Apr 17 02:37:32 2002 +++ phpdoc/en/reference/dio/functions/dio-close.xml Sun Jun 29 12:59:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> <refentry id="function.dio-close"> <refnamediv> @@ -14,7 +14,7 @@ </methodsynopsis> <para> The function <function>dio_close</function> closes the - file descriptor <parameter>resource</parameter>. + file descriptor <parameter>fd</parameter>. </para> </refsect1> </refentry> Index: phpdoc/en/reference/dio/functions/dio-fcntl.xml diff -u phpdoc/en/reference/dio/functions/dio-fcntl.xml:1.4 phpdoc/en/reference/dio/functions/dio-fcntl.xml:1.5 --- phpdoc/en/reference/dio/functions/dio-fcntl.xml:1.4 Sun Jun 29 12:36:32 2003 +++ phpdoc/en/reference/dio/functions/dio-fcntl.xml Sun Jun 29 12:59:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> <refentry id="function.dio-fcntl"> <refnamediv> @@ -85,8 +85,9 @@ <listitem> <para> F_SETFL - Sets the file descriptors flags to the value specified by - <parameter>arg</parameter>, Which can be O_APPEND,O_NONBLOCK or - O_ASYNC. To use O_ASYNC you will need to use the pcntl extension. + <parameter>arg</parameter>, which can be O_APPEND,O_NONBLOCK or + O_ASYNC. To use O_ASYNC you will need to use the + <link linkend="ref.pcntl">PCNTL</link> extension. </para> </listitem> </itemizedlist> Index: phpdoc/en/reference/dio/functions/dio-open.xml diff -u phpdoc/en/reference/dio/functions/dio-open.xml:1.3 phpdoc/en/reference/dio/functions/dio-open.xml:1.4 --- phpdoc/en/reference/dio/functions/dio-open.xml:1.3 Fri Nov 8 22:23:47 2002 +++ phpdoc/en/reference/dio/functions/dio-open.xml Sun Jun 29 12:59:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> <refentry id="function.dio-open"> <refnamediv> @@ -20,21 +20,21 @@ <para> <function>dio_open</function> opens a file and returns a new file descriptor for it, or &false; if any error occurred. If - <parameter>flags</parameter> is O_CREAT, optional third parameter + <parameter>flags</parameter> is O_CREAT, the optional third parameter <parameter>mode</parameter> will set the mode of the file (creation permissions). The <parameter>flags</parameter> parameter can be one of the following options: <itemizedlist> <listitem> - <para>O_RDONLY - opens the file for read access</para> + <para>O_RDONLY - opens the file for read access.</para> </listitem> <listitem> - <para>O_WRONLY - opens the file for write access</para> + <para>O_WRONLY - opens the file for write access.</para> </listitem> <listitem> <para> O_RDWR - opens the file for both reading and - writing + writing. </para> </listitem> </itemizedlist> @@ -43,26 +43,29 @@ <itemizedlist> <listitem> <para> - O_CREAT - creates the file, if it doesn't already exist + O_CREAT - creates the file, if it doesn't already exist. </para> </listitem> <listitem> <para> O_EXCL - if both, O_CREAT and O_EXCL are set, - <function>dio_open</function> fails, if file already exists + <function>dio_open</function> fails, if the file already exists. </para> </listitem> <listitem> <para> - O_TRUNC - if file exists, and its opened for write access, - file will be truncated to zero length. + O_TRUNC - if the file exists, and its opened for write access, + the file will be truncated to zero length. </para> </listitem> <listitem> <para> O_APPEND - write operations write data at the - end of file</para></listitem> <listitem><para>O_NONBLOCK - - sets non blocking mode + end of the file. + </para> + </listitem> + <listitem> + <para>O_NONBLOCK - sets non blocking mode. </para> </listitem> </itemizedlist> Index: phpdoc/en/reference/dio/functions/dio-read.xml diff -u phpdoc/en/reference/dio/functions/dio-read.xml:1.2 phpdoc/en/reference/dio/functions/dio-read.xml:1.3 --- phpdoc/en/reference/dio/functions/dio-read.xml:1.2 Wed Apr 17 02:37:33 2002 +++ phpdoc/en/reference/dio/functions/dio-read.xml Sun Jun 29 12:59:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> <refentry id="function.dio-read"> <refnamediv> @@ -19,7 +19,7 @@ <para> The function <function>dio_read</function> reads and returns <parameter>n</parameter> bytes from file with descriptor - <parameter>resource</parameter>. If <parameter>n</parameter> is + <parameter>fd</parameter>. If <parameter>n</parameter> is not specified, <function>dio_read</function> reads 1K sized block and returns them. </para> Index: phpdoc/en/reference/dio/functions/dio-seek.xml diff -u phpdoc/en/reference/dio/functions/dio-seek.xml:1.2 phpdoc/en/reference/dio/functions/dio-seek.xml:1.3 --- phpdoc/en/reference/dio/functions/dio-seek.xml:1.2 Wed Apr 17 02:37:33 2002 +++ phpdoc/en/reference/dio/functions/dio-seek.xml Sun Jun 29 12:59:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> <refentry id="function.dio-seek"> <refnamediv> @@ -17,21 +17,21 @@ <para> The function <function>dio_seek</function> is used to change the file position of the file with descriptor - <parameter>resource</parameter>. The parameter + <parameter>fd</parameter>. The parameter <parameter>whence</parameter> specifies how the position <parameter>pos</parameter> should be interpreted: <itemizedlist> <listitem> <para> SEEK_SET - specifies that <parameter>pos</parameter> is - specified from the beginning of the file + specified from the beginning of the file. </para> </listitem> <listitem> <para> SEEK_CUR - Specifies that <parameter>pos</parameter> is a count of characters from the current file position. This count - may be positive or negative + may be positive or negative. </para> </listitem> <listitem> @@ -42,7 +42,7 @@ 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 + position. </para> </listitem> </itemizedlist> Index: phpdoc/en/reference/dio/functions/dio-truncate.xml diff -u phpdoc/en/reference/dio/functions/dio-truncate.xml:1.2 phpdoc/en/reference/dio/functions/dio-truncate.xml:1.3 --- phpdoc/en/reference/dio/functions/dio-truncate.xml:1.2 Wed Apr 17 02:37:33 2002 +++ phpdoc/en/reference/dio/functions/dio-truncate.xml Sun Jun 29 12:59:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> <refentry id="function.dio-truncate"> <refnamediv> @@ -22,8 +22,7 @@ previously was larger than this size, the extra data is lost. If the file previously was shorter, it is unspecified whether the file is left unchanged or is extended. In the latter case the - extended part reads as zero bytes. Returns 0 on success, - otherwise -1. + extended part reads as zero bytes. &return.success;. </para> </refsect1> </refentry>