Author: timbo
Date: Thu Dec 16 08:20:47 2004
New Revision: 632
Modified:
dbi/trunk/DBI.pm
dbi/trunk/lib/DBI/DBD.pm
Log:
Tweak DBI::DBD docs some more.
Add DBD::Multiplex to driver prefix registry, and sort it.
Modified: dbi/trunk/DBI.pm
==============================================================================
--- dbi/trunk/DBI.pm (original)
+++ dbi/trunk/DBI.pm Thu Dec 16 08:20:47 2004
@@ -298,8 +298,8 @@
best_ => { class => 'DBD::BestWins', },
csv_ => { class => 'DBD::CSV', },
db2_ => { class => 'DBD::DB2', },
- dbm_ => { class => 'DBD::DBM', },
dbi_ => { class => 'DBI', },
+ dbm_ => { class => 'DBD::DBM', },
df_ => { class => 'DBD::DF', },
f_ => { class => 'DBD::File', },
file_ => { class => 'DBD::TextFile', },
@@ -308,6 +308,7 @@
ix_ => { class => 'DBD::Informix', },
msql_ => { class => 'DBD::mSQL', },
mysql_ => { class => 'DBD::mysql', },
+ mx_ => { class => 'DBD::Multiplex', },
nullp_ => { class => 'DBD::NullP', },
odbc_ => { class => 'DBD::ODBC', },
ora_ => { class => 'DBD::Oracle', },
@@ -316,9 +317,9 @@
rdb_ => { class => 'DBD::RDB', },
sapdb_ => { class => 'DBD::SAP_DB', },
solid_ => { class => 'DBD::Solid', },
+ sponge_ => { class => 'DBD::Sponge', },
sql_ => { class => 'SQL::Statement', },
syb_ => { class => 'DBD::Sybase', },
- sponge_ => { class => 'DBD::Sponge', },
tdat_ => { class => 'DBD::Teradata', },
tmpl_ => { class => 'DBD::Template', },
tmplss_ => { class => 'DBD::TemplateSS', },
Modified: dbi/trunk/lib/DBI/DBD.pm
==============================================================================
--- dbi/trunk/lib/DBI/DBD.pm (original)
+++ dbi/trunk/lib/DBI/DBD.pm Thu Dec 16 08:20:47 2004
@@ -843,8 +843,11 @@
constructor I<DBI::_new_sth>.
Again, in scalar context, only the outer handle is returned.
The C<Statement> attribute should be cached as shown.
+
Note the prefix I<drv_> in the attribute names: it is required that
-your private attributes are lowercased and use such a prefix.
+all your private attributes use a lowercase prefix unique to your driver.
+The DBI contains a registry of known driver prefixes and may one day
+warn about unknown attributes that don't have a registered prefix.
Note that we parse the statement here in order to set the attribute
I<NUM_OF_PARAMS>.
@@ -915,7 +918,7 @@
if ($attr =~ m/^drv_/) {
# Handle only our private attributes here
# Note that we could trigger arbitrary actions.
- # Ideally we should catch unknown attributes.
+ # Ideally we should warn about unknown attributes.
$dbh->{$attr} = $val; # Yes, we are allowed to do this,
return 1; # but only for our private attributes
}
