sub::name(3pm) [debian man page]

Sub::Name(3pm)						User Contributed Perl Documentation					    Sub::Name(3pm)

NAME

       Sub::Name - (re)name a sub

SYNOPSIS

	   use Sub::Name;

	   subname $name, $subref;

	   $subref = subname foo => sub { ... };

DESCRIPTION

       This module has only one function, which is also exported by default:

   subname NAME, CODEREF
       Assigns a new name to referenced sub.  If package specification is omitted in the name, then the current package is used.  The return value
       is the sub.

       The name is only used for informative routines (caller, Carp, etc).  You won't be able to actually invoke the sub by the given name.  To
       allow that, you need to do glob-assignment yourself.

       Note that for anonymous closures (subs that reference lexicals declared outside the sub itself) you can name each instance of the closure
       differently, which can be very useful for debugging.

AUTHOR

       Matthijs van Duin <xmath@cpan.org>

       Copyright (C) 2004, 2008  Matthijs van Duin.  All rights reserved.  This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

perl v5.14.2							    2010-09-07							    Sub::Name(3pm)

Sub::Delete(3pm)					User Contributed Perl Documentation					  Sub::Delete(3pm)

NAME

       Sub::Delete - Perl module enabling one to delete subroutines

VERSION

       1.00002

SYNOPSIS

	   use Sub::Delete;
	   sub foo {}
	   delete_sub 'foo';
	   eval 'foo();1' or die; # dies

DESCRIPTION

       This module provides one function, "delete_sub", that deletes the subroutine whose name is passed to it. (To load the module without
       importing the function, write "use Sub::Delete();".)

       This does more than simply undefine the subroutine in the manner of "undef &foo", which leaves a stub that can trigger AUTOLOAD (and,
       consequently, won't work for deleting methods).	The subroutine is completely obliterated from the symbol table (though there may be
       references to it elsewhere, including in compiled code).

PREREQUISITES

       This module requires perl 5.8.3 or higher.

LIMITATIONS

       If you take a reference to a glob containing a subroutine, and then delete the subroutine with "delete_sub", you will find that the glob
       you referenced still has a subroutine in it. This is because "delete_sub" removes a glob, replaces it with another, and then copies the
       contents of the old glob into the new one, except for the "CODE" slot. (This is nearly impossible to fix without breaking
       constant::lexical.)

BUGS

       If you find any bugs, please report them to the author via e-mail.

AUTHOR &; COPYRIGHT
       Copyright (C) 2008-10 Father Chrysostomos (sprout at, um, cpan dot org)

       This program is free software; you may redistribute or modify it (or both) under the same terms as perl.

SEE ALSO

       perltodo, which has "delete &sub" listed as a possible future feature

       Symbol::Glob and Symbol::Util, both of which predate this module (but I only discovered them recently), and which allow one to delete any
       arbitrary slot from a glob. Neither of them takes perl 5.10 constants into account, however. They also both differ from this module, in
       that a subroutine referenced in compiled code can no longer be called if deleted from its glob. The entire glob must be replaced (which
       this module does).

perl v5.10.1							    2010-11-06							  Sub::Delete(3pm)