dummy_foundation/lib/XML/DOM/PerlSAX.pm
changeset 0 02cd6b52f378
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/dummy_foundation/lib/XML/DOM/PerlSAX.pm	Thu May 28 10:10:03 2009 +0100
@@ -0,0 +1,46 @@
+package XML::DOM::PerlSAX;
+use strict;
+
+BEGIN
+{
+    if ($^W)
+    {
+	warn "XML::DOM::PerlSAX has been renamed to XML::Handler::DOM, "
+	    "please modify your code accordingly.";
+    }
+}
+
+use XML::Handler::DOM;
+use vars qw{ @ISA };
+@ISA = qw{ XML::Handler::DOM };
+
+1; # package return code
+
+__END__
+
+=head1 NAME
+
+XML::DOM::PerlSAX - Old name of L<XML::Handler::BuildDOM>
+
+=head1 SYNOPSIS
+
+ See L<XML::DOM::BuildDOM>
+
+=head1 DESCRIPTION
+
+XML::DOM::PerlSAX was renamed to L<XML::Handler::BuildDOM> to comply
+with naming conventions for PerlSAX filters/handlers.
+
+For backward compatibility, this package will remain in existence 
+(it simply includes XML::Handler::BuildDOM), but it will print a warning when 
+running with I<'perl -w'>.
+
+=head1 AUTHOR
+
+Send bug reports, hints, tips, suggestions to Enno Derksen at
+<F<enno@att.com>>.
+
+=head1 SEE ALSO
+
+L<XML::Handler::BuildDOM>, L<XML::DOM>
+