these are just recommendations, intended to help you (and help us help you
faster).
+This distribution has a TODO file in the repository; you may want to check
+there to see if your issue or patch idea is mentioned.
+
The distribution is managed with Dist::Zilla (https://metacpan.org/release/Dist-Zilla).
However, you can still compile and test the code with a small Makefile.PL
specifically for use in the repository. You can do:
You may need to satisfy some dependencies. The easiest way to satisfy
dependencies is to install the last release -- this is available at
-https://metacpan.org/release/Sub-Name.
+https://metacpan.org/release/Sub-Name
If you use cpanminus, you can do it without downloading the tarball first:
You can learn more about Dist::Zilla at http://dzil.org/.
The code for this distribution is hosted at GitHub. The repository is:
-https://github.com/karenetheridge/Sub-Name
+https://github.com/p5sagit/Sub-Name
You can submit code changes by forking the repository, pushing your code
changes to your clone, and then submitting a pull request. Detailed
instructions for doing that is available here:
If you have found a bug, but do not have an accompanying patch to fix it, you
can submit an issue report here:
https://rt.cpan.org/Public/Dist/Display.html?Name=Sub-Name
-or via bug-Sub-Name@rt.cpan.org.
-This is a good place to send your questions about the usage of this distribution.
+or via email: bug-Sub-Name@rt.cpan.org
+
+There is also an irc channel available for users of this distribution, at
+irc://irc.perl.org/#toolchain
If you send me a patch or pull request, your name and email address will be
included in the documentation as a contributor (using the attribution on the
request to the .mailmap file to contain the correct mapping.
-This file was generated via Dist::Zilla::Plugin::GenerateFile::ShareDir 0.005 from a
-template file originating in Dist-Zilla-PluginBundle-Author-ETHER-0.092.
+This file was generated via Dist::Zilla::Plugin::GenerateFile::FromShareDir 0.009 from a
+template file originating in Dist-Zilla-PluginBundle-Author-ETHER-0.112.
Revision history for Sub-Name
-{{$NEXT}}
+0.15 2016-03-15 22:17:38Z
- fix uninitialized warning in test on perls < 5.8.6 (RT#104510)
- repository moved to the github p5sagit organization (the primary is on
shadowcat, mirrored to github)
--- /dev/null
+This is the Perl distribution Sub-Name.
+
+Installing Sub-Name is straightforward.
+
+## Installation with cpanm
+
+If you have cpanm, you only need one line:
+
+ % cpanm Sub::Name
+
+If you are installing into a system-wide directory, you may need to pass the
+"-S" flag to cpanm, which uses sudo to install the module:
+
+ % cpanm -S Sub::Name
+
+## Installing with the CPAN shell
+
+Alternatively, if your CPAN shell is set up, you should just be able to do:
+
+ % cpan Sub::Name
+
+## Manual installation
+
+As a last resort, you can manually install it. Download the tarball, untar it,
+then build it:
+
+ % perl Makefile.PL
+ % make && make test
+
+Then install it:
+
+ % make install
+
+If you are installing into a system-wide directory, you may need to run:
+
+ % sudo make install
+
+## Documentation
+
+Sub-Name documentation is available as POD.
+You can run perldoc from a shell to read the documentation:
+
+ % perldoc Sub::Name
-This software is copyright (c) 2004 by Matthijs van Duin and cPanel Inc..
+This software is copyright (c) 2004 by Matthijs van Duin and cPanel Inc.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
--- The GNU General Public License, Version 1, February 1989 ---
-This software is Copyright (c) 2004 by Matthijs van Duin and cPanel Inc..
+This software is Copyright (c) 2004 by Matthijs van Duin and cPanel Inc.
This is free software, licensed under:
--- The Artistic License 1.0 ---
-This software is Copyright (c) 2004 by Matthijs van Duin and cPanel Inc..
+This software is Copyright (c) 2004 by Matthijs van Duin and cPanel Inc.
This is free software, licensed under:
=head1 VERSION
-version 0.14
+version 0.15
=head1 SYNOPSIS
=for stopwords cPanel
+=head1 SUPPORT
+
+Bugs may be submitted through L<the RT bug tracker|https://rt.cpan.org/Public/Dist/Display.html?Name=Sub-Name>
+(or L<bug-Sub-Name@rt.cpan.org|mailto:bug-Sub-Name@rt.cpan.org>).
+
+There is also an irc channel available for users of this distribution, at
+L<C<#toolchain> on C<irc.perl.org>|irc://irc.perl.org/#toolchain>.
+
=head1 AUTHOR
Matthijs van Duin <xmath@cpan.org>
/*
----------------------------------------------------------------------
- ppport.h -- Perl/Pollution/Portability Version 3.31
+ ppport.h -- Perl/Pollution/Portability Version 3.32
- Automatically created by Devel::PPPort running under perl 5.021011.
+ Automatically created by Devel::PPPort running under perl 5.023008.
Do NOT edit this file directly! -- Edit PPPort_pm.PL and the
includes in parts/inc/ instead.
=head1 NAME
-ppport.h - Perl/Pollution/Portability version 3.31
+ppport.h - Perl/Pollution/Portability version 3.32
=head1 SYNOPSIS
# Disable broken TRIE-optimization
BEGIN { eval '${^RE_TRIE_MAXBUF} = -1' if $] >= 5.009004 && $] <= 5.009005 }
-my $VERSION = 3.31;
+my $VERSION = 3.32;
my %opt = (
quiet => 0,