LWP::Debug - debug routines for the libwww-perl library

SYNOPSIS

        use LWP::Debug qw(+ -conns);

        # Used internally in the library
        LWP::Debug::trace('send()');
        LWP::Debug::debug('url ok');
        LWP::Debug::conns("read $n bytes: $data");

DESCRIPTION

       LWP::Debug provides tracing facilities. The trace(),
       debug() and conns() function are called within the library
       and they log information at increasing levels of detail.
       Which level of detail is actually printed is controlled
       with the level() function.

       The following functions are available:

       level(...)
           The level() function controls the level of detail
           being logged. Passing '+' or '-' indicates full and no
           logging respectively. Inidividual levels can switched
           on and of by passing the name of the level with a '+'
           or '-' prepended.  The levels are:

             trace   : trace function calls
             debug   : print debug messages
             conns   : show all data transfered over the connections

           The LWP::Debug module provide a special import()
           method that allows you to pass the level() arguments
           with initial use statement.  If a use argument start
           with '+' or '-' then it is passed to the level
           function, else the name is exported as usual.  The
           following two statements are thus equivalent (if you
           ignore that the second pollutes your namespace):

             use LWP::Debug qw(+);
             use LWP::Debug qw(level); level('+');


       trace($msg)
           The trace() function is used for tracing function
           calls. The package and calling subroutine name is
           printed along with the passed argument. This should be
           called at the start of every major function.

       debug($msg)
           The debug() function is used for high-granularity
           reporting of state in functions.
           The conns() function is used to show data being
           transferred over the connections. This may generate
           considerable output.