#!/usr/bin/perl -w # # text-options.t -- Additional tests for Pod::Text options. # # Copyright 2002, 2004, 2006, 2008 by Russ Allbery # # This program is free software; you may redistribute it and/or modify it # under the same terms as Perl itself. BEGIN { chdir 't' if -d 't'; if ($ENV{PERL_CORE}) { @INC = '../lib'; } else { unshift (@INC, '../blib/lib'); } unshift (@INC, '../blib/lib'); $| = 1; print "1..13\n"; } END { print "not ok 1\n" unless $loaded; } use Pod::Text; # Redirect stderr to a file. sub stderr_save { open (OLDERR, '>&STDERR') or die "Can't dup STDERR: $!\n"; open (STDERR, '> out.err') or die "Can't redirect STDERR: $!\n"; } # Restore stderr. sub stderr_restore { close STDERR; open (STDERR, '>&OLDERR') or die "Can't dup STDERR: $!\n"; close OLDERR; } $loaded = 1; print "ok 1\n"; my $n = 2; while () { my %options; next until $_ eq "###\n"; while () { last if $_ eq "###\n"; my ($option, $value) = split; $options{$option} = $value; } open (TMP, '> tmp.pod') or die "Cannot create tmp.pod: $!\n"; while () { last if $_ eq "###\n"; print TMP $_; } close TMP; my $parser = Pod::Text->new (%options) or die "Cannot create parser\n"; open (OUT, '> out.tmp') or die "Cannot create out.tmp: $!\n"; stderr_save; $parser->parse_from_file ('tmp.pod', \*OUT); stderr_restore; close OUT; open (TMP, 'out.tmp') or die "Cannot open out.tmp: $!\n"; my $output; { local $/; $output = ; } close TMP; 1 while unlink ('tmp.pod', 'out.tmp'); my $expected = ''; while () { last if $_ eq "###\n"; $expected .= $_; } if ($output eq $expected) { print "ok $n\n"; } else { print "not ok $n\n"; print "Expected\n========\n$expected\nOutput\n======\n$output\n"; } $n++; open (ERR, 'out.err') or die "Cannot open out.err: $!\n"; my $errors; { local $/; $errors = ; } close ERR; unlink ('out.err'); $expected = ''; while () { last if $_ eq "###\n"; $expected .= $_; } if ($errors eq $expected) { print "ok $n\n"; } else { print "not ok $n\n"; print "Expected errors:\n ${expected}Errors:\n $errors"; } $n++; } # Below the marker are bits of POD and corresponding expected text output. # This is used to test specific features or problems with Pod::Text. The # input and output are separated by lines containing only ###. __DATA__ ### alt 1 ### =head1 SAMPLE =over 4 =item F Paragraph. =item Bar =item B Paragraph. =item Longer Paragraph. =back ### ==== SAMPLE ==== : F Paragraph. : Bar : B Paragraph. : Longer Paragraph. ### ### ### margin 4 ### =head1 SAMPLE This is some body text that is long enough to be a paragraph that wraps, thereby testing margins with wrapped paragraphs. This is some verbatim text. =over 6 =item Test This is a test of an indented paragraph. This is another indented paragraph. =back ### SAMPLE This is some body text that is long enough to be a paragraph that wraps, thereby testing margins with wrapped paragraphs. This is some verbatim text. Test This is a test of an indented paragraph. This is another indented paragraph. ### ### ### code 1 ### This is some random text. This is more random text. This is some random text. This is more random text. =head1 SAMPLE This is POD. =cut This is more random text. ### This is some random text. This is more random text. This is some random text. This is more random text. SAMPLE This is POD. This is more random text. ### ### ### sentence 1 ### =head1 EXAMPLE Whitespace around C<< this. >> must be ignored per perlpodspec. >> needs to eat all of the space in front of it. =cut ### EXAMPLE Whitespace around "this." must be ignored per perlpodspec. >> needs to eat all of the space in front of it. ### ### ### ### =over 4 =item Foo Bar. =head1 NEXT ### Foo Bar. NEXT POD ERRORS Hey! The above document had some coding errors, which are explained below: Around line 7: You forgot a '=back' before '=head1' ### ### ### stderr 1 ### =over 4 =item Foo Bar. =head1 NEXT ### Foo Bar. NEXT ### tmp.pod around line 7: You forgot a '=back' before '=head1' ###