Skip Menu |
 

This queue is for tickets about the PodSimplify CPAN distribution.

Report information
The Basics
Id: 69092
Status: new
Priority: 0/
Queue: PodSimplify

People
Owner: Nobody in particular
Requestors: ACRUSSELL [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: Important
Broken in: (no value)
Fixed in: (no value)



I was experimenting with the module Lip::Pod and came across what I consider some unexpected Pod::Html behavior. In the attached file lip_sample.pl I have an =begin block. Here I specify =begin lip. Now, since lip2pod just re-organizes pod what is within that block is itself valid pod. That is, =begin lip =head1 NAME hello - LIP example =head1 IMPLEMENTATION Print a friendly message to standard output. =end lip Now, my expectation is that pod2html would leave the pod inside the =begin lip block completely alone. However, it does not. If I run pod2html on lip_sample.pl I see that the pod inside the =begin lip block is translated by pod2html instead of just leaving it alone. Is this a problem with Pod::Html in that it does not correctly ignore pod inside begin blocks which it should be ignoring? In fact, as another example, I changed =begin lip to =begin latex and see the same behavior. Surely, Pod::html should just ignore whatever is inside these blocks, right? Is this a bug in Pod::html or is there a simple explanation? Some error in my examples? Best Regards, Adam
Subject: lip_sample.pl
Download lip_sample.pl
text/x-perl 372b
#!/usr/bin/perl -w use strict; =begin lip =head1 NAME hello - LIP example =head1 IMPLEMENTATION Print a friendly message to standard output. =end lip =cut print "Hello, world!\n"; exit 0; __END__ =head1 NAME hello - LIP example =head1 SYNOPSIS hello =head1 DESCRIPTION A simple example used to demonstrate the use of B<Lip::Pod> and B<lip2pod>. =cut
Subject: lip_sample.html
hello - LIP example


NAME

hello - LIP example


SYNOPSIS

 hello


DESCRIPTION

A simple example used to demonstrate the use of Lip::Pod and lip2pod.

Subject: tex_sample.pl
Download tex_sample.pl
text/x-perl 412b
#!/usr/bin/perl -w use strict; =begin latex =head1 NAME hello - LIP example =head1 IMPLEMENTATION Print a friendly message to standard output. =end latex =cut print "Hello, world!\n"; exit 0; __END__ =head1 NAME hello - LIP example =head1 SYNOPSIS hello =head1 DESCRIPTION A simple example used to demonstrate the use of B<Lip::Pod> and B<lip2pod>. =cut
Subject: tex_sample.html
hello - LIP example


NAME

hello - LIP example


SYNOPSIS

 hello


DESCRIPTION

A simple example used to demonstrate the use of Lip::Pod and lip2pod.



This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

Please report any issues with rt.cpan.org to rt-cpan-admin@bestpractical.com.