[svn:dbd-oracle] r15363 - in dbd-oracle/trunk: . lib/DBD lib/DBD/Oracle lib/DBD/Oracle/Troubleshooting

[email protected] Thu, 9 Aug 2012 08:23:50 -0700 (PDT)
Newsgroups perl.dbd.oracle.changes
Message-ID <[email protected]>
Author: yanick
Date: Thu Aug  9 08:23:50 2012
New Revision: 15363

Modified:
   dbd-oracle/trunk/Changes
   dbd-oracle/trunk/META.json
   dbd-oracle/trunk/META.yml
   dbd-oracle/trunk/README
   dbd-oracle/trunk/README.mkdn
   dbd-oracle/trunk/lib/DBD/Oracle.pm
   dbd-oracle/trunk/lib/DBD/Oracle/GetInfo.pm
   dbd-oracle/trunk/lib/DBD/Oracle/Object.pm
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting.pod
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Aix.pod
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Cygwin.pod
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Hpux.pm
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Linux.pod
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Macos.pod
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Sun.pod
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Vms.pod
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Win32.pod
   dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Win64.pod

Log:
merging the bump to v1.48 (and v1.49_00 for dev)

Modified: dbd-oracle/trunk/Changes
==============================================================================
--- dbd-oracle/trunk/Changes	(original)
+++ dbd-oracle/trunk/Changes	Thu Aug  9 08:23:50 2012
@@ -29,6 +29,9 @@
 
   - added a few more simple TAF tests (Martin J. Evans)
 
+1.48      2012-08-09
+ - promote 1.47_00 to official release
+
 1.47_00   2012-07-11
 
   [BUG FIXES]

Modified: dbd-oracle/trunk/META.json
==============================================================================
--- dbd-oracle/trunk/META.json	(original)
+++ dbd-oracle/trunk/META.json	Thu Aug  9 08:23:50 2012
@@ -52,27 +52,27 @@
    "provides" : {
       "DBD::Oracle" : {
          "file" : "lib/DBD/Oracle.pm",
-         "version" : "1.47_00"
+         "version" : "1.49_00"
       },
       "DBD::Oracle::GetInfo" : {
          "file" : "lib/DBD/Oracle/GetInfo.pm",
-         "version" : "1.47_00"
+         "version" : "1.49_00"
       },
       "DBD::Oracle::Object" : {
          "file" : "lib/DBD/Oracle/Object.pm",
-         "version" : "1.47_00"
+         "version" : "1.49_00"
       },
       "DBD::Oracle::db" : {
          "file" : "lib/DBD/Oracle.pm",
-         "version" : "1.47_00"
+         "version" : "1.49_00"
       },
       "DBD::Oracle::dr" : {
          "file" : "lib/DBD/Oracle.pm",
-         "version" : "1.47_00"
+         "version" : "1.49_00"
       },
       "DBD::Oracle::st" : {
          "file" : "lib/DBD/Oracle.pm",
-         "version" : "1.47_00"
+         "version" : "1.49_00"
       }
    },
    "release_status" : "testing",
@@ -88,7 +88,7 @@
          "web" : "http://github.com/yanick/DBD-Oracle/tree"
       }
    },
