convert to Dist::Zilla, including careful tailoring of pod to preserve the funky...

[p5sagit/Sub-Name.git] / lib / Sub / Name.pm

diff --git a/lib/Sub/Name.pm b/lib/Sub/Name.pm
index c881b39..bfe3093 100644 (file)
--- a/lib/Sub/Name.pm
+++ b/lib/Sub/Name.pm
@@ -1,10 +1,7 @@
-# $Id: Name.pm,v 1.4 2004/08/18 12:03:42 xmath Exp $
-
 package Sub::Name;
+# ABSTRACT: (re)name a sub
 
-=head1 NAME
-
-Sub::Name - (re)name a sub
+=pod
 
 =head1 SYNOPSIS
 
@@ -16,29 +13,36 @@ Sub::Name - (re)name a sub
 
 =head1 DESCRIPTION
 
-This module has two functions to assign a new name to a sub -- in particular an 
-anonymous sub -- which is displayed in tracebacks and such.  Both functions are 
-exported by default.
+This module has only one function, which is also exported by default:
 
 =head2 subname NAME, CODEREF
 
-Assigns a new name to referenced sub.  If package specification is omitted in 
+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 
+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 closures (anonymous subs that reference lexicals outside the sub 
-itself) you can name each instance of the closure differently, which can be 
-very useful for debugging.
+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.
+
+=head1 SEE ALSO
+
+=over 4
 
-=head1 AUTHOR
+=item *
+L<Sub::Identify> - for getting information about subs
 
-Matthijs van Duin <xmath@cpan.org>
+=back
 
-Copyright (C) 2004  Matthijs van Duin.  All rights reserved.
-This program is free software; you can redistribute it and/or modify 
+=head1 COPYRIGHT AND LICENSE
+
+This software is copyright (c) 2004, 2008 by Matthijs van Duin, all rights reserved;
+copyright (c) 2014 cPanel Inc., all rights reserved.
+
+This program is free software; you can redistribute it and/or modify
 it under the same terms as Perl itself.
 
 =cut
@@ -48,14 +52,17 @@ use 5.006;
 use strict;
 use warnings;
 
-our $VERSION = '0.01';
-
 use base 'Exporter';
-use base 'DynaLoader';
 
 our @EXPORT = qw(subname);
 our @EXPORT_OK = @EXPORT;
 
-bootstrap Sub::Name $VERSION;
+use XSLoader;
+XSLoader::load(
+    __PACKAGE__,
+    exists $Sub::Name::{VERSION}
+        ? ${ $Sub::Name::{VERSION} }
+        : (),
+);
 
 1;