r58481 - in /branches/upstream/libdbd-oracle-perl/current: Changes META.yml Oracle.pm README.explain.txt ora_explain.PL

jump-guest at users.alioth.debian.org jump-guest at users.alioth.debian.org
Wed May 26 21:44:38 UTC 2010


Author: jump-guest
Date: Wed May 26 21:44:31 2010
New Revision: 58481

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=58481
Log:
[svn-upgrade] Integrating new upstream version, libdbd-oracle-perl (1.24b)

Modified:
    branches/upstream/libdbd-oracle-perl/current/Changes
    branches/upstream/libdbd-oracle-perl/current/META.yml
    branches/upstream/libdbd-oracle-perl/current/Oracle.pm
    branches/upstream/libdbd-oracle-perl/current/README.explain.txt
    branches/upstream/libdbd-oracle-perl/current/ora_explain.PL

Modified: branches/upstream/libdbd-oracle-perl/current/Changes
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libdbd-oracle-perl/current/Changes?rev=58481&op=diff
==============================================================================
--- branches/upstream/libdbd-oracle-perl/current/Changes (original)
+++ branches/upstream/libdbd-oracle-perl/current/Changes Wed May 26 21:44:31 2010
@@ -1,7 +1,21 @@
-=head1 Changes in DBD-Oracle 1.24(svn rev 13793)
-  Extended precision for OCIDateTimeToText to 6 instead of 0 for embedded types from John Scoles
-  Extended support of Oracle Embedded objects from Charles Jardine
-  Added support for RowsInCache as RO and RowCacheSize as a set-able value on the Statement Handle. So it would comply with DBI spec By John Scoles with thanks to Martin J. Evans 
+=head1 Changes in DBD-Oracle 1.24_01(svn rev 14060)
+
+  This release has been prepared specifically for the 'Debian' http://www.debian.org project.  It contains no changes
+  to functionality or usage.  The following has been changed
+  
+  Fixed some formatting and typos in Pod from Julián Patiño
+  
+  The Copyright terms for ora_explain have changed and now read as follows:
+  
+  You may distribute under the terms of either the GNU General Public
+  License or the Artistic License, as specified in the Perl README file.
+  
+
+=head1 Changes in DBD-Oracle 1.24(svn rev 13790)
+
+  Extened precision for OCIDateTimeToText to 6 instead of 0 for embedded types from John Scoles
+  Extened support of Oracle Embedded objects from Charles Jardine
+  Added support for RowsInCache as RO and RowCacheSize as a setable value on the Statement Handle. So it would comply with DBI spec By John Scoles with thanks to Martin J. Evans 
   Added extended support for 64 bit clients in Makefile.PL from Ralph Doncaster
   Added extended nvarchar support from Jan Mach
   Added support for the TYPE attribute on bind_col and the new DBI bind_col attributes StrictlyTyped and DiscardString from Martin J. Evans 
@@ -22,6 +36,7 @@
   Fix for bug in 58object.t when test run as externally identified user from Charles Jardine
 
 =head1 Changes in DBD-Oracle 1.23(svn rev 12724)
+
   Fix from rt.cpan.org ticket #=44788 bool in_lite should be char in_literal 
   Fix for UTF8 and blobs by John Scoles with Milo van der Leij
   Fix for some warnings and one bug in ocitrace.h from Charles Jardine
@@ -46,8 +61,8 @@
   Fix for rt.cpan.org Ticket #=38749 Warning of a NULL column in an aggregate function also added ora_oci_success_warn to display silent OCI warnings from John Scoles
   Patch for UTF8 check on execute_array from David Mansfield and a little by John Scoles
   
-  
 =head1 Changes in DBD-Oracle 1.22(svn rev 11618)  1st Aug 2008 
+
   Patch to remove compiler warnings from H.Merijn Brand
   Patch to Makfile for 64bit boxes from Alex Laslavic
   Added OCILobGetLength to lob functions from Milo van der Leij
@@ -73,8 +88,7 @@
   Fix for rt.cpan.org Ticket #=28811 ORA_CHAR(s) not returning correct length in functions and procedures from John Scoles
   Makefile.PL now working without flags for Linux 11.1.0.6 instant client and regular client from John Scoles, Andy Sautins, H.Merijn Brand, Nathan Vonnahme and Karun Dutt
   Fixed how persistent lob fetch works now uses callback correctly, from John Scoles & Darren Kipp