-   "version" : "1.47_00",
+   "version" : "1.49_00",
    "x_authority" : "cpan:PYTHIAN",
    "x_help_wanted" : [
       "coder",

Modified: dbd-oracle/trunk/META.yml
==============================================================================
--- dbd-oracle/trunk/META.yml	(original)
+++ dbd-oracle/trunk/META.yml	Thu Aug  9 08:23:50 2012
@@ -30,22 +30,22 @@
 provides:
   DBD::Oracle:
     file: lib/DBD/Oracle.pm
-    version: 1.47_00
+    version: 1.49_00
   DBD::Oracle::GetInfo:
     file: lib/DBD/Oracle/GetInfo.pm
-    version: 1.47_00
+    version: 1.49_00
   DBD::Oracle::Object:
     file: lib/DBD/Oracle/Object.pm
-    version: 1.47_00
+    version: 1.49_00
   DBD::Oracle::db:
     file: lib/DBD/Oracle.pm
-    version: 1.47_00
+    version: 1.49_00
   DBD::Oracle::dr:
     file: lib/DBD/Oracle.pm
-    version: 1.47_00
+    version: 1.49_00
   DBD::Oracle::st:
     file: lib/DBD/Oracle.pm
-    version: 1.47_00
+    version: 1.49_00
 requires:
   DBI: 0
   DynaLoader: 0
@@ -57,7 +57,7 @@
   bugtracker: http://rt.cpan.org/Public/Dist/Display.html?Name=DBD-Oracle
   homepage: http://search.cpan.org/dist/DBD-Oracle/
   repository: git://github.com/yanick/DBD-Oracle.git
-version: 1.47_00
+version: 1.49_00
 x_authority: cpan:PYTHIAN
 x_help_wanted:
   - coder

Modified: dbd-oracle/trunk/README
==============================================================================
--- dbd-oracle/trunk/README	(original)
+++ dbd-oracle/trunk/README	Thu Aug  9 08:23:50 2012
@@ -2,7 +2,7 @@
     DBD::Oracle - Oracle database driver for the DBI module
 
 VERSION
-    version 1.47_00
+    version 1.49_00
 
 SYNOPSIS
       use DBI;
@@ -206,9 +206,9 @@
     for clients to automatically reconnect to an instance in the event of a
     failure of the instance. The reconnect happens automatically from within
     the OCI (Oracle Call Interface) library. DBD::Oracle now supports a
-    callback function that will fire when a TAF event takes place. The main
-    use of the callback is to give your program the opportunity to inform
-    the user that a failover is taking place.
+    callback function that will fire when a TAF event takes place. You may
+    use the callback to inform the user a failover is taking place or to
+    setup the session again once the failover has succeeded.
 
     You will have to set up TAF on your instance before you can use this
     callback. You can test your instance to see if you can use TAF callback
@@ -219,6 +219,9 @@
     If you try to set up a callback without it being enabled DBD::Oracle
     will croak.
 
+    NOTE: Currently, you must enable TAF during DBI's connect. However once
+    enabled you can change the TAF settings.
+
     It is outside the scope of this document to go through all of the
     possible TAF situations you might want to set up but here is a simple
     example:
@@ -367,6 +370,10 @@
     If your Oracle instance has been configured to use TAF events you can
     enable the TAF callback by setting this option to any *true* value.
 
+    NOTE: All the ora_taf* attributes must currently be set in the connect
+    method if you want TAF enabled at the moment i.e., after connect you can
+    change the callback but you cannot disable TAF.
+
    ora_taf_function
     The name of the Perl subroutine that will be called from OCI when a TAF
     event occurs. You must supply a perl function to use the callback and it
@@ -390,6 +397,9 @@
     successive failover events when the event is OCI_FO_ERROR and
     OCI_FO_RETRY is returned from the TAF handler.
 
+    NOTE: This attribute will be withdrawn in the future so I suggest you
+    don't use it and if you want to sleep, add it to your own callback sub.
+
    ora_session_mode
     The ora_session_mode attribute can be used to connect with SYSDBA,
     SYSOPER and ORA_SYSASM authorization. The ORA_SYSDBA, ORA_SYSOPER and

Modified: dbd-oracle/trunk/README.mkdn
==============================================================================
--- dbd-oracle/trunk/README.mkdn	(original)
+++ dbd-oracle/trunk/README.mkdn	Thu Aug  9 08:23:50 2012
@@ -4,7 +4,7 @@
 
 # VERSION
 
-version 1.47_00
+version 1.49_00
 
 # SYNOPSIS
 
@@ -209,9 +209,9 @@
 event of a failure of the instance. The reconnect happens
 automatically from within the OCI (Oracle Call Interface) library.
 DBD::Oracle now supports a callback function that will fire when a TAF
-event takes place. The main use of the callback is to give your
-program the opportunity to inform the user that a failover is taking
-place.
+event takes place. You may use the callback to inform the
+user a failover is taking place or to setup the session again
+once the failover has succeeded.
 
 You will have to set up TAF on your instance before you can use this
 callback.  You can test your instance to see if you can use TAF
@@ -219,7 +219,11 @@
 
   $dbh->ora_can_taf();
 
-If you try to set up a callback without it being enabled DBD::Oracle will croak.
+If you try to set up a callback without it being enabled DBD::Oracle
+will croak.
+
+NOTE: Currently, you must enable TAF during DBI's connect. However
+once enabled you can change the TAF settings.
 
 It is outside the scope of this document to go through all of the
 possible TAF situations you might want to set up but here is a simple
@@ -377,6 +381,10 @@
 If your Oracle instance has been configured to use TAF events you can
 enable the TAF callback by setting this option to any _true_ value.
 
+NOTE: All the ora_taf* attributes must currently be set in the connect
+method if you want TAF enabled at the moment i.e., after connect you
+can change the callback but you cannot disable TAF.
+
 #### ora_taf_function
 
 The name of the Perl subroutine that will be called from OCI when a
@@ -402,6 +410,10 @@
 successive failover events when the event is OCI_FO_ERROR and OCI_FO_RETRY
 is returned from the TAF handler.
 
+NOTE: This attribute will be withdrawn in the future so I suggest you
+don't use it and if you want to sleep, add it to your own callback
+sub.
+
 #### ora_session_mode
 
 The ora_session_mode attribute can be used to connect with SYSDBA,

Modified: dbd-oracle/trunk/lib/DBD/Oracle.pm
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle.pm	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle.pm	Thu Aug  9 08:23:50 2012
@@ -12,7 +12,7 @@
 {
 package DBD::Oracle;
 {
-  $DBD::Oracle::VERSION = '1.47_00';
+  $DBD::Oracle::VERSION = '1.49_00';
 }
 BEGIN {
   $DBD::Oracle::AUTHORITY = 'cpan:PYTHIAN';
@@ -124,13 +124,7 @@
 
 
 {   package                     # hide from PAUSE
-    DBD::Oracle::dr;
-{
-  $DBD::Oracle::dr::VERSION = '1.47_00';
-}
-BEGIN {
-  $DBD::Oracle::dr::AUTHORITY = 'cpan:PYTHIAN';
-} # ====== DRIVER ======
+    DBD::Oracle::dr;            # ====== DRIVER ======
     use strict;
 
     my %dbnames = ();	# holds list of known databases (oratab + tnsnames)
@@ -330,13 +324,7 @@
 
 
 {   package                     # hide from PAUSE
-    DBD::Oracle::db;
-{
-  $DBD::Oracle::db::VERSION = '1.47_00';
-}
-BEGIN {
-  $DBD::Oracle::db::AUTHORITY = 'cpan:PYTHIAN';
-} # ====== DATABASE ======
+    DBD::Oracle::db;            # ====== DATABASE ======
     use strict;
     use DBI qw(:sql_types);
 
@@ -1060,13 +1048,7 @@
 
 
 {   package                     # hide from PAUSE
-    DBD::Oracle::st;
-{
-  $DBD::Oracle::st::VERSION = '1.47_00';
-}
-BEGIN {
-  $DBD::Oracle::st::AUTHORITY = 'cpan:PYTHIAN';
-} # ====== STATEMENT ======
+    DBD::Oracle::st;            # ====== STATEMENT ======
 
 
    sub bind_param_inout_array {
@@ -1167,7 +1149,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 SYNOPSIS
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/GetInfo.pm
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/GetInfo.pm	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/GetInfo.pm	Thu Aug  9 08:23:50 2012
@@ -1,6 +1,6 @@
 package DBD::Oracle::GetInfo;
 {
-  $DBD::Oracle::GetInfo::VERSION = '1.47_00';
+  $DBD::Oracle::GetInfo::VERSION = '1.49_00';
 }
 BEGIN {
   $DBD::Oracle::GetInfo::AUTHORITY = 'cpan:PYTHIAN';
@@ -295,7 +295,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 AUTHORS
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Object.pm
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Object.pm	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Object.pm	Thu Aug  9 08:23:50 2012
@@ -1,6 +1,6 @@
 package DBD::Oracle::Object;
 {
-  $DBD::Oracle::Object::VERSION = '1.47_00';
+  $DBD::Oracle::Object::VERSION = '1.49_00';
 }
 BEGIN {
   $DBD::Oracle::Object::AUTHORITY = 'cpan:PYTHIAN';
@@ -39,7 +39,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 AUTHORS
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 CONNECTING TO ORACLE
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Aix.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Aix.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Aix.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 Using Visual Age 7 C Compiler 
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Cygwin.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Cygwin.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Cygwin.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 General Info
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Hpux.pm
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Hpux.pm	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Hpux.pm	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 INTRODUCTION
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Linux.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Linux.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Linux.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 Installing with Instantclient .rpm files.
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Macos.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Macos.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Macos.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 General Info 
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Sun.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Sun.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Sun.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 General Info
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Vms.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Vms.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Vms.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 General Info
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Win32.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Win32.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Win32.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 GENERAL INFO
 

Modified: dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Win64.pod
==============================================================================
--- dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Win64.pod	(original)
+++ dbd-oracle/trunk/lib/DBD/Oracle/Troubleshooting/Win64.pod	Thu Aug  9 08:23:50 2012
@@ -11,7 +11,7 @@
 
 =head1 VERSION
 
-version 1.47_00
+version 1.49_00
 
 =head1 DBD::Oracle and Windows 64bit