The uploaded file DBI-1.33.tar.gz has entered CPAN [...]
I see you repackaged both lib/DBI/DBD/GetInfo.pm and lib/DBI/DBD/TypeInfo.pm into lib/DBI/DBD/Metadata.pm.
I think that's a good idea. You made the write_xxx_pm names uniform too, which is also a good idea, especially in the unified module.
Now I need to send you a patch to lib/DBI/DBD.pm to get the cross-references correct; it still refers to DBI::DBD::GetInfo and DBI::DBD::TypeInfo whereas it needs to refer to DBI::DBD::Metadata.
Let me know if the attachment doesn't work for you and I'll redo it from my Solaris box at the office - tomorrow with luck. I have not validated the changes I've made, nor have I converted the =head3 into the required notation - sorry.
--
Jonathan Leffler ([EMAIL PROTECTED], [EMAIL PROTECTED]) #include <disclaimer.h>
Guardian of DBD::Informix 1.04.PC1 -- http://dbi.perl.org/
--- lib/DBI/DBD.pm 2003-02-26 09:56:25.000000000 -0800
+++ lib/DBI/DBD.pm.new 2003-02-26 22:41:09.000000000 -0800
@@ -3027,20 +3027,22 @@
The exposition above ignores the DBI MetaData methods.
The metadata methods are all associated with a database handle.
-=head2 Using DBI::DBD::GetInfo
+=head2 Using DBI::DBD::Metadata
-This is a good semi-automatic way for the developer of a DBD module to
-write the get_info function quickly and accurately.
+The DBI::DBD::Metadata module is a good semi-automatic way for the developer of a DBD
module to
+write the get_info and type_info functions quickly and accurately.
+
+=head3 Generating the get_info method
Prior to DBI v1.33, this existed as the method write_getinfo_pm in the
DBI::DBD module.
From DBI v1.33, it exists as the method write_getinfo_pm in the
-DBI::DBD::GetInfo module.
+DBI::DBD::Metadata module.
This discussion assumes you have DBI v1.33 or later.
-You examine the documentation for DBI::DBD::GetInfo using:
+You examine the documentation for write_getinfo_pm using:
- perldoc DBI::DBD::GetInfo
+ perldoc DBI::DBD::Metadata
To use it, you need a Perl DBI driver for your database which implements
the get_info method.
@@ -3048,7 +3050,7 @@
manager, and an ODBC driver for your database.
With the pre-requisites in place, you might type:
- perl -MDBI::DBD::GetInfo -e write_getinfo_pm \
+ perl -MDBI::DBD::Metadata -e write_getinfo_pm \
dbi:ODBC:foo_db username password Driver
The procedure writes to standard output the code that should be added to
@@ -3056,22 +3058,22 @@
DBD/Driver/GetInfo.pm.
You should review the output to ensure that it is sensible.
-=head2 Using DBI::DBD::TypeInfo
+=head2 Generating the type_info method
Given the idea of the write_getinfo_pm method, it was not hard to devise
-a parallel method, write_typeinfo, which does the analogous job for the
+a parallel method, write_typeinfo_pm, which does the analogous job for the
DBI type_info_all metadata method.
-The TypeInfo module was added to DBI v1.33.
+The the write_typeinfo_pm method was added to DBI v1.33.
-You examine the documentation for DBI::DBD::TypeInfo using:
+You examine the documentation for write_typeinfo_pm using:
- perldoc DBI::DBD::TypeInfo
+ perldoc DBI::DBD::Metadata
The setup is exactly analogous to the mechanism descibed in
-L</Using DBI::DBD::GetInfo>.
+L</Generating the get_info method>
With the pre-requisites in place, you might type:
- perl -MDBI::DBD::TypeInfo -e write_typeinfo \
+ perl -MDBI::DBD::Metadata -e write_typeinfo \
dbi:ODBC:foo_db username password Driver
The procedure writes to standard output the code that should be added to
