# ... some code here ...

=for comment

... comments ...

=cut

# ... some more code here ...

##</code><code>##

$ podchecker podchecker_test_4.txt
*** ERROR: Apparent command =head2 not preceded by blank line at line 7 in file podchecker_test_4.txt
podchecker_test_4.txt has 1 pod syntax error.

##</code><code>##

$ cat podchecker_test_4.txt
#!/usr/bin/env perl

use strict;
use warnings;

=head1 heading 1
=head2 heading 1.2


##</code><code>##

$ podchecker podchecker_test_5.txt 
*** ERROR: =over on line 6 without closing =back at line EOF in file podchecker_test_5.txt
podchecker_test_5.txt has 1 pod syntax error.

##</code><code>##

cat podchecker_test_5.txt
#!/usr/bin/env perl

use strict;
use warnings;

=over 4

whatever


##</code><code>##

$ podchecker podchecker_test_1.txt
podchecker_test_1.txt does not contain any pod commands.

##</code><code>##

cat podchecker_test_1.txt
#!/opt/apps/perl/perl5220/bin/perl

use strict;
use warnings;

print "Line1\n";

print "Line2\n";
=cut
print "Line3\n";
=cut
print "Line4\n";
=cut
print "Line5\n";
=cut
print "Line6\n";

##</code><code>##

$ podchecker podchecker_test_2.txt
*** ERROR: Spurious =cut command at line 9 in file podchecker_test_2.txt
*** ERROR: Spurious =cut command at line 13 in file podchecker_test_2.txt
*** ERROR: Spurious =cut command at line 17 in file podchecker_test_2.txt
*** ERROR: Spurious =cut command at line 21 in file podchecker_test_2.txt
podchecker_test_2.txt has 4 pod syntax errors.

##</code><code>##

cat podchecker_test_2.txt
#!/usr/bin/env perl

use strict;
use warnings;

print "Line1\n";
print "Line2\n";

=cut

print "Line3\n";

=cut

print "Line4\n";

=cut

print "Line5\n";

=cut

print "Line6\n";

##</code><code>##

$ podchecker podchecker_test_3.txt
podchecker_test_3.txt pod syntax OK.

##</code><code>##

cat podchecker_test_3.txt
#!/usr/bin/env perl

use strict;
use warnings;

print "Line1\n";
print "Line2\n";

=for comment

print "Line3\n";

=cut

print "Line4\n";

=for comment

print "Line5\n";

=cut

print "Line6\n";

##</code><code>##

=cut

=cut The documentation ends here.

...