From 0d7cbc3f5131d5f3124a7e4273033c75fa7ae090 Mon Sep 17 00:00:00 2001 From: Kenneth Schwartz Date: Tue, 9 Mar 2004 09:28:20 +0000 Subject: [PATCH] proto fixes simple revisions git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@153212 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/oci8/functions/OCI-Collection-assign.xml | 4 ++-- .../oci8/functions/OCI-Collection-assignElem.xml | 4 ++-- reference/oci8/functions/OCI-Lob-append.xml | 10 +++++----- reference/oci8/functions/OCI-Lob-close.xml | 8 ++++---- reference/oci8/functions/OCI-Lob-eof.xml | 4 ++-- reference/oci8/functions/OCI-Lob-flush.xml | 6 +++--- reference/oci8/functions/OCI-Lob-load.xml | 13 ++++++------- reference/oci8/functions/OCI-Lob-rewind.xml | 4 ++-- reference/oci8/functions/OCI-Lob-seek.xml | 4 ++-- reference/oci8/functions/OCI-Lob-truncate.xml | 4 ++-- .../oci8/functions/OCI-Lob-writeTemporary.xml | 4 ++-- reference/oci8/functions/oci-collection-assign.xml | 4 ++-- .../functions/oci-collection-element-assign.xml | 4 ++-- reference/oci8/functions/oci-field-precision.xml | 6 +++--- reference/oci8/functions/oci-field-scale.xml | 6 +++--- reference/oci8/functions/oci-field-size.xml | 4 ++-- reference/oci8/functions/oci-field-type.xml | 4 ++-- reference/oci8/functions/oci-internal-debug.xml | 4 ++-- reference/oci8/functions/oci-lob-append.xml | 10 +++++----- reference/oci8/functions/oci-lob-close.xml | 8 ++++---- reference/oci8/functions/oci-lob-copy.xml | 4 ++-- reference/oci8/functions/oci-lob-eof.xml | 4 ++-- reference/oci8/functions/oci-lob-flush.xml | 6 +++--- reference/oci8/functions/oci-lob-load.xml | 13 ++++++------- reference/oci8/functions/oci-lob-rewind.xml | 4 ++-- reference/oci8/functions/oci-lob-seek.xml | 4 ++-- reference/oci8/functions/oci-lob-truncate.xml | 4 ++-- .../oci8/functions/oci-lob-write-temporary.xml | 4 ++-- reference/oci8/functions/oci-password-change.xml | 6 +++--- reference/oci8/functions/oci-pconnect.xml | 14 ++++++++++---- 30 files changed, 91 insertions(+), 87 deletions(-) diff --git a/reference/oci8/functions/OCI-Collection-assign.xml b/reference/oci8/functions/OCI-Collection-assign.xml index eda8c27aa9..4d2a679ce7 100644 --- a/reference/oci8/functions/OCI-Collection-assign.xml +++ b/reference/oci8/functions/OCI-Collection-assign.xml @@ -1,5 +1,5 @@ - + collection->assign @@ -14,7 +14,7 @@ Assigns a value to the collection from another, previously created collection. Both collections must be created with - oci_new_collection before you can use them. + oci_new_collection prior to using them. &return.success; diff --git a/reference/oci8/functions/OCI-Collection-assignElem.xml b/reference/oci8/functions/OCI-Collection-assignElem.xml index 6d92903f8c..60127edb69 100644 --- a/reference/oci8/functions/OCI-Collection-assignElem.xml +++ b/reference/oci8/functions/OCI-Collection-assignElem.xml @@ -1,5 +1,5 @@ - + collection->assignElem @@ -13,7 +13,7 @@ mixedvalue - Assigns a value to the element with index index + Assigns a value to the element with index index. Parameter value can be a string or a number. diff --git a/reference/oci8/functions/OCI-Lob-append.xml b/reference/oci8/functions/OCI-Lob-append.xml index 171bcf04b0..bb6e5add17 100644 --- a/reference/oci8/functions/OCI-Lob-append.xml +++ b/reference/oci8/functions/OCI-Lob-append.xml @@ -1,5 +1,5 @@ - + lob->append @@ -8,7 +8,7 @@ Description - booleanlob->append + boollob->append objectlob_from @@ -16,9 +16,9 @@ Writing to the large object with lob->append will - fail if buffering was enabled before. You must disable buffering before - appending. You may need to flush buffers - with oci_lob_flush before disabling buffering. + fail if buffering was previously enabled. You must disable buffering + before appending. You may need to flush buffers with + oci_lob_flush before disabling buffering. &return.success; diff --git a/reference/oci8/functions/OCI-Lob-close.xml b/reference/oci8/functions/OCI-Lob-close.xml index 42487a14a8..370fb6263e 100644 --- a/reference/oci8/functions/OCI-Lob-close.xml +++ b/reference/oci8/functions/OCI-Lob-close.xml @@ -1,5 +1,5 @@ - + lob->close @@ -12,15 +12,15 @@ - lob->close closes descriptor of LOB or - FILE. This function should be used only with + lob->close closes descriptor of LOB or FILE. This + function should be used only with lob->writeTemporary. &return.success; - See also oci_lob_write_temporary + See also oci_lob_write_temporary. diff --git a/reference/oci8/functions/OCI-Lob-eof.xml b/reference/oci8/functions/OCI-Lob-eof.xml index cce6e2e7f4..97dc565edb 100644 --- a/reference/oci8/functions/OCI-Lob-eof.xml +++ b/reference/oci8/functions/OCI-Lob-eof.xml @@ -1,5 +1,5 @@ - + lob->eof @@ -8,7 +8,7 @@ Description - booleanlob->eof + boollob->eof diff --git a/reference/oci8/functions/OCI-Lob-flush.xml b/reference/oci8/functions/OCI-Lob-flush.xml index de57e04907..56e8e6d8f4 100644 --- a/reference/oci8/functions/OCI-Lob-flush.xml +++ b/reference/oci8/functions/OCI-Lob-flush.xml @@ -1,5 +1,5 @@ - + lob->flush @@ -17,13 +17,13 @@ OCI_LOB_BUFFER_FREE 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. That's why it's recommended to use + new buffer resources. Tt is recommended to use OCI_LOB_BUFFER_FREE flag only when you are not going to work with the LOB anymore. lob->flush returns &false; if buffering was not - enabled or an error occured. + enabled or an error occurred. &return.success; diff --git a/reference/oci8/functions/OCI-Lob-load.xml b/reference/oci8/functions/OCI-Lob-load.xml index 2a5c195815..6750cbeaea 100644 --- a/reference/oci8/functions/OCI-Lob-load.xml +++ b/reference/oci8/functions/OCI-Lob-load.xml @@ -1,5 +1,5 @@ - + lob->load @@ -12,12 +12,11 @@ - Returns large object's contents. Remember, that really - large objects can or cannot fit in a variable, which - size is limited with memory_limit. - So, in most cases it's recommended to use - oci_lob_read instead. In case of error - lob->load returns &false;. + Returns large object's contents. As script execution is terminated + when the memory_limit is reached, + ensure that the LOB does not exceed this limit. In most cases it's + recommended to use oci_lob_read instead. In case of + error lob->load returns &false;. diff --git a/reference/oci8/functions/OCI-Lob-rewind.xml b/reference/oci8/functions/OCI-Lob-rewind.xml index 71acbc3833..554450c0b0 100644 --- a/reference/oci8/functions/OCI-Lob-rewind.xml +++ b/reference/oci8/functions/OCI-Lob-rewind.xml @@ -1,5 +1,5 @@ - + lob->rewind @@ -8,7 +8,7 @@ Description - booleanlob->rewind + boollob->rewind diff --git a/reference/oci8/functions/OCI-Lob-seek.xml b/reference/oci8/functions/OCI-Lob-seek.xml index 0c4e0753b5..0c6bf7e399 100644 --- a/reference/oci8/functions/OCI-Lob-seek.xml +++ b/reference/oci8/functions/OCI-Lob-seek.xml @@ -1,5 +1,5 @@ - + lob->seek @@ -8,7 +8,7 @@ Description - booleanlob->seek + boollob->seek intoffset intwhence diff --git a/reference/oci8/functions/OCI-Lob-truncate.xml b/reference/oci8/functions/OCI-Lob-truncate.xml index da83c0ea13..26d787ebfe 100644 --- a/reference/oci8/functions/OCI-Lob-truncate.xml +++ b/reference/oci8/functions/OCI-Lob-truncate.xml @@ -1,5 +1,5 @@ - + lob->truncate @@ -8,7 +8,7 @@ Description - booleanlob->truncate + boollob->truncate intlength diff --git a/reference/oci8/functions/OCI-Lob-writeTemporary.xml b/reference/oci8/functions/OCI-Lob-writeTemporary.xml index 91f2173c51..814770f2e5 100644 --- a/reference/oci8/functions/OCI-Lob-writeTemporary.xml +++ b/reference/oci8/functions/OCI-Lob-writeTemporary.xml @@ -1,5 +1,5 @@ - + lob->writeTemporary @@ -28,7 +28,7 @@ - lob->writeTemporary creates CLOB by default. + lob->writeTemporary creates a CLOB by default. You should use oci_lob_close when the work with the diff --git a/reference/oci8/functions/oci-collection-assign.xml b/reference/oci8/functions/oci-collection-assign.xml index eda8c27aa9..4d2a679ce7 100644 --- a/reference/oci8/functions/oci-collection-assign.xml +++ b/reference/oci8/functions/oci-collection-assign.xml @@ -1,5 +1,5 @@ - + collection->assign @@ -14,7 +14,7 @@ Assigns a value to the collection from another, previously created collection. Both collections must be created with - oci_new_collection before you can use them. + oci_new_collection prior to using them. &return.success; diff --git a/reference/oci8/functions/oci-collection-element-assign.xml b/reference/oci8/functions/oci-collection-element-assign.xml index 6d92903f8c..60127edb69 100644 --- a/reference/oci8/functions/oci-collection-element-assign.xml +++ b/reference/oci8/functions/oci-collection-element-assign.xml @@ -1,5 +1,5 @@ - + collection->assignElem @@ -13,7 +13,7 @@ mixedvalue - Assigns a value to the element with index index + Assigns a value to the element with index index. Parameter value can be a string or a number. diff --git a/reference/oci8/functions/oci-field-precision.xml b/reference/oci8/functions/oci-field-precision.xml index e0237a733d..2661dca495 100644 --- a/reference/oci8/functions/oci-field-precision.xml +++ b/reference/oci8/functions/oci-field-precision.xml @@ -1,5 +1,5 @@ - + oci_field_precision @@ -17,8 +17,8 @@ (1-based). - For FLOAT columns precision is nonzero and scale is -127. - If precision is 0, then columnt is NUMBER. Else it's + For FLOAT columns, precision is nonzero and scale is -127. + If precision is 0, then column is NUMBER. Else it's NUMBER(precision, scale). diff --git a/reference/oci8/functions/oci-field-scale.xml b/reference/oci8/functions/oci-field-scale.xml index 57065c03af..80addc280b 100644 --- a/reference/oci8/functions/oci-field-scale.xml +++ b/reference/oci8/functions/oci-field-scale.xml @@ -1,5 +1,5 @@ - + oci_field_scale @@ -17,8 +17,8 @@ (1-based) or &false; if there is no such field. - For FLOAT columns precision is nonzero and scale is -127. - If precision is 0, then columnt is NUMBER. Else it's + For FLOAT columns, precision is nonzero and scale is -127. + If precision is 0, then column is NUMBER. Else it's NUMBER(precision, scale). diff --git a/reference/oci8/functions/oci-field-size.xml b/reference/oci8/functions/oci-field-size.xml index 689bdc1ff9..7d59926f37 100644 --- a/reference/oci8/functions/oci-field-size.xml +++ b/reference/oci8/functions/oci-field-size.xml @@ -1,5 +1,5 @@ - + oci_field_size @@ -13,7 +13,7 @@ mixedfield - oci_field_size returns the size of the column in + oci_field_size returns the size of a field in bytes. Value of field parameter can be the field's index (1-based) or it's name. diff --git a/reference/oci8/functions/oci-field-type.xml b/reference/oci8/functions/oci-field-type.xml index 0f52aa795c..d33b17f0a8 100644 --- a/reference/oci8/functions/oci-field-type.xml +++ b/reference/oci8/functions/oci-field-type.xml @@ -1,5 +1,5 @@ - + oci_field_type @@ -13,7 +13,7 @@ intfield - oci_field_type returns field's data type. + oci_field_type returns a field's data type. Parameter field is an index of the field in the statement (1-based). diff --git a/reference/oci8/functions/oci-internal-debug.xml b/reference/oci8/functions/oci-internal-debug.xml index cc3f028071..5d1e83fc24 100644 --- a/reference/oci8/functions/oci-internal-debug.xml +++ b/reference/oci8/functions/oci-internal-debug.xml @@ -1,5 +1,5 @@ - + oci_internal_debug @@ -14,7 +14,7 @@ oci_internal_debug enables or disables internal debug output. Set onoff to 0 to turn debug - output off and 1 to turn it on. + output off or 1 to turn it on. diff --git a/reference/oci8/functions/oci-lob-append.xml b/reference/oci8/functions/oci-lob-append.xml index 171bcf04b0..bb6e5add17 100644 --- a/reference/oci8/functions/oci-lob-append.xml +++ b/reference/oci8/functions/oci-lob-append.xml @@ -1,5 +1,5 @@ - + lob->append @@ -8,7 +8,7 @@ Description - booleanlob->append + boollob->append objectlob_from @@ -16,9 +16,9 @@ Writing to the large object with lob->append will - fail if buffering was enabled before. You must disable buffering before - appending. You may need to flush buffers - with oci_lob_flush before disabling buffering. + fail if buffering was previously enabled. You must disable buffering + before appending. You may need to flush buffers with + oci_lob_flush before disabling buffering. &return.success; diff --git a/reference/oci8/functions/oci-lob-close.xml b/reference/oci8/functions/oci-lob-close.xml index 42487a14a8..370fb6263e 100644 --- a/reference/oci8/functions/oci-lob-close.xml +++ b/reference/oci8/functions/oci-lob-close.xml @@ -1,5 +1,5 @@ - + lob->close @@ -12,15 +12,15 @@ - lob->close closes descriptor of LOB or - FILE. This function should be used only with + lob->close closes descriptor of LOB or FILE. This + function should be used only with lob->writeTemporary. &return.success; - See also oci_lob_write_temporary + See also oci_lob_write_temporary. diff --git a/reference/oci8/functions/oci-lob-copy.xml b/reference/oci8/functions/oci-lob-copy.xml index eea2a441b2..d8b643b601 100644 --- a/reference/oci8/functions/oci-lob-copy.xml +++ b/reference/oci8/functions/oci-lob-copy.xml @@ -1,5 +1,5 @@ - + oci_lob_copy @@ -8,7 +8,7 @@ Description - intoci_lob_copy + booloci_lob_copy intlength diff --git a/reference/oci8/functions/oci-lob-eof.xml b/reference/oci8/functions/oci-lob-eof.xml index cce6e2e7f4..97dc565edb 100644 --- a/reference/oci8/functions/oci-lob-eof.xml +++ b/reference/oci8/functions/oci-lob-eof.xml @@ -1,5 +1,5 @@ - + lob->eof @@ -8,7 +8,7 @@ Description - booleanlob->eof + boollob->eof diff --git a/reference/oci8/functions/oci-lob-flush.xml b/reference/oci8/functions/oci-lob-flush.xml index de57e04907..56e8e6d8f4 100644 --- a/reference/oci8/functions/oci-lob-flush.xml +++ b/reference/oci8/functions/oci-lob-flush.xml @@ -1,5 +1,5 @@ - + lob->flush @@ -17,13 +17,13 @@ OCI_LOB_BUFFER_FREE 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. That's why it's recommended to use + new buffer resources. Tt is recommended to use OCI_LOB_BUFFER_FREE flag only when you are not going to work with the LOB anymore. lob->flush returns &false; if buffering was not - enabled or an error occured. + enabled or an error occurred. &return.success; diff --git a/reference/oci8/functions/oci-lob-load.xml b/reference/oci8/functions/oci-lob-load.xml index 2a5c195815..6750cbeaea 100644 --- a/reference/oci8/functions/oci-lob-load.xml +++ b/reference/oci8/functions/oci-lob-load.xml @@ -1,5 +1,5 @@ - + lob->load @@ -12,12 +12,11 @@ - Returns large object's contents. Remember, that really - large objects can or cannot fit in a variable, which - size is limited with memory_limit. - So, in most cases it's recommended to use - oci_lob_read instead. In case of error - lob->load returns &false;. + Returns large object's contents. As script execution is terminated + when the memory_limit is reached, + ensure that the LOB does not exceed this limit. In most cases it's + recommended to use oci_lob_read instead. In case of + error lob->load returns &false;. diff --git a/reference/oci8/functions/oci-lob-rewind.xml b/reference/oci8/functions/oci-lob-rewind.xml index 71acbc3833..554450c0b0 100644 --- a/reference/oci8/functions/oci-lob-rewind.xml +++ b/reference/oci8/functions/oci-lob-rewind.xml @@ -1,5 +1,5 @@ - + lob->rewind @@ -8,7 +8,7 @@ Description - booleanlob->rewind + boollob->rewind diff --git a/reference/oci8/functions/oci-lob-seek.xml b/reference/oci8/functions/oci-lob-seek.xml index 0c4e0753b5..0c6bf7e399 100644 --- a/reference/oci8/functions/oci-lob-seek.xml +++ b/reference/oci8/functions/oci-lob-seek.xml @@ -1,5 +1,5 @@ - + lob->seek @@ -8,7 +8,7 @@ Description - booleanlob->seek + boollob->seek intoffset intwhence diff --git a/reference/oci8/functions/oci-lob-truncate.xml b/reference/oci8/functions/oci-lob-truncate.xml index da83c0ea13..26d787ebfe 100644 --- a/reference/oci8/functions/oci-lob-truncate.xml +++ b/reference/oci8/functions/oci-lob-truncate.xml @@ -1,5 +1,5 @@ - + lob->truncate @@ -8,7 +8,7 @@ Description - booleanlob->truncate + boollob->truncate intlength diff --git a/reference/oci8/functions/oci-lob-write-temporary.xml b/reference/oci8/functions/oci-lob-write-temporary.xml index 91f2173c51..814770f2e5 100644 --- a/reference/oci8/functions/oci-lob-write-temporary.xml +++ b/reference/oci8/functions/oci-lob-write-temporary.xml @@ -1,5 +1,5 @@ - + lob->writeTemporary @@ -28,7 +28,7 @@ - lob->writeTemporary creates CLOB by default. + lob->writeTemporary creates a CLOB by default. You should use oci_lob_close when the work with the diff --git a/reference/oci8/functions/oci-password-change.xml b/reference/oci8/functions/oci-password-change.xml index cd80c43ac4..9a6311d575 100644 --- a/reference/oci8/functions/oci-password-change.xml +++ b/reference/oci8/functions/oci-password-change.xml @@ -1,5 +1,5 @@ - + oci_password_change @@ -8,7 +8,7 @@ Description - booleanoci_password_change + booloci_password_change resourceconnection stringusername stringold_password @@ -18,7 +18,7 @@ Changes password for user with username. Parameters old_password and new_password should indicate old and new passwords - accordingly. + respectively. &return.success; diff --git a/reference/oci8/functions/oci-pconnect.xml b/reference/oci8/functions/oci-pconnect.xml index 546a0dd835..be8a829bd2 100644 --- a/reference/oci8/functions/oci-pconnect.xml +++ b/reference/oci8/functions/oci-pconnect.xml @@ -1,11 +1,9 @@ - + oci_pconnect - - Connect to an Oracle database using a persistent connection - + Connect to an Oracle database using a persistent connection Description @@ -28,6 +26,14 @@ oci_pconnect returns connection identifier or &false; on error. + + + Note, that these kind of links only work if you are using + a module version of PHP. See the + Persistent + Database Connections section for more information. + + See also oci_connect and oci_new_connect.