[perl/f17] Add NAME headings to CPAN modules

[Petr Pisar]

commit d1285b2f9c61d6c1647ea5e21d116817f77f938e
Author: Petr Písař <ppisar at redhat.com>
Date:   Mon Feb 18 15:52:11 2013 +0100

    Add NAME headings to CPAN modules

 ...PAN-add-NAME-headings-in-modules-with-POD.patch |   80 ++++++++++++++++++++
 perl.spec                                          |   10 ++-
 2 files changed, 89 insertions(+), 1 deletions(-)
---
diff --git a/perl-5.16.2-cpan-CPAN-add-NAME-headings-in-modules-with-POD.patch b/perl-5.16.2-cpan-CPAN-add-NAME-headings-in-modules-with-POD.patch
new file mode 100644
index 0000000..3d967bf
--- /dev/null
+++ b/perl-5.16.2-cpan-CPAN-add-NAME-headings-in-modules-with-POD.patch
@@ -0,0 +1,80 @@
+From a6a40029a3cbad2c7d9b39cec86b9dc4baf428a9 Mon Sep 17 00:00:00 2001
+From: Dominic Hargreaves <dom at earth.li>
+Date: Tue, 20 Dec 2011 22:19:45 +0000
+Subject: [PATCH 1/4] cpan/CPAN: add NAME headings in modules with POD
+
+This fixes the Debian Lintian warning about missing NAME sections in
+manpages.
+
+Bug-Debian: http://bugs.debian.org/650448
+
+Patch-Name: fixes/manpage_name_CPAN.diff
+---
+ cpan/CPAN/lib/CPAN/Debug.pm        |    4 ++++
+ cpan/CPAN/lib/CPAN/HandleConfig.pm |    6 ++++++
+ cpan/CPAN/lib/CPAN/Queue.pm        |    4 ++++
+ cpan/CPAN/lib/CPAN/Tarzip.pm       |    4 ++++
+ 4 files changed, 18 insertions(+), 0 deletions(-)
+
+diff --git a/cpan/CPAN/lib/CPAN/Debug.pm b/cpan/CPAN/lib/CPAN/Debug.pm
+index 23c4a36..48e394b 100644
+--- a/cpan/CPAN/lib/CPAN/Debug.pm
++++ b/cpan/CPAN/lib/CPAN/Debug.pm
+@@ -71,6 +71,10 @@ sub debug {
+ 
+ __END__
+ 
++=head1 NAME
++
++CPAN::Debug - internal debugging for CPAN.pm
++
+ =head1 LICENSE
+ 
+ This program is free software; you can redistribute it and/or
+diff --git a/cpan/CPAN/lib/CPAN/HandleConfig.pm b/cpan/CPAN/lib/CPAN/HandleConfig.pm
+index 58ccbe5..bab607d 100644
+--- a/cpan/CPAN/lib/CPAN/HandleConfig.pm
++++ b/cpan/CPAN/lib/CPAN/HandleConfig.pm
+@@ -6,6 +6,12 @@ use File::Spec ();
+ use File::Basename ();
+ use Carp ();
+ 
++=head1 NAME
++
++CPAN::HandleConfig - internal configuration handling for CPAN.pm
++
++=cut 
++
+ $VERSION = "5.5003"; # see also CPAN::Config::VERSION at end of file
+ 
+ %can = (
+diff --git a/cpan/CPAN/lib/CPAN/Queue.pm b/cpan/CPAN/lib/CPAN/Queue.pm
+index e5d88ce..1222b37 100644
+--- a/cpan/CPAN/lib/CPAN/Queue.pm
++++ b/cpan/CPAN/lib/CPAN/Queue.pm
+@@ -201,6 +201,10 @@ sub reqtype_of {
+ 
+ __END__
+ 
++=head1 NAME
++
++CPAN::Queue - internal queue support for CPAN.pm
++
+ =head1 LICENSE
+ 
+ This program is free software; you can redistribute it and/or
+diff --git a/cpan/CPAN/lib/CPAN/Tarzip.pm b/cpan/CPAN/lib/CPAN/Tarzip.pm
+index 972df6c..cf8aad4 100644
+--- a/cpan/CPAN/lib/CPAN/Tarzip.pm
++++ b/cpan/CPAN/lib/CPAN/Tarzip.pm
+@@ -450,6 +450,10 @@ END
+ 
+ __END__
+ 
++=head1 NAME
++
++CPAN::Tarzip - internal handling of tar archives for CPAN.pm
++
+ =head1 LICENSE
+ 
+ This program is free software; you can redistribute it and/or
diff --git a/perl.spec b/perl.spec
index 5df1a90..f36d963 100644
--- a/perl.spec
+++ b/perl.spec
@@ -27,7 +27,7 @@
 Name:           perl
 Version:        %{perl_version}
 # release number must be even higher, because dual-lived modules will be broken otherwise
-Release:        221%{?dist}
+Release:        222%{?dist}
 Epoch:          %{perl_epoch}
 Summary:        Practical Extraction and Report Language
 Group:          Development/Languages
@@ -120,6 +120,9 @@ Patch22:        perl-5.17.6-Fix-misparsing-of-maketext-strings.patch
 # Fix double-free when loading Digest::SHA object, rhbz#895543, RT#82655
 Patch23:        perl-5.14.3-RT-82655-fix-double-free-when-loading-object.patch
 
+# Add NAME heading into CPAN PODs, rhbz#908113, CPANRT#73396
+Patch24:        perl-5.16.2-cpan-CPAN-add-NAME-headings-in-modules-with-POD.patch
+
 # Update some of the bundled modules
 # see http://fedoraproject.org/wiki/Perl/perl.spec for instructions
 
@@ -1297,6 +1300,7 @@ tarball from perl.org.
 %patch21 -p1
 %patch22 -p1
 %patch23 -p1
+%patch24 -p1
 
 #copy the example script
 cp -a %{SOURCE5} .
@@ -1509,6 +1513,7 @@ pushd %{build_archlib}/CORE/
     'Fedora Patch21: Override the Pod::Simple::parse_file (CPANRT#77530)' \
     'Fedora Patch22: Fix misparsing of maketext strings (CVE-2012-6329)' \
     'Fedora Patch23: Fix double-free when loading Digest::SHA object' \
+    'Fedora Patch24: Add NAME headings to CPAN modules (CPANRT#73396)' \
     %{nil}
 
 rm patchlevel.bak
@@ -2462,6 +2467,9 @@ sed \
 
 # Old changelog entries are preserved in CVS.
 %changelog
+* Mon Feb 18 2013 Petr Pisar <ppisar at redhat.com> - 4:5.14.3-222
+- Add NAME headings to CPAN modules (bug #908113)
+
 * Wed Jan 30 2013 Jitka Plesnikova <jplesnik at redhat.com> - 4:5.14.3-221
 - Fix RT#82655- Double-free when loading Digest::SHA object