cvs: phpdoc /en/reference/oci8/functions OCI-Collection-append.xml OCI-Collection-assign.xml OCI-Collection-assignElem.xml OCI-Collection-free.xml
OCI-Collection-getElem.xml OCI-Collection-max.xml OCI-Collection-size.xml OCI-Collection-trim.xml OCI-Lob-append.xml OCI-Lob-close.xml OCI-Lob-eof.xml
OCI-Lob-erase.xml OCI-Lob-export.xml OCI-Lob-flush.xml OCI-Lob-free.xml OCI-Lob-getBuffering.xml OCI-Lob-import.xml OCI-Lob-load.xml OCI-Lob-read.xml
OCI-Lob-rewind.xml OCI-Lob-save.xml OCI-Lob-saveFile.xml OCI-Lob-seek.xml OCI-Lob-setBuffering.xml OCI-Lob-size.xml OCI-Lob-tell.xml
OCI-Lob-truncate.xml OCI-Lob-write.xml OCI-Lob-writeTemporary.xml OCI-Lob-writeToFile.xml oci-collection-append.xml oci-collection-assign.xml
oci-collection-assignelem.xml oci-collection-free.xml oci-collection-getelem.xml oci-collection-max.xml oci-collection-size.xml
oci-collection-trim.xml oci-lob-append.xml oci-lob-close.xml oci-lob-eof.xml oci-lob-erase.xml oci-lob-export.xml oci-lob-flush.x! ml oci-lob-free.xml
oci-lob-getbuffering.xml oci-lob-import.xml oci-lob-load.xml oci-lob-read.xml oci-lob-rewind.xml oci-lob-save.xml oci-lob-savefile.xml
oci-lob-seek.xml oci-lob-setbuffering.xml oci-lob-size.xml oci-lob-tell.xml oci-lob-truncate.xml oci-lob-write.xml oci-lob-writetemporary.xml
oci-lob-writetofile.xml