-
-  
+ 
 =head1 Changes in DBD-Oracle 1.21(svn rev 11067) 11th April 2008 
  
   Added Notes to README.win32.txt on installing Instant Client 11.1.0.6.0 from John Scoles

Modified: branches/upstream/libdbd-oracle-perl/current/META.yml
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libdbd-oracle-perl/current/META.yml?rev=58481&op=diff
==============================================================================
--- branches/upstream/libdbd-oracle-perl/current/META.yml (original)
+++ branches/upstream/libdbd-oracle-perl/current/META.yml Wed May 26 21:44:31 2010
@@ -1,11 +1,22 @@
-# http://module-build.sourceforge.net/META-spec.html
-#XXXXXXX This is a prototype!!!  It will change in the future!!! XXXXX#
-name:         DBD-Oracle
-version:      1.24
-version_from: Oracle.pm
-installdirs:  site
-requires:
-    DBI:                           1.51
-
-distribution_type: module
-generated_by: ExtUtils::MakeMaker version 6.17
+--- #YAML:1.0
+name:               DBD-Oracle
+version:            1.24
+abstract:           Oracle database driver for the DBI module
+author:
+    - Tim Bunce (dbi-users at perl.org)
+license:            unknown
+distribution_type:  module
+configure_requires:
+    ExtUtils::MakeMaker:  0
+build_requires:
+    ExtUtils::MakeMaker:  0
+requires:
+    DBI:  1.51
+no_index:
+    directory:
+        - t
+        - inc
+generated_by:       ExtUtils::MakeMaker version 6.55_02
+meta-spec:
+    url:      http://module-build.sourceforge.net/META-spec-v1.4.html
+    version:  1.4

Modified: branches/upstream/libdbd-oracle-perl/current/Oracle.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libdbd-oracle-perl/current/Oracle.pm?rev=58481&op=diff
==============================================================================
--- branches/upstream/libdbd-oracle-perl/current/Oracle.pm (original)
+++ branches/upstream/libdbd-oracle-perl/current/Oracle.pm Wed May 26 21:44:31 2010
@@ -1467,7 +1467,8 @@
 =item :ora_exe_modes
 
   OCI_STMT_SCROLLABLE_READONLY 
-
+  
+=back
 
 =head1 Attributes
 
@@ -1479,7 +1480,7 @@
 
 You can now customize the size of the buffer when selecting LOBs with
 the built in AUTO Lob.  The default value is 4 which should is actully exessive 
-for most situations but is needed for backward compatibilty. 
+for most situations but is needed for backward compatibility. 
 If you not converting between a NCS on the DB and the Client then you might 
 want to set this to 1 to free up memory.  
 
@@ -1871,6 +1872,8 @@
 Specify internal data representation. Currently is supported only for
 ORA_NUMBER_TABLE.
 
+=back
+
 =head1 Optimizing Results
 
 =head2 Prepare postponed till execute
@@ -1908,7 +1911,7 @@
 the C<RowCacheSize> value is set to a negative number then the positive value of RowCacheSize is used 
 to compute the number of rows to prefetch.
 
-By default C<RowCacheSize> is automaticaly set. If you want to totaly turn off prefetching set this to 1.
+By default C<RowCacheSize> is automatically set. If you want to totaly turn off prefetching set this to 1.
 
 For any SQL statment that contains a LOB, Long or Object Type Row Caching will be turned off. However server side 
 caching still works.  If you are only selecting a LOB Locator then Row Caching will still work.
@@ -1938,8 +1941,6 @@
 If the ora_prefetch_memory less than 1 or not present then memory size is not included in computing the 
 number of rows to prefetch otherwise the number of rows will be limited to memory size. Likewise if the RowCacheSize is less than 1 it
 is not included in the computing of the prefetch rows.  
-
-=back
 
 =head1 Spaces & Padding
 
@@ -2853,7 +2854,11 @@
 
 3 = Both character sets are Unicode encodings.
 
+=back
+
 =head1 Private statement handle functions
+
+=over
 
 =item ora_stmt_type
 
@@ -2903,6 +2908,8 @@
 =head2 Scrollable Cursor Methods
 
 The following driver-specific methods are used with scrollable cursors.
+
+=over
 
 =item ora_scroll_position
 
@@ -2965,6 +2972,8 @@
   OCI_FETCH_RELATIVE, and a fetch offset value that is less than 1 is equivalent to a OCI_FETCH_CURRENT.
   OCI_FETCH_RELATIVE, and a fetch offset value that makes it greater than the number of records in the record set, is equivalent to a OCI_FETCH_CURRENT.
 
