X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=e1bd86b4506d8e8c984f745cd2f05374f7c9daf1;hb=22cd37cb62e8ca05600172ecb35338f59581e023;hp=ac635ade3f5bd35ecbdf4382a5676b3ec66cbb21;hpb=13205c2b2fd1a97d43fa6683e27ba36819bfedc1;p=perl%2Fmodules%2FB-RecDeparse.git diff --git a/README b/README index ac635ad..e1bd86b 100644 --- a/README +++ b/README @@ -2,19 +2,26 @@ NAME B::RecDeparse - Deparse recursively into subroutines. VERSION - Version 0.03 + Version 0.10 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,34 @@ 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_srefgen" + + * "pp_gv" Otherwise, B::RecDeparse inherits all methods from B::Deparse. @@ -44,14 +65,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 +91,8 @@ SUPPORT . COPYRIGHT & LICENSE - Copyright 2008 Vincent Pit, all rights reserved. + Copyright 2008,2009,2010,2011,2013,2014,2015 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.