README

   1 NAME
   2     B::RecDeparse - Deparse recursively into subroutines.
   3
   4 VERSION
   5     Version 0.05
   6
   7 SYNOPSIS
   8         perl -MO=RecDeparse,deparse,[@B__Deparse_opts],level,-1 [ -e '...' | bleh.pl ]
   9
  10         # Or as a module :
  11         use B::RecDeparse;
  12
  13         my $brd = B::RecDeparse->new(deparse => [ @b__deparse_opts ], level => $level);
  14         my $code = $brd->coderef2text(sub { ... });
  15
  16 DESCRIPTION
  17     This module extends B::Deparse by making it recursively replace
  18     subroutine calls encountered when deparsing.
  19
  20     Please refer to B::Deparse documentation for what to do and how to do
  21     it. Besides the constructor syntax, everything should work the same for
  22     the two modules.
  23
  24 METHODS
  25   "new < deparse => [ @B__Deparse_opts ], level => $level >"
  26     The B::RecDeparse object constructor. You can specify the underlying
  27     B::Deparse constructor arguments by passing a string or an array
  28     reference as the value of the "deparse" key. The "level" option expects
  29     an integer that specifies how many levels of recursions are allowed : -1
  30     means infinite while 0 means none and match B::Deparse behaviour.
  31
  32   "compile"
  33   "init"
  34   "deparse_sub"
  35   "pp_entersub"
  36   "pp_refgen"
  37   "pp_gv"
  38     Functions and methods from B::Deparse reimplemented by this module.
  39     Never call them directly.
  40
  41     Otherwise, B::RecDeparse inherits all methods from B::Deparse.
  42
  43 EXPORT
  44     An object-oriented module shouldn't export any function, and so does
  45     this one.
  46
  47 DEPENDENCIES
  48     perl 5.8.1.
  49
  50     Carp (standard since perl 5), Config (since perl 5.00307) and B::Deparse
  51     (since perl 5.005).
  52
  53 AUTHOR
  54     Vincent Pit, "<perl at profvince.com>", <http://www.profvince.com>.
  55
  56     You can contact me by mail or on "irc.perl.org" (vincent).
  57
  58 BUGS
  59     Please report any bugs or feature requests to "bug-b-recdeparse at
  60     rt.cpan.org", or through the web interface at
  61     <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=B-RecDeparse>. I will be
  62     notified, and then you'll automatically be notified of progress on your
  63     bug as I make changes.
  64
  65 SUPPORT
  66     You can find documentation for this module with the perldoc command.
  67
  68         perldoc B::RecDeparse
  69
  70     Tests code coverage report is available at
  71     <http://www.profvince.com/perl/cover/B-RecDeparse>.
  72
  73 COPYRIGHT & LICENSE
  74     Copyright 2008,2009,2010,2011 Vincent Pit, all rights reserved.
  75
  76     This program is free software; you can redistribute it and/or modify it
  77     under the same terms as Perl itself.
  78