+=back
+
 =head2 Scrollable Cursor Usage
 
 Given a simple code like this:
@@ -2983,6 +2992,8 @@
 and one assumes that the number of rows returned from the query is 20, the code snippets below will illustrate the use of ora_fetch_scroll
 method;
 
+=over
+
 =item Fetching the Last Row
 
   $value =  $sth->ora_fetch_scroll(OCI_FETCH_LAST,0);
@@ -3079,6 +3090,8 @@
 When using scrollable cursors it is required that you use the $sth->finish() method when you are done with the cursor as this type of
 cursor has to be explicitly canceled on the server. If you do not do this you may cause resource problems on your database.  
 
+=back
+
 =head1 LOBs and LONGs
 
 The key to working with LOBs (CLOB, BLOBs) is to remember the value of an Oracle LOB column is not the content of the LOB. It's a
@@ -3088,6 +3101,8 @@
 
 DBD::Oracle now offers three interfaces to LOB and LONG data, 
 
+=over
+
 =item L</Data Interface for Persistent LOBs>
 
 With this interface DBD::Oracle handles your data directly utilizing regular OCI calls, Oracle itself takes care of the LOB Locator operations in the case of 
@@ -3103,10 +3118,12 @@
 
 =back 
 
-Generally speaking the interface that you will chose will be dependant on what end you are trying to achieve. All have their benefits and 
+Generally speaking the interface that you will chose will be dependent on what end you are trying to achieve. All have their benefits and 
 drawbacks.
 
 One point to remember when working with LOBs (CLOBs, BLOBs) is if your LOB column can be in one of three states;
+
+=over
 
 =item NULL
 
@@ -3130,6 +3147,8 @@
 =item Populated
 
 A LOB instance with a locator and a value exists in the cell. You actually get the LOB value.
+
+=back
 
 =head2 Data Interface for Persistent LOBs
 
@@ -3143,7 +3162,7 @@
 As the name implies this is the simplest way to use this interface. DBD::Oracle just attempts to get your LONG data types as a single large piece. 
 There are no special settings, simply set the database handle's 'LongReadLen' attribute to a value that will be the larger than the expected size of the LONG or LONG RAW.
 If the size of the LONG or LONG RAW exceeds  the 'LongReadLen' DBD::Oracle will return a 'ORA-24345: A Truncation' error.  To stop this set the database handle's 'LongTruncOk' attribute to '1'.
-The maximum value of 'LongReadLen' seems to be dependant on the physical memory limits of the box that Oracle is running on.  You have most likely reached this limit if you run into
+The maximum value of 'LongReadLen' seems to be dependent on the physical memory limits of the box that Oracle is running on.  You have most likely reached this limit if you run into
 an 'ORA-01062: unable to allocate memory for define buffer' error.  One solution is to set the size of 'LongReadLen' to a lower value. 
 
 For example give this table;
@@ -3172,7 +3191,7 @@
 =head3 Using ora_ncs_buff_mtpl
 
 When getting CLOBs and NCLOBs in or out of Oracle, the Server will translate from the Server's NCharSet to the
-Client's. If they happen to be the same or at least compatable then all of these actions are a 1 char to 1 char bases. 
+Client's. If they happen to be the same or at least compatible then all of these actions are a 1 char to 1 char bases. 
 Thus if you set your LongReadLen buffer to 10_000_000 you will get up to 10_000_000 char. 
 
 However if the Server has to translate from one NCharSet to another it will use bytes for conversion. The buffer 
@@ -3208,7 +3227,7 @@
 To use this interface for CLOBs and LOBs datatypes set the 'ora_pers_lob' attribute of the statement handle to '1' with the prepare method, as well
 set the database handle's 'LongReadLen' attribute to a value that will be the larger than the expected size of the LOB. If the size of the LOB exceeds 
 the 'LongReadLen' DBD::Oracle will return a 'ORA-24345: A Truncation' error.  To stop this set the database handle's 'LongTruncOk' attribute to '1'.
-The maximum value of 'LongReadLen' seems to be dependant on the physical memory limits of the box that Oracle is running on in the same way that LONGs and LONG RAWs are. 
+The maximum value of 'LongReadLen' seems to be dependent on the physical memory limits of the box that Oracle is running on in the same way that LONGs and LONG RAWs are. 
 
 For CLOBs and NCLOBs the limit is 64k chars if there is no truncation, this is an internal OCI limit complain to them if you want it changed.  However if you CLOB is longer than this
 and also larger than the 'LongReadLen' than the 'LongReadLen' in chars is returned.
