X-Git-Url: http://git.vpit.fr/?p=perl%2Fmodules%2FB-RecDeparse.git;a=blobdiff_plain;f=README;h=36020583b619ca2b8e82ade8314d1136cae7acb5;hp=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hb=ed8af32fb71887b9d4bb8e43c0efa02d558da44e;hpb=e531c89b3ecbc5d58156f71c5324f5f253459864 diff --git a/README b/README index e69de29..3602058 100644 --- a/README +++ b/README @@ -0,0 +1,78 @@ +NAME + B::RecDeparse - Deparse recursively into subroutines. + +VERSION + Version 0.05 + +SYNOPSIS + perl -MO=RecDeparse,deparse,[@B__Deparse_opts],level,-1 [ -e '...' | bleh.pl ] + + # Or as a module : + use B::RecDeparse; + + my $brd = B::RecDeparse->new(deparse => [ @b__deparse_opts ], level => $level); + my $code = $brd->coderef2text(sub { ... }); + +DESCRIPTION + This module extends B::Deparse by making it recursively replace + subroutine calls encountered when deparsing. + + Please refer to B::Deparse documentation for what to do and how to do + it. Besides the constructor syntax, everything should work the same for + the two modules. + +METHODS + "new < deparse => [ @B__Deparse_opts ], level => $level >" + The B::RecDeparse object constructor. You can specify the underlying + B::Deparse constructor arguments by passing a string or an array + reference as the value of the "deparse" key. The "level" option expects + an integer that specifies how many levels of recursions are allowed : -1 + means infinite while 0 means none and match B::Deparse behaviour. + + "compile" + "init" + "deparse_sub" + "pp_entersub" + "pp_refgen" + "pp_gv" + Functions and methods from B::Deparse reimplemented by this module. + Never call them directly. + + Otherwise, B::RecDeparse inherits all methods from B::Deparse. + +EXPORT + An object-oriented module shouldn't export any function, and so does + this one. + +DEPENDENCIES + perl 5.8.1. + + Carp (standard since perl 5), Config (since perl 5.00307) and B::Deparse + (since perl 5.005). + +AUTHOR + Vincent Pit, "", . + + You can contact me by mail or on "irc.perl.org" (vincent). + +BUGS + Please report any bugs or feature requests to "bug-b-recdeparse at + rt.cpan.org", or through the web interface at + . I will be + notified, and then you'll automatically be notified of progress on your + bug as I make changes. + +SUPPORT + You can find documentation for this module with the perldoc command. + + perldoc B::RecDeparse + + Tests code coverage report is available at + . + +COPYRIGHT & LICENSE + Copyright 2008,2009,2010,2011 Vincent Pit, all rights reserved. + + This program is free software; you can redistribute it and/or modify it + under the same terms as Perl itself. +