didou Mon Feb 5 00:07:03 2007 UTC Added files: /phpdoc/en/reference/oci8/functions oci-collection-assignelem.xml oci-collection-getelem.xml oci-lob-free.xml oci-lob-getbuffering.xml oci-lob-savefile.xml oci-lob-setbuffering.xml oci-lob-writetemporary.xml oci-lob-writetofile.xml Removed files: /phpdoc/en/reference/oci8/functions OCI-Collection-append.xml OCI-Collection-assign.xml OCI-Collection-assignElem.xml OCI-Collection-free.xml OCI-Collection-getElem.xml OCI-Collection-max.xml OCI-Collection-size.xml OCI-Collection-trim.xml OCI-Lob-append.xml OCI-Lob-close.xml OCI-Lob-eof.xml OCI-Lob-erase.xml OCI-Lob-export.xml OCI-Lob-flush.xml OCI-Lob-free.xml OCI-Lob-getBuffering.xml OCI-Lob-import.xml OCI-Lob-load.xml OCI-Lob-read.xml OCI-Lob-rewind.xml OCI-Lob-save.xml OCI-Lob-saveFile.xml OCI-Lob-seek.xml OCI-Lob-setBuffering.xml OCI-Lob-size.xml OCI-Lob-tell.xml OCI-Lob-truncate.xml OCI-Lob-write.xml OCI-Lob-writeTemporary.xml OCI-Lob-writeToFile.xml Modified files: /phpdoc/en/reference/oci8/functions oci-collection-append.xml oci-collection-assign.xml oci-collection-free.xml oci-collection-max.xml oci-collection-size.xml oci-collection-trim.xml oci-lob-append.xml oci-lob-close.xml oci-lob-eof.xml oci-lob-erase.xml oci-lob-export.xml oci-lob-flush.xml oci-lob-import.xml oci-lob-load.xml oci-lob-read.xml oci-lob-rewind.xml oci-lob-save.xml oci-lob-seek.xml oci-lob-size.xml oci-lob-tell.xml oci-lob-truncate.xml oci-lob-write.xml Log: lower case filenames

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-collection-append.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-collection-append.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-collection-append.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-collection-append.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-collection-append"> + <refnamediv> + <refname>OCI-Collection->append</refname> + <refpurpose>Appends element to the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>append</methodname> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Appends element to the end of the collection. Parameter + <parameter>value</parameter> can be a string or a number. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + The value to be added to the collection. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-assign" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-collection-assign.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-collection-assign.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-collection-assign.xml:1.7 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-collection-assign.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.7 $ --> +<refentry id="function.oci-collection-assign"> + <refnamediv> + <refname>OCI-Collection->assign</refname> + <refpurpose>Assigns a value to the collection from another existing collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>assign</methodname> + <methodparam><type>OCI-Collection</type><parameter>from</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Assigns a value to the collection from another, previously created + collection. Both collections must be created with + <function>oci_new_collection</function> prior to using them. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>from</parameter></term> + <listitem> + <para> + An instance of OCI-Collection. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-append" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-collection-free.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-collection-free.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-collection-free.xml:1.3 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-collection-free.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-collection-free"> + <refnamediv> + <refname>OCI-Collection->free</refname> + <refpurpose>Frees the resources associated with the collection object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>free</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Frees the resources associated with the collection object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-new-collection" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-collection-max.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-collection-max.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-collection-max.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-collection-max.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-collection-max"> + <refnamediv> + <refname>OCI-Collection->max</refname> + <refpurpose>Returns the maximum number of elements in the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>max</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns the maximum number of elements in the collection. + If the returned value is 0, then the number of elements is not limited. + <function>OCI-Collection->max</function> returns &false; in case of error. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-size" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-collection-size.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-collection-size.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-collection-size.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-collection-size.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-collection-size"> + <refnamediv> + <refname>OCI-Collection->size</refname> + <refpurpose>Returns size of the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>size</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns the number of elements in the collection or &false; on error. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-max" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-collection-trim.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-collection-trim.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-collection-trim.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-collection-trim.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,72 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-collection-trim"> + <refnamediv> + <refname>OCI-Collection->trim</refname> + <refpurpose>Trims elements from the end of the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>trim</methodname> + <methodparam><type>int</type><parameter>num</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Trims <parameter>num</parameter> of elements from the end of the + collection. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>num</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-size" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-append.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-append.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-append.xml:1.6 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-append.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.6 $ --> +<refentry id="function.oci-lob-append"> + <refnamediv> + <refname>OCI-Lob->append</refname> + <refpurpose>Appends data from the large object to another large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>append</methodname> + <methodparam><type>OCI-Lob</type><parameter>lob_from</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Appends data from the large object to the end of another large object. + </para> + <para> + Writing to the large object with <function>OCI-Lob->append</function> will + fail if buffering was previously enabled. You must disable buffering + before appending. You may need to flush buffers with + <xref linkend="function.oci-lob-flush"/> before disabling buffering. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>lob_from</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-flush" /></member> + <member><xref linkend="function.oci-lob-setbuffering" /></member> + <member><xref linkend="function.oci-lob-getbuffering" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-close.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-close.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-close.xml:1.5 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-close.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> +<refentry id="function.oci-lob-close"> + <refnamediv> + <refname>OCI-Lob->close</refname> + <refpurpose>Closes LOB descriptor</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>close</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + <function>OCI-Lob->close</function> closes descriptor of LOB or FILE. This + function should be used only with + <xref linkend="function.oci-lob-writetemporary" />. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-writetemporary" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-eof.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-eof.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-eof.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-eof.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-eof"> + <refnamediv> + <refname>OCI-Lob->eof</refname> + <refpurpose>Tests for end-of-file on a large object's descriptor</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>eof</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns &true; if internal pointer of large object is at the end of LOB. + Otherwise returns &false;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-size" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-erase.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-erase.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-erase.xml:1.3 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-erase.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,88 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-erase"> + <refnamediv> + <refname>OCI-Lob->erase</refname> + <refpurpose>Erases a specified portion of the internal LOB data</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>erase</methodname> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Erases a specified portion of the internal LOB data starting at a + specified <parameter>offset</parameter>. Parameters + <parameter>length</parameter> and <parameter>offset</parameter> are optional. + <function>OCI-Lob->erase</function> erases all LOB data by default. + </para> + <para> + For BLOBs, erasing means that the existing LOB value is overwritten with + zero-bytes. For CLOBs, the existing LOB value is overwritten with spaces. + </para> + <para> + <function>OCI-Lob->erase</function> returns the actual number of + characters/bytes erased or &false; in case of error. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-truncate" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-export.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-export.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-export.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-export.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,92 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-export"> + <refnamediv> + <refname>OCI-Lob->export</refname> + <refpurpose>Exports LOB's contents to a file</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>export</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Exports LOB contents to a file. The file name is given in the parameter + <parameter>filename</parameter>. The optional parameter + <parameter>start</parameter> indicates from where to start exporting + and the parameter <parameter>length</parameter> - indicates the length of data to be + exported. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-import" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-flush.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-flush.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-flush.xml:1.5 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-flush.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> +<refentry id="function.oci-lob-flush"> + <refnamediv> + <refname>OCI-Lob->flush</refname> + <refpurpose>Flushes/writes buffer of the LOB to the server</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>flush</methodname> + <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>OCI-Lob->flush</function> actually writes data to the server. + By default, resources are not freed, but using flag + <constant>OCI_LOB_BUFFER_FREE</constant> you can do it explicitly. + Be sure you know what you're doing - next read/write operation to the + same part of LOB will involve a round-trip to the server and initialize + new buffer resources. It is recommended to use + <constant>OCI_LOB_BUFFER_FREE</constant> flag only when you are not going + to work with the LOB anymore. + </para> + <para> + <function>OCI-Lob->flush</function> returns &false; if buffering was not + enabled or an error occurred. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>flag</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-getbuffering" /></member> + <member><xref linkend="function.oci-lob-setbuffering" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-import.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-import.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-import.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-import.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-import"> + <refnamediv> + <refname>OCI-Lob->import</refname> + <refpurpose>Imports file data to the LOB</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>import</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Writes data from the <parameter>filename</parameter> in to the current + position of large object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-export" /></member> + <member><xref linkend="function.oci-lob-write" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-load.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-load.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-load.xml:1.5 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-load.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> +<refentry id="function.oci-lob-load"> + <refnamediv> + <refname>OCI-Lob->load</refname> + <refpurpose>Returns large object's contents</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>string</type><methodname>load</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns large object's contents. As script execution is terminated + when the <link linkend="ini.memory-limit">memory_limit</link> is reached, + ensure that the LOB does not exceed this limit. In most cases it's + recommended to use <xref linkend="function.oci-lob-read" /> instead. + In case of error <function>OCI-Lob->load</function> returns &false;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-read" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-read.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-read.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-read.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-read.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-read"> + <refnamediv> + <refname>OCI-Lob->read</refname> + <refpurpose>Reads part of the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>string</type><methodname>read</methodname> + <methodparam><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Reads <parameter>length</parameter> bytes from the current position of LOB's internal pointer. + Reading stops when <parameter>length</parameter> bytes have been read or + end of the large object is reached. Internal pointer of the large object will + be shifted on the amount of bytes read. + </para> + <para> + Returns &false; in case of error. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-load" /></member> + <member><xref linkend="function.oci-lob-write" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-rewind.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-rewind.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-rewind.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-rewind.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-rewind"> + <refnamediv> + <refname>OCI-Lob->rewind</refname> + <refpurpose>Moves the internal pointer to the beginning of the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>rewind</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Sets the internal pointer to the beginning of the large object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-seek" /></member> + <member><xref linkend="function.oci-lob-tell" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-save.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-save.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-save.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-save.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-save"> + <refnamediv> + <refname>OCI-Lob->save</refname> + <refpurpose>Saves data to the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>save</methodname> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Saves <parameter>data</parameter> to the large object. + Parameter <parameter>offset</parameter> can be used to indicate offset + from the beginning of the large object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-write" /></member> + <member><xref linkend="function.oci-lob-import" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-seek.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-seek.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-seek.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-seek.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,100 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-seek"> + <refnamediv> + <refname>OCI-Lob->seek</refname> + <refpurpose>Sets the internal pointer of the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>seek</methodname> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Sets the internal pointer of the large object. Parameter + <parameter>offset</parameter> indicates the amount of + bytes, on which internal pointer should be moved from the position, + pointed by <parameter>whence</parameter>: + <simplelist> + <member> + <constant>OCI_SEEK_SET</constant> - sets the position equal to + <parameter>offset</parameter> + </member> + <member> + <constant>OCI_SEEK_CUR</constant> - adds <parameter>offset</parameter> + bytes to the current position + </member> + <member> + <constant>OCI_SEEK_END</constant> - adds <parameter>offset</parameter> + bytes to the end of large object (use negative value to move to a position + before the end of large object) + </member> + </simplelist> + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>whence</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-rewind" /></member> + <member><xref linkend="function.oci-lob-tell" /></member> + <member><xref linkend="function.oci-lob-eof" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-size.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-size.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-size.xml:1.3 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-size.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-size"> + <refnamediv> + <refname>OCI-Lob->size</refname> + <refpurpose>Returns size of large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>size</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns length of large object value or &false; in case of error. + Empty objects have zero length. + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-tell.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-tell.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-tell.xml:1.5 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-tell.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> +<refentry id="function.oci-lob-tell"> + <refnamediv> + <refname>OCI-Lob->tell</refname> + <refpurpose>Returns current position of internal pointer of large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>tell</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns current position of a LOB's internal pointer or &false; if an + error occurred. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-rewind" /></member> + <member><xref linkend="function.oci-lob-size" /></member> + <member><xref linkend="function.oci-lob-eof" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-truncate.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-truncate.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-truncate.xml:1.4 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-truncate.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-truncate"> + <refnamediv> + <refname>OCI-Lob->truncate</refname> + <refpurpose>Truncates large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>truncate</methodname> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + If parameter <parameter>length</parameter> is given, + <function>OCI-Lob->truncate</function> truncates large object to + <parameter>length</parameter> bytes. Otherwise, + <function>OCI-Lob->truncate</function> will purge the LOB completely. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-erase" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-write.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc/en/reference/oci8/functions/oci-lob-write.xml diff -u /dev/null phpdoc/en/reference/oci8/functions/oci-lob-write.xml:1.3 --- /dev/null Mon Feb 5 00:07:03 2007 +++ phpdoc/en/reference/oci8/functions/oci-lob-write.xml Mon Feb 5 00:07:02 2007 @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-write"> + <refnamediv> + <refname>OCI-Lob->write</refname> + <refpurpose>Writes data to the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>write</methodname> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Writes data from the parameter <parameter>data</parameter> into the + current position of LOB's internal pointer. + If the parameter <parameter>length</parameter> is given, writing will + stop after <parameter>length</parameter> bytes have been written or the + end of <parameter>data</parameter> is reached, whichever comes first. + </para> + <para> + <function>OCI-Lob->write</function> returns the number of bytes written or + &false; in case of error. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-read" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-collection-assignelem.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/oci8/functions/oci-collection-assignelem.xml +++ phpdoc/en/reference/oci8/functions/oci-collection-assignelem.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-collection-element-assign"> <refnamediv> <refname>OCI-Collection->assignElem</refname> <refpurpose>Assigns a value to the element of the collection</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>OCI-Collection</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>assignElem</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Assigns a value to the element with index <parameter>index</parameter>. Parameter <parameter>value</parameter> can be a string or a number. </para> <para> &return.success; </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>index</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>value</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.oci-collection-element-get" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-collection-getelem.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/oci8/functions/oci-collection-getelem.xml +++ phpdoc/en/reference/oci8/functions/oci-collection-getelem.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-collection-element-get"> <refnamediv> <refname>OCI-Collection->getElem</refname> <refpurpose>Returns value of the element</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>OCI-Collection</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>getElem</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Returns element's value with the index <parameter>index</parameter> (1-based). </para> <para> <function>OCI-Collection->getElem</function> returns &false; if such element doesn't exist; &null; if element is &null;; string if element is column of a string datatype or number if element is numeric field. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>index</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.oci-collection-element-assign" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-free.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/oci8/functions/oci-lob-free.xml +++ phpdoc/en/reference/oci8/functions/oci-lob-free.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-lob-free"> <refnamediv> <refname>OCI-Lob->free</refname> <refpurpose>Frees resources associated with the LOB descriptor</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>OCI-Lob</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>free</methodname> <void /> </methodsynopsis> </classsynopsis> <para> Frees resources associated with the descriptor, previously allocated with <function>oci_new_descriptor</function>. </para> <para> &return.success; </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-getbuffering.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/oci8/functions/oci-lob-getbuffering.xml +++ phpdoc/en/reference/oci8/functions/oci-lob-getbuffering.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-lob-getbuffering"> <refnamediv> <refname>OCI-Lob->getBuffering</refname> <refpurpose>Returns current state of buffering for the large object</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>OCI-Lob</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>getBuffering</methodname> <void/> </methodsynopsis> </classsynopsis> <para> Returns &false; if buffering for the large object is off and &true; if buffering is used. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.oci-lob-setbuffering" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-savefile.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/oci8/functions/oci-lob-savefile.xml +++ phpdoc/en/reference/oci8/functions/oci-lob-savefile.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-lob-savefile"> <refnamediv> <refname>OCI-Lob->saveFile</refname> <refpurpose>&Alias; <function>oci_lob_import</function></refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <simpara> &info.function.alias; <function>oci_lob_import</function>. </simpara> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-setbuffering.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/oci8/functions/oci-lob-setbuffering.xml +++ phpdoc/en/reference/oci8/functions/oci-lob-setbuffering.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-lob-setbuffering"> <refnamediv> <refname>OCI-Lob->setBuffering</refname> <refpurpose>Changes current state of buffering for the large object</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>OCI-Lob</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setBuffering</methodname> <methodparam><type>bool</type><parameter>on_off</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>lob->setBuffering</function> sets the buffering for the large object, depending on the value of the <parameter>on_off</parameter> parameter. Repeated calls to <function>lob->setBuffering</function> with the same flag will return &true;. The values for <parameter>on_off </parameter> are: &true; for on and &false; for off. </para> <para> Use of this function may provide performance improvements by buffering small reads and writes of LOBs by reducing the number of network round-trips and LOB versions. <function>oci_lob_flush</function> should be used to flush buffers, when you have finished working with the large object. </para> <para> &return.success; </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>on_off</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.oci-lob-getbuffering" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-writetemporary.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/oci8/functions/oci-lob-writetemporary.xml +++ phpdoc/en/reference/oci8/functions/oci-lob-writetemporary.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-lob-writetemporary"> <refnamediv> <refname>OCI-Lob->writeTemporary</refname> <refpurpose>Writes temporary large object</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>OCI-Lob</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>writeTemporary</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>lob_type</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Creates a temporary large object and writes <parameter>data</parameter> to it. </para> <para> Parameter <parameter>lob_type</parameter> can be one of the following: <simplelist> <member> <constant>OCI_TEMP_BLOB</constant> is used to create temporary BLOBs </member> <member> <constant>OCI_TEMP_CLOB</constant> is used to create temporary CLOBs </member> </simplelist> </para> <para> <function>OCI-Lob->writeTemporary</function> creates a CLOB by default. </para> <para> You should use <xref linkend="function.oci-lob-close" /> when the work with the object is over. </para> <para> &return.success; </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>lob_type</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.oci-lob-close" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/oci8/functions/oci-lob-writetofile.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/oci8/functions/oci-lob-writetofile.xml +++ phpdoc/en/reference/oci8/functions/oci-lob-writetofile.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-lob-writetofile"> <refnamediv> <refname>OCI-Lob->writeToFile</refname> <refpurpose>&Alias; <function>oci_lob_export</function></refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <simpara> &info.function.alias; <function>oci_lob_export</function>. </simpara> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->