Files
perl-Pod-Cpandoc/perl-Pod-Cpandoc.spec
2025-08-12 18:16:35 +02:00

86 lines
2.9 KiB
RPMSpec

#
# spec file for package perl-Pod-Cpandoc
#
# Copyright (c) 2024 SUSE LLC
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.
# Please submit bugfixes or comments via https://bugs.opensuse.org/
#
%define cpan_name Pod-Cpandoc
Name: perl-Pod-Cpandoc
Version: 0.160.0
Release: 0
# 0.16 -> normalize -> 0.160.0
%define cpan_version 0.16
License: Artistic-1.0 OR GPL-1.0-or-later
Summary: Perldoc that works for modules you don't have installed
URL: https://metacpan.org/release/%{cpan_name}
Source0: https://cpan.metacpan.org/authors/id/S/SA/SARTAK/%{cpan_name}-%{cpan_version}.tar.gz
Source1: cpanspec.yml
Source100: README.md
BuildArch: noarch
BuildRequires: perl
BuildRequires: perl-macros
BuildRequires: perl(ExtUtils::MakeMaker) >= 6.59
BuildRequires: perl(HTTP::Tiny)
BuildRequires: perl(IO::Socket::SSL) >= 1.56
BuildRequires: perl(JSON::PP)
BuildRequires: perl(Net::SSLeay) >= 1.49
Requires: perl(HTTP::Tiny)
Requires: perl(IO::Socket::SSL) >= 1.56
Requires: perl(JSON::PP)
Requires: perl(Net::SSLeay) >= 1.49
Provides: perl(Pod::Cpandoc) = %{version}
%undefine __perllib_provides
%{perl_requires}
%description
'cpandoc' is a perl script that acts like 'perldoc' except that if it would
have bailed out with 'No documentation found for "Uninstalled::Module"', it
will instead scrape a CPAN index for the module's documentation.
One important feature of 'cpandoc' is that it _only_ scrapes the live index
if you do not have the module installed. So if you use 'cpandoc' on a
module you already have installed, then it will just read the
already-installed documentation. This means that the version of the
documentation matches up with the version of the code you have. As a fringe
benefit, 'cpandoc' will be fast for modules you've installed. :)
All this means that you should be able to drop in 'cpandoc' in place of
'perldoc' and have everything keep working. See SNEAKY INSTALL for how to
do this.
If you set the environment variable 'CPANDOC_FETCH' to a true value, then
we will print a message to STDERR telling you that 'cpandoc' is going to
make a request against the live CPAN index.
%prep
%autosetup -n %{cpan_name}-%{cpan_version}
%build
PERL_USE_UNSAFE_INC=1 perl Makefile.PL INSTALLDIRS=vendor
%make_build
%check
make test
%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist
%files -f %{name}.files
%doc Changes README
%changelog