#
# spec file for package perl-Pod-Xhtml
#
# 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-Xhtml
Name:           perl-Pod-Xhtml
Version:        1.610.0
Release:        0
# 1.61 -> normalize -> 1.610.0
%define cpan_version 1.61
#Upstream:  (c) BBC 2004, 2005. This program is free software; you can redistribute it and/or modify it under the GNU GPL. See the file COPYING in this distribution, or http://www.gnu.org/licenses/gpl.txt
License:        GPL-2.0-only
Summary:        Generate well-formed XHTML documents from POD format documentation
URL:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/B/BB/BBC/%{cpan_name}-%{cpan_version}.tar.gz
Source1:        cpanspec.yml
Source100:      README.md
BuildArch:      noarch
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Pod::ParseUtils)
BuildRequires:  perl(Pod::Parser)
BuildRequires:  perl(Test::Assertions::TestScript)
BuildRequires:  perl(URI::Escape)
Requires:       perl(Pod::ParseUtils)
Requires:       perl(Pod::Parser)
Requires:       perl(Test::Assertions::TestScript)
Requires:       perl(URI::Escape)
Provides:       perl(Pod::Hyperlink::BounceURL) = 1.700.0
Provides:       perl(Pod::Xhtml)
%undefine       __perllib_provides
%{perl_requires}

%description
* new Pod::Xhtml( [ OPTIONS ] )

Create a new object. Optionally pass in some options in the form ''new
Pod::Xhtml( StringMode => 1);''

* $parser->parse_from_file( INPUTFILE, [OUTPUTFILE] )

Read POD from the input file, output to the output file (or STDOUT if no
file is given). See Pod::Parser docs for more. Note that you can parse
multiple files with the same object. All your options will be preserved, as
will any text you added with the add*Text methods.

* $parser->parse_from_filehandle( [INPUTFILEHANDLE, [OUTPUTFILEHANDLE]] )

Read POD from the input filehandle, output to the output filehandle
(STDIN/STDOUT if no filehandle(s) given). See Pod::Parser docs for more.
Note that you can parse multiple files with the same object. All your
options will be preserved, as will any text you added with the add*Text
methods.

* $parser->asString

Get the XHTML as a scalar. You'll probably want to use this with the
StringMode option.

* $parser->asStringRef

As above, but you get a reference to the string, not the string itself.

* $parser->addHeadText( $text )

Inserts some text just before the closing head tag. For example you can add
a link to a stylesheet. May be called many times to add lots of text. Note:
you need to call this some time *before* any output is done, e.g. straight
after new(). Make sure that you only insert valid XHTML fragments.

* $parser->addBodyOpenText( $text ) / $parser->addBodyCloseText( $text )

Inserts some text right at the beginning (or ending) of the body element.
For example you can add a navigation header and footer. May be called many
times to add lots of text. Note: you need to call this some time *before*
any output is done, e.g. straight after new(). Make sure that you only
insert valid XHTML fragments.

%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
%license COPYING

%changelog