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 |
#!/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 |
#!/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.