Skip to content

Commit 94c1125

Browse files
committed
add class for driver without prefix warning
+ some POD clarifying that
1 parent 50d53fb commit 94c1125

File tree

2 files changed

+13
-3
lines changed

2 files changed

+13
-3
lines changed

lib/DBI/DBD/SqlEngine.pm

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ EOI
9797
}
9898
else
9999
{
100-
warn "Using DBI::DBD::SqlEngine with unregistered driver.\n"
100+
warn "Using DBI::DBD::SqlEngine with unregistered driver $class.\n"
101101
. "Reading documentation how to prevent is strongly recommended.\n";
102102

103103
}
@@ -1699,6 +1699,9 @@ Currently the API of DBI::DBD::SqlEngine is experimental and will
16991699
likely change in the near future to provide the table meta data basics
17001700
like DBD::File.
17011701
1702+
DBI::DBD::SqlEngine expects that any driver in inheritance chain has
1703+
a L<DBI prefix|DBI::DBD/The_database_handle_constructor>.
1704+
17021705
=head2 Metadata
17031706
17041707
The following attributes are handled by DBI itself and not by

lib/DBI/DBD/SqlEngine/HowTo.pod

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,15 @@ L<DBI::DBD/CREATING A NEW DRIVER>.
3030

3131
=head1 CREATING DRIVER CLASSES
3232

33-
Do you have an entry in DBI's DBD registry? For this guide, a prefix of
34-
C<foo_> is assumed.
33+
Do you have an entry in DBI's DBD registry? DBI::DBD::SqlEngine expect
34+
having a unique prefix for every driver class in inheritance chain.
35+
36+
It's easy to get a prefix - just drop the DBI team a note
37+
(L<DBI/GETTING_HELP>). If you want for some reason hide your work, take
38+
a look at L<Class::Method::Modifiers> how to wrap a private prefix method
39+
around existing C<driver_prefix>.
40+
41+
For this guide, a prefix of C<foo_> is assumed.
3542

3643
=head2 Sample Skeleton
3744

0 commit comments

Comments
 (0)