Author: turnstep
Date: Thu Jul 10 10:15:06 2008
New Revision: 11516
Modified:
DBD-Pg/trunk/.perlcriticrc
DBD-Pg/trunk/Changes
DBD-Pg/trunk/META.yml
DBD-Pg/trunk/Makefile.PL
DBD-Pg/trunk/Pg.pm
DBD-Pg/trunk/README
DBD-Pg/trunk/lib/Bundle/DBD/Pg.pm
Log:
Bump version to 2.8.4, do some more cleanup of the docs.
Modified: DBD-Pg/trunk/.perlcriticrc
==============================================================================
--- DBD-Pg/trunk/.perlcriticrc (original)
+++ DBD-Pg/trunk/.perlcriticrc Thu Jul 10 10:15:06 2008
@@ -2,7 +2,7 @@
profile-strictness = quiet
[Documentation::PodSpelling]
-stop_words = ActiveKids AutoCommit boolean Bunce CachedKids ChildHandles
ChopBlanks CompatMode CursorName DBD DBI Datatype dbdpg ErrCount
FetchHashKeyName HandleError HandleSetErr InactiveDestroy LongReadLen
LongTruncOk Mergl Momjian Mullane NULLABLE OID PgBouncer pgend pglibpq pglogin
pgprefix pgquote pgstart perl Postgres PostgreSQL PrintError PrintWarn README
RaiseError RowCache RowCacheSize SQL SQLSTATE SSL STDIN STDERR STDOUT Sabino
Savepoints ShowErrorStatement TaintIn TaintOut TraceLevel UTF Username
afterwards arrayrefs attr autocommit backend bitmask bytea cancelled datatype
dbd dbh errstr fd filename getfd getline hashref largeobject len libpq lseg
pgbuiltin pgsql runtime savepoint savepoints schemas sslmode tablename
tablespace tablespaces tuple typename username varchar undef Perlish arrayref
datatypes bool func PID
+stop_words = ActiveKids AutoCommit boolean Bunce CachedKids ChildHandles
ChopBlanks CompatMode CursorName DBD DBI Datatype dbdpg ErrCount
FetchHashKeyName HandleError HandleSetErr InactiveDestroy LongReadLen
LongTruncOk Mergl Momjian Mullane NULLABLE OID PgBouncer pgend pglibpq pglogin
pgprefix pgquote pgstart perl Postgres PostgreSQL PrintError PrintWarn README
RaiseError RowCache RowCacheSize SQL SQLSTATE SSL STDIN STDERR STDOUT Sabino
Savepoints ShowErrorStatement TaintIn TaintOut TraceLevel UTF Username
afterwards arrayrefs attr autocommit backend bitmask bytea cancelled datatype
dbd dbh errstr fd filename getfd getline hashref largeobject len libpq lseg
pgbuiltin pgsql runtime savepoint savepoints schemas sslmode tablename
tablespace tablespaces tuple typename username varchar undef Perlish arrayref
datatypes bool func PID dr
[-Bangs::ProhibitCommentedOutCode]
[-Bangs::ProhibitFlagComments]
Modified: DBD-Pg/trunk/Changes
==============================================================================
--- DBD-Pg/trunk/Changes (original)
+++ DBD-Pg/trunk/Changes Thu Jul 10 10:15:06 2008
@@ -1,5 +1,9 @@
('GSM' is Greg Sabino Mullane, [EMAIL PROTECTED])
+2.8.4 Released July 10, 2008
+
+ - Minor Perl::Critic test adjustments
+
2.8.3 Released July 6, 2008 (subversion r11495)
- Minor testing functionality tweaks, lots of test cleanups, minor doc
enhancements.
Modified: DBD-Pg/trunk/META.yml
==============================================================================
--- DBD-Pg/trunk/META.yml (original)
+++ DBD-Pg/trunk/META.yml Thu Jul 10 10:15:06 2008
@@ -1,6 +1,6 @@
--- #YAML:1.0
name : DBD-Pg
-version : 2.8.3
+version : 2.8.4
abstract : DBI PostgreSQL interface
author:
- Greg Sabino Mullane <[EMAIL PROTECTED]>
@@ -38,10 +38,10 @@
provides:
DBD::Pg:
file : Pg.pm
- version : 2.8.3
+ version : 2.8.4
Bundle::DBD::Pg:
file : lib/Bundle/DBD/Pg.pm
- version : 2.8.3
+ version : 2.8.4
keywords:
- Postgres
Modified: DBD-Pg/trunk/Makefile.PL
==============================================================================
--- DBD-Pg/trunk/Makefile.PL (original)
+++ DBD-Pg/trunk/Makefile.PL Thu Jul 10 10:15:06 2008
@@ -7,7 +7,7 @@
use 5.006001;
## No version.pm for this one, as the prereqs are not loaded yet.
-my $VERSION = '2.8.3';
+my $VERSION = '2.8.4';
my $lib;
BEGIN {
Modified: DBD-Pg/trunk/Pg.pm
==============================================================================
--- DBD-Pg/trunk/Pg.pm (original)
+++ DBD-Pg/trunk/Pg.pm Thu Jul 10 10:15:06 2008
@@ -17,7 +17,7 @@
{
package DBD::Pg;
- use version; our $VERSION = qv('2.8.3');
+ use version; our $VERSION = qv('2.8.4');
use DBI ();
use DynaLoader ();
@@ -1694,7 +1694,7 @@
=head1 VERSION
-This documents version 2.8.3 of the DBD::Pg module
+This documents version 2.8.4 of the DBD::Pg module
=head1 DESCRIPTION
@@ -1909,8 +1909,9 @@
$h->trace_msg($message_text);
$h->trace_msg($message_text, $min_level);
-Implemented by DBI, no driver-specific impact. Writes a message to the current
trace output.
-With a second argument, only writes the message if the minimum level is
currently set.
+Writes a message to the current trace output (as set by the L</trace> method).
If a second argument
+is given, the message is only written if the current tracing level is equal to
or greater than
+the min_level.
=item B<parse_trace_flag> and B<parse_trace_flags>
@@ -1922,7 +1923,7 @@
The parse_trace_flags method is used to convert one or more named
flags to a number which can passed to the L<trace()> method.
-DBD::Pg currently supports the only DBI-specific flag, C<SQL>,
+DBD::Pg currently supports the DBI-specific flag, C<SQL>,
as well as the ones listed below.
Flags can be combined by using the parse_trace_flags method,
@@ -1943,7 +1944,7 @@
Output all SQL statements. Note that the output provided will not
necessarily be in a form suitable to passing directly to Postgres,
as server-side prepared statements are used extensively by DBD::Pg.
-For maximum portability of output (but with a potential small performance
+For maximum portability of output (but with a potential performance
hit), use $dbh->{pg_server_prepare} = 0;
=item pglibpq
@@ -1961,13 +1962,13 @@
=item pgend
-Outputs a simple message at the very end of each function. This is also output
if the
-trace level is set to 4 or greater.
+Outputs a simple message at the very end of each internal DBD::Pg function.
This is also
+output if the trace level is set to 4 or greater.
=item pgprefix
Forces each line of trace output to begin with the string "dbdpg: ". This
helps to
-differentiate it from the DBI tracing output.
+differentiate it from the normal DBI trace output.
=item pglogin
@@ -2097,8 +2098,8 @@
$hashref = $dbh->private_attribute_info();
$hashref = $sth->private_attribute_info();
-Supported by this driver as proposed by DBI.
-
+Returns a hash of all private attributes used by DBD::Pg, for either
+a database or a statement handle. Currently, all the hash values are undef.
=back
@@ -2106,48 +2107,60 @@
=over 4
-=item B<Warn> (boolean, inherited)
+=item B<InactiveDestroy> (boolean)
-Implemented by DBI, no driver-specific impact.
+If set to true, then the disconnect() method will not be automatically called
when
+the database handle goes out of scope. This is required if you are forking,
and even
+then you must tread carefully and ensure that either the parent or the child
handles
+all database calls from that point forwards, so that messages from the
Postgres backend
+are only handled by one of the processes. If you don't set things up properly,
you
+will see messages such as "server closed the connection unexpectedly". A
better solution
+is usually to rewrite your application not to use forking. See the section on
+L</Asynchronous Queries> for a way to have your script continue to work while
the database
+is working.
-=item B<Active> (boolean, read-only)
+=item B<Warn> (boolean, inherited)
-Supported by this driver as proposed by DBI. A database handle is active while
-it is connected and statement handle is active until it is finished.
+Enables warnings. This is on by default, and should only be turned off in a
local block for a short a time
+as is absolutely needed.
-=item B<Executed> (boolean, read-only)
+=item B<Active> (boolean, read-only)
-Implemented by DBI, no driver-specific impact.
+Indicates if a handle is active or not. For database handles, this indicates
if the database has
+been disconnected or not. For statement handles, it indicates if all the data
has been fetched yet
+or not. Use of this attribute is not encouraged.
=item B<Kids> (integer, read-only)
-Implemented by DBI, no driver-specific impact.
+Returns the number of child processes created for each handle type. For a
driver handle, indicates the number
+of database handles created. For a database handle, indicates the number of
statement handles created. For
+statement handles, it always returns zero, because statement handles do not
create kids.
=item B<ActiveKids> (integer, read-only)
-Implemented by DBI, no driver-specific impact.
+Same as L</Kids>, but only returns those that are L</Active>.
=item B<CachedKids> (hash ref)
Implemented by DBI, no driver-specific impact.
-=item B<Type> (scalar)
+=item B<Executed> (boolean, read-only)
Implemented by DBI, no driver-specific impact.
-=item B<ChildHandles> (array ref)
+=item B<Type> (scalar)
-Implemented by DBI, no driver-specific impact.
+Returns 'dr' for a driver handle, 'db' for a database handle, and 'st' for a
statement handle.
+Should be rarely needed.
-=item B<CompatMode> (boolean, inherited)
+=item B<TraceLevel> (integer, inherited)
-Not used by this driver.
+Sets the trace level, similar to the L</trace> method. See the sections on
+L</trace> and L</parse_trace_flag> for more details.
-=item B<InactiveDestroy> (boolean)
+=item B<ChildHandles> (array ref)
-Implemented by DBI, no driver-specific impact. If set to true, then
-the disconnect() method will not be automatically called when the
-database handle goes out of scope (e.g. when exiting after a fork).
+Implemented by DBI, no driver-specific impact.
=item B<PrintWarn> (boolean, inherited)
@@ -2177,10 +2190,6 @@
Implemented by DBI, no driver-specific impact.
-=item B<TraceLevel> (integer, inherited)
-
-Implemented by DBI, no driver-specific impact.
-
=item B<FetchHashKeyName> (string, inherited)
Implemented by DBI, no driver-specific impact.
@@ -2190,14 +2199,6 @@
Supported by this driver as proposed by DBI. This method is similar to the
SQL function C<RTRIM>.
-=item B<LongReadLen> (integer, inherited)
-
-Not used by this driver.
-
-=item B<LongTruncOk> (boolean, inherited)
-
-Not used by this driver.
-
=item B<Taint> (boolean, inherited)
Implemented by DBI, no driver-specific impact.
@@ -2214,6 +2215,18 @@
Implemented by DBI, no driver-specific impact.
+=item B<LongReadLen> (integer, inherited)
+
+Not used by this driver.
+
+=item B<LongTruncOk> (boolean, inherited)
+
+Not used by this driver.
+
+=item B<CompatMode> (boolean, inherited)
+
+Not used by this driver.
+
=back
=head1 DBI DATABASE HANDLE OBJECTS
Modified: DBD-Pg/trunk/README
==============================================================================
--- DBD-Pg/trunk/README (original)
+++ DBD-Pg/trunk/README Thu Jul 10 10:15:06 2008
@@ -6,7 +6,7 @@
DESCRIPTION:
------------
-This is version 2.8.3 of DBD::Pg. The web site for this interface, and
+This is version 2.8.4 of DBD::Pg. The web site for this interface, and
the latest version, can be found at:
http://search.cpan.org/dist/DBD-Pg/
Modified: DBD-Pg/trunk/lib/Bundle/DBD/Pg.pm
==============================================================================
--- DBD-Pg/trunk/lib/Bundle/DBD/Pg.pm (original)
+++ DBD-Pg/trunk/lib/Bundle/DBD/Pg.pm Thu Jul 10 10:15:06 2008
@@ -4,7 +4,7 @@
use strict;
use warnings;
-$VERSION = '2.8.3';
+$VERSION = '2.8.4';
1;
