Resolves: RHEL-77187 - Update man page

CPAN-2.29-Add-notes-about-first-configuration.patch

@@ -0,0 +1,22 @@
+Add notes about the first configuration and about creating site repository
+which is specific for Fedora/RHEL.
+
+diff -up CPAN-2.29/scripts/cpan.orig CPAN-2.29/scripts/cpan
+--- CPAN-2.29/scripts/cpan.orig	2025-03-03 07:54:40.491966844 +0100
++++ CPAN-2.29/scripts/cpan	2025-03-03 07:54:40.495448509 +0100
+@@ -302,6 +302,15 @@ not control. For now, the exit codes are
+ 
+ 	8	A module failed to install
+ 
++=head1 NOTES  
++
++If the configuration is not defined when C<cpan> is used for the first
++time, CPAN::Config initialization is triggered using L<CPAN::FirstTime>.
++This step is skipped only when using the C<-h> option.
++
++If the user has write permissions to /usr/local, site library repositories
++may also be created.
++
+ =head1 TO DO
+ 
+ * one shot configuration values from the command line

perl-CPAN.spec

@@ -10,7 +10,7 @@
 
 Name:           perl-CPAN
 Version:        2.29
-Release:        4%{?dist}
+Release:        5%{?dist}
 Summary:        Query, download and build perl modules from CPAN sites
 License:        GPL+ or Artistic
 URL:            https://metacpan.org/release/CPAN
@@ -24,6 +24,8 @@ Patch2:         CPAN-2.32-s-gpg-gpg-in-system-add-quotes-where-needed.patch
 Patch3:         CPAN-2.32-s-dev-null-devnull.patch
 # CVE-2023-31484 - Add verify_SSL => 1
 Patch4:         CPAN-2.35-Add-verify-SSL.patch
+# Update man page to provide notes about first run
+Patch5:         CPAN-2.29-Add-notes-about-first-configuration.patch
 BuildArch:      noarch
 BuildRequires:  coreutils
 BuildRequires:  findutils
@@ -262,11 +264,12 @@ with "%{_libexecdir}/%{name}/test".
 
 %prep
 %setup -q -n CPAN-%{version}
-%patch0 -p1
-%patch1 -p1
-%patch2 -p1
-%patch3 -p1
-%patch4 -p1
+%patch -P0 -p1
+%patch -P1 -p1
+%patch -P2 -p1
+%patch -P3 -p1
+%patch -P4 -p1
+%patch -P5 -p1
 # Change configuration name
 find -type f -exec perl -i -pe 's/XCPANCONFIGNAMEX/cpan/g' {} \;
 # Remove bundled modules
@@ -336,6 +339,9 @@ make test
 %{_libexecdir}/%{name}
 
 %changelog
+* Mon Mar 03 2025 Jitka Plesnikova <jplesnik@redhat.com> - 2.29-5
+- Resolves: RHEL-77187 - Update man page
+
 * Thu Feb 13 2025 Jitka Plesnikova <jplesnik@redhat.com> - 2.29-4
 - Resolves: RHEL-77187
 - Fix permission for creating site directories