#
# spec file for package perl-POD2-Base
#
# 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 POD2-Base
Name:           perl-POD2-Base
Version:        0.43.0
Release:        0
# 0.043 -> normalize -> 0.43.0
%define cpan_version 0.043
License:        Artistic-1.0 OR GPL-1.0-or-later
Summary:        Base module for translations of Perl documentation
URL:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/F/FE/FERREIRA/%{cpan_name}-%{cpan_version}.tar.gz
Source100:      README.md
BuildArch:      noarch
BuildRequires:  perl
BuildRequires:  perl-macros
Provides:       perl(POD2::Base) = %{version}
%undefine       __perllib_provides
Recommends:     perl(ExtUtils::MakeMaker) >= 6.38
Recommends:     perl(Test::Pod) >= 1.18
Recommends:     perl(Test::Pod::Coverage) >= 1.04
%{perl_requires}

%description
This module is an abstraction of the code in POD2::IT and POD2::FR. These
modules belong to the Italian and the French translation projects of core
Perl pods.

Once a translation package had been installed, the translated documentation
can be accessed with:

    $ perldoc POD2::<lang>::<podname>

(where <lang> is a language abbreviation like IT, FR, TLH, etc.)

This is guaranteed to work even for older versions of perldoc. It is not
very convenient but always works.

To improve the support to read translated docs, the perldoc utility (since
version 3.14_01) was updated to find translated PODs via:

    $ perldoc -L IT <podpage>
    $ perldoc -L FR -f <function>
    $ perldoc -L TH -q <FAQregex>

(_Note_: this support was shipped together with the recently released
5.10.0 version the Perl interpreter.)

The objective of this class is to provide a minimum base to help 'perldoc'
and authors of translation packages to do their job.

%prep
%autosetup  -n %{cpan_name}-%{cpan_version}

%build
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