/usr/local/perl/lib/site_perl/5.8.5/Perl/Critic/Policy/Documentation/RequirePodAtEnd.pm



NAME

Perl::Critic::Policy::Documentation::RequirePodAtEnd


DESCRIPTION

Perl stops processing code when it sees an __END__ statement. So, to save processing time, it's faster to put documentation after the __END__. Also, writing all the POD in one place usually leads to a more cohesive document, rather than being forced to follow the layout of your code. This policy issues violations if any POD is found before an __END__.


NOTES

Some folks like to use =for, and =begin, and =end tags to create block comments in-line with their code. Since those tags aren't usually part of the documentation, this Policy does allows them to appear before the __END__ statement.

  =begin comments
  frobulate()
  Accepts:  A list of things to frobulate
  Returns:  True if succesful
  =end comments
  sub frobulate { ... }


AUTHOR

Chris Dolan <cdolan@cpan.org>


COPYRIGHT

Copyright (c) 2006 Chris Dolan. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The full text of this license can be found in the LICENSE file included with this module

 /usr/local/perl/lib/site_perl/5.8.5/Perl/Critic/Policy/Documentation/RequirePodAtEnd.pm