Author: timbo Date: Tue Oct 5 08:24:01 2004 New Revision: 477 Modified: dbi/trunk/MANIFEST dbi/trunk/META.yml dbi/trunk/Makefile.PL dbi/trunk/Roadmap.pod Log: Tweak Roadmap and install as DBI::Roadmap for perldoc. Prep for release 1.44
Modified: dbi/trunk/MANIFEST ============================================================================== --- dbi/trunk/MANIFEST (original) +++ dbi/trunk/MANIFEST Tue Oct 5 08:24:01 2004 @@ -1,4 +1,4 @@ -Changes +Changes History of significant changes to the DBI DBI.pm The Database Interface Module Perl code DBI.xs The Database Interface Module XS code DBIXS.h The DBI XS public interface for Drivers (DBD::...) @@ -9,6 +9,7 @@ Makefile.PL The Makefile generator Perl.xs Test harness (currently) for Driver.xst README +Roadmap.pod Planned changes and enhancements for the DBI ToDo Occasional random notes about what's missing dbd_xsh.h Prototypes for standard Driver.xst interface dbi_sql.h Definitions based on SQL CLI / ODBC (#inc'd by DBIXS.h) @@ -17,10 +18,10 @@ dbiproxy.PL Frontend for DBI::ProxyServer dbivport.h DBI version portability macros (for drivers to copy) lib/Bundle/DBI.pm A bundle for automatic installation via CPAN. +lib/DBD/DBM.pm A driver for DBM files (uses DBD::File) lib/DBD/ExampleP.pm A very simple example Driver module -lib/DBD/NullP.pm An empty example Driver module lib/DBD/File.pm A driver base class for simple drivers -lib/DBD/DBM.pm A driver for DBM files (uses DBD::File) +lib/DBD/NullP.pm An empty example Driver module lib/DBD/Proxy.pm Proxy driver lib/DBD/Sponge.pm A driver for fake cursors (precached data) lib/DBI/Const/GetInfo/ANSI.pm GetInfo data based on ANSI standard Modified: dbi/trunk/META.yml ============================================================================== --- dbi/trunk/META.yml (original) +++ dbi/trunk/META.yml Tue Oct 5 08:24:01 2004 @@ -1,11 +1,11 @@ # http://module-build.sourceforge.net/META-spec.html #XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX# name: DBI -version: 1.43 +version: 1.44 version_from: DBI.pm installdirs: site requires: - Test::More: 0.4 + Test::Simple: 0.4 distribution_type: module generated_by: ExtUtils::MakeMaker version 6.17 Modified: dbi/trunk/Makefile.PL ============================================================================== --- dbi/trunk/Makefile.PL (original) +++ dbi/trunk/Makefile.PL Tue Oct 5 08:24:01 2004 @@ -287,16 +287,23 @@ DBI.c: Perl$(OBJ_EXT) # make Changes file available as installed pod docs "perldoc DBI::Changes" +# make Roadmap.pod file available as installed pod docs "perldoc DBI::Roadmap" inst_libdbi = ' . File::Spec->catdir($self->{INST_LIB}, 'DBI') . ' changes_pm = ' . File::Spec->catfile($self->{INST_LIB}, 'DBI', 'Changes.pm') . ' +roadmap_pm = ' . File::Spec->catfile($self->{INST_LIB}, 'DBI', 'Roadmap.pm') . ' -config :: $(changes_pm) +config :: $(changes_pm) $(roadmap_pm) $(NOECHO) $(NOOP) $(changes_pm): Changes $(NOECHO) $(MKPATH) $(inst_libdbi) $(NOECHO) $(RM_F) $(changes_pm) $(CP) Changes $(changes_pm) + +$(roadmap_pm): Roadmap.pod + $(NOECHO) $(MKPATH) $(inst_libdbi) + $(NOECHO) $(RM_F) $(roadmap_pm) + $(CP) Roadmap.pod $(roadmap_pm) '; return $xst; Modified: dbi/trunk/Roadmap.pod ============================================================================== --- dbi/trunk/Roadmap.pod (original) +++ dbi/trunk/Roadmap.pod Tue Oct 5 08:24:01 2004 @@ -1,10 +1,13 @@ -=head1 DBI ROADMAP +=head1 NAME -By Tim Bunce - 27th September 2004 +DBI ROADMAP - Planned Changes and Enhancements for the DBI -=head2 Summary +Tim Bunce - 5th October 2004 -This document gives a high level overview of the future of the Perl DBI module. +=head2 SYNOPSIS + +This document gives a high level overview of the future of +the Perl DBI module. The DBI module is the standard database interface for Perl applications. It is used worldwide in countless applications, in every kind of @@ -24,14 +27,15 @@ maximum future functionality with minimal disruptive (incompatible) upgrades. - -=head2 Scope +=head2 SCOPE Broad categories of changes are outlined here along with some rationale, but implementation details and minor planned enhancements are omitted. More details can be found in: L<http://svn.perl.org/modules/dbi/trunk/ToDo> +=head1 CHANGES AND ENHANCEMENTS + =head2 Batch Statements Batch statements are a sequence of SQL statements, or a stored procedure @@ -276,7 +280,8 @@ That has been resolved but the project has not yet restarted. Each language targeting Parrot would implement their own small -language-specific method dispatcher over the Parrot DBDI interface. +language-specific method dispatcher (a "Perl6 DBI", "Python DBI", +"PHP DBI" etc) layered over the common Parrot DBDI interface and drivers. The major benefit of the DBDI project is that a much wider community of developers share the same database drivers. There would be more @@ -323,7 +328,7 @@ incrementally on the updated foundations. Priorities for those changes have not yet been set. -=head1 Resources and Contributions +=head1 RESOURCES AND CONTRIBUTIONS This roadmap does not address the resources required to implement in a timely manner the changes for DBI v2.0 and beyond.
