#
# spec file for package perl-Pod-Simple
#
# Copyright (c) 2025 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-Simple
Name:           perl-Pod-Simple
Version:        3.47
Release:        0
License:        Artistic-1.0 OR GPL-1.0-or-later
Summary:        Framework for parsing Pod
URL:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/K/KH/KHW/%{cpan_name}-%{version}.tar.gz
Source1:        cpanspec.yml
Source100:      README.md
BuildArch:      noarch
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Pod::Escapes) >= 1.04
BuildRequires:  perl(Test::More) >= 0.88
Requires:       perl(Pod::Escapes) >= 1.04
Recommends:     perl(Encode) >= 2.78
%{perl_requires}

%description
Pod::Simple is a Perl library for parsing text in the Pod ("plain old
documentation") markup language that is typically used for writing
documentation for Perl and for Perl modules. The Pod format is explained in
perlpod; the most common formatter is called 'perldoc'.

Be sure to read ENCODING if your Pod contains non-ASCII characters.

Pod formatters can use Pod::Simple to parse Pod documents and render them
into plain text, HTML, or any number of other formats. Typically, such
formatters will be subclasses of Pod::Simple, and so they will inherit its
methods, like 'parse_file'. But note that Pod::Simple doesn't understand
and properly parse Perl itself, so if you have a file which contains a Perl
program that has a multi-line quoted string which has lines that look like
pod, Pod::Simple will treat them as pod. This can be avoided if the file
makes these into indented here documents instead.

If you're reading this document just because you have a Pod-processing
subclass that you want to use, this document (plus the documentation for
the subclass) is probably all you need to read.

If you're reading this document because you want to write a formatter
subclass, continue reading it and then read Pod::Simple::Subclassing, and
then possibly even read perlpodspec (some of which is for parser-writers,
but much of which is notes to formatter-writers).

%prep
%autosetup  -n %{cpan_name}-%{version} -p1

%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 ChangeLog README

%changelog