NAME

Devel::TraceSAX - Trace SAX events

SYNOPSIS

## From the command line:
  perl -d:TraceSAX           script.pl
  perl -d:TraceSAX=-dump_all script.pl

## procedural:
  use Devel::TraceSAX;

  trace_SAX $obj1;

DESCRIPTION

WARNING: alpha code alert!!! This module and its API subject to change, possibly radically :).

Traces SAX events in a program. Works by applying Devel::TraceCalls to a tracer on the desired classes for all known SAX event types (according to XML::SAX::EventMethodMaker and XML::SAX::Machines).

TODO

Add a lot more formatting clean-up.

LIMITATIONS

This module overloads CORE::GLOBAL::require when used from the command line via -d: or -M. For some reason this causes spurious warnings like

Unquoted string "fields" may clash with future reserved word at /usr/local/lib/perl5/5.6.1/base.pm line 87.

That line looks like "require fields;", so it looks like the (*) prototype on our CORE::GLOBAL::require = sub (*) {...} isn't having it's desired effect. It would be nice to clean these up.

AUTHOR

Barrie Slaymaker <barries@slaysys.com>

LICENSE

You may use this under the terms of either the Artistic License or any version of the BSD or GPL licenses :).