X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=fb57293ab15771c482cbd629d7ea4ef876b70925;hb=d6668cdd400c8d8f02afca5a4df363e26fa71ef0;hp=dc518b9714058d395a218f7656903fc8626744e0;hpb=204608f5565b265a5cad74172ab1f26da58332d7;p=perl%2Fmodules%2FB-RecDeparse.git diff --git a/README b/README index dc518b9..fb57293 100644 --- a/README +++ b/README @@ -2,19 +2,26 @@ NAME B::RecDeparse - Deparse recursively into subroutines. VERSION - Version 0.02 + Version 0.08 SYNOPSIS - perl -MO=RecDeparse,deparse,[@B__Deparse_opts],level,-1 [ -e '...' | bleh.pl ] + # Deparse recursively a Perl one-liner : + $ perl -MO=RecDeparse,deparse,@B__Deparse_opts,level,-1 -e '...' - # Or as a module : + # Or a complete Perl script : + $ perl -MO=RecDeparse,deparse,@B__Deparse_opts,level,-1 x.pl + + # Or a single code reference : use B::RecDeparse; - my $brd = B::RecDeparse->new(deparse => [ @b__deparse_opts ], level => $level); + my $brd = B::RecDeparse->new( + deparse => \@B__Deparse_opts, + level => $level, + ); my $code = $brd->coderef2text(sub { ... }); DESCRIPTION - This module extends B::Deparse by making you recursively replace + 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 @@ -22,20 +29,32 @@ DESCRIPTION the two modules. METHODS - "new < deparse => [ @B__Deparse_opts ], level => $level >" + "new" + my $brd = B::RecDeparse->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" - "pp_entersub" - "pp_refgen" - "pp_gv" - Functions and methods from B::Deparse overriden by this module. Never - call them directly. + The following functions and methods from B::Deparse are reimplemented by + this module : + + * "compile" + + * "init" + + * "deparse_sub" + + * "pp_entersub" + + * "pp_refgen" + + * "pp_gv" Otherwise, B::RecDeparse inherits all methods from B::Deparse. @@ -44,14 +63,15 @@ EXPORT 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 #perl @ FreeNode (vincent or - Prof_Vince). + 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 @@ -69,7 +89,7 @@ SUPPORT . COPYRIGHT & LICENSE - Copyright 2008 Vincent Pit, all rights reserved. + Copyright 2008,2009,2010,2011,2013 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.