@@ -3251,7 +3270,7 @@
 size of the LOB. Like the L</Simple Fetch for LONGs and LONG RAWs> and L</Simple Fetch for CLOBs and BLOBs> the if the size of the LOB exceeds the is 'LongReadLen' you can use the 'LongTruncOk' attribute to truncate the LOB 
 or set the 'LongReadLen' to a higher value.  With this interface the value of 'ora_piece_size' seems to be constrained by the same memory limit as found on 
 the Simple Fetch interface. If you encounter an 'ORA-01062' error try setting the value of 'ora_piece_size' to a smaller value.   The value for 'LongReadLen' is 
-dependant on the version and settings of the Oracle DB you are using. In theory it ranges from 8GBs
+dependent on the version and settings of the Oracle DB you are using. In theory it ranges from 8GBs
 in 9iR1 up to 128 terabytes with 11g but you will also be limited by the physical memory of your PERL instance.
 
 Using the table from the last example this code;
@@ -3432,9 +3451,8 @@
 
 =head3 Simple Usage
 
-When fetching LOBs with this interface a 'LOB Locator' is created then used to get the lob up dependant on the settings of
-LongReadLen and LongTruncOk attributes.  The value for 'LongReadLen' is 
-dependant on the version and settings of the Oracle DB you are using. In theory it ranges from 8GBs
+When fetching LOBs with this interface a 'LOB Locator' is created then used to get the lob with the LongReadLen and LongTruncOk attributes.  
+The value for 'LongReadLen' is dependent on the version and settings of the Oracle DB you are using. In theory it ranges from 8GBs
 in 9iR1 up to 128 terabytes with 11g but you will also be limited by the physical memory of your PERL instance.
 
 When inserting or updating LOBs some I<major> magic has to be performed

Modified: branches/upstream/libdbd-oracle-perl/current/README.explain.txt
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libdbd-oracle-perl/current/README.explain.txt?rev=58481&op=diff
==============================================================================
--- branches/upstream/libdbd-oracle-perl/current/README.explain.txt (original)
+++ branches/upstream/libdbd-oracle-perl/current/README.explain.txt Wed May 26 21:44:31 2010
@@ -7,9 +7,7 @@
 Copyright (c) 1998 Alan Burlison
 
 You may distribute under the terms of either the GNU General Public License
-or the Artistic License, as specified in the Perl README file, with the
-exception that it cannot be placed on a CD-ROM or similar media for commercial
-distribution without the prior approval of the author.
+or the Artistic License, as specified in the Perl README file.
 
 This code is provided with no warranty of any kind, and is used entirely at
 your own risk.

Modified: branches/upstream/libdbd-oracle-perl/current/ora_explain.PL
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libdbd-oracle-perl/current/ora_explain.PL?rev=58481&op=diff
==============================================================================
--- branches/upstream/libdbd-oracle-perl/current/ora_explain.PL (original)
+++ branches/upstream/libdbd-oracle-perl/current/ora_explain.PL Wed May 26 21:44:31 2010
@@ -9,9 +9,7 @@
 # Copyright (c) 1999 Alan Burlison
 #
 # You may distribute under the terms of either the GNU General Public License
-# or the Artistic License, as specified in the Perl README file, with the
-# exception that it cannot be placed on a CD-ROM or similar media for commercial
-# distribution without the prior approval of the author.
+# or the Artistic License, as specified in the Perl README file.
 #
 # This code is provided with no warranty of any kind, and is used entirely at
 # your own risk.
@@ -161,9 +159,7 @@
                             Alan.Burlison\@uk.sun.com
 
  You may distribute under the terms of either the GNU General Public License
- or the Artistic License, as specified in the Perl README file, with the
- exception that it cannot be placed on a CD-ROM or similar media for commercial
- distribution without the prior approval of the author.
+ or the Artistic License, as specified in the Perl README file.
 
  This code is provided with no warranty of any kind, and is used entirely at
  your own risk.
@@ -1784,9 +1780,7 @@
 Copyright (c) 1999 Alan Burlison
 
 You may distribute under the terms of either the GNU General Public License
-or the Artistic License, as specified in the Perl README file, with the
-exception that it cannot be placed on a CD-ROM or similar media for commercial
-distribution without the prior approval of the author.
+or the Artistic License, as specified in the Perl README file.
 
 This code is provided with no warranty of any kind, and is used entirely at
 your own risk.




More information about the Pkg-perl-cvs-commits mailing list