File perl-Pod-Cpandoc.spec of Package perl-Pod-Cpandoc

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Pod-Cpandoc.spec of Package perl-Pod-Cpandoc

#
# spec file for package perl-Pod-Cpandoc
#
# Copyright (c) 2019 SUSE LINUX GmbH, Nuernberg, Germany.
#
# 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/
#

Name:           perl-Pod-Cpandoc
Version:        0.16
Release:        0
%define cpan_name Pod-Cpandoc
Summary:        Perldoc that works for modules you don't have installed
License:        Artistic-1.0 OR GPL-1.0-or-later
Group:          Development/Libraries/Perl
Url:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/S/SA/SARTAK/%{cpan_name}-%{version}.tar.gz
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
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
%{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
%setup -q -n %{cpan_name}-%{version}

%build
PERL_USE_UNSAFE_INC=1 perl Makefile.PL INSTALLDIRS=vendor
make %{?_smp_mflags}

%check
make test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc Changes README

%changelog

Places

File perl-Pod-Cpandoc.spec of Package perl-Pod-Cpandoc

Places