NAME

Pod::Webserver::Source - Plugin to Pod::Webserver for Viewing Source Code

SYNOPSIS

      use Pod::Webserver;
      use Pod::Webserver::Source; # Add this line to 'podwebserver' CLI.
      Pod::Webserver::httpd();

DESCRIPTION

This software adds source code viewing support to "Pod::Webserver". Optional "Perl::Tidy" support is included. If "Perl::Tidy" has been installed, the source code will be formatted using the following "Perl::Tidy" arguments: "-html -npod -nnn". You may override these arguments by resetting the package variable $Pod::Webserver::Source::PERLTIDY_ARGV to a list reference or string containing your personal preferences. Your ~/.perltidyrc file will be honored in the same way "Perl::Tidy" would honor it. If "Perl::Tidy" is not installed source code will be formatted in plain text and prefixed with line numbers.

Viewing the source of a module is simple, just click on the link in the header next to the back link called Source.

Due to the nature of this code it is imperitive that "Pod::Webserver::Source" be loaded after "Pod::Webserver" as demonstrated in the SYNOPSIS.

MODIFY podwebserver

Here's a Perl-ish way to modify podwebserver as I know it, distributed with version 3.02 of "Pod::Webserver".

      perl -pi -e'eof and
        $_ .= "use Pod::Webserver::Source;\n"' `which podwebserver`

SEE ALSO

Pod::Webserver, "Perl::Tidy", perl.

THANKS

Much of this code was ripped from various pieces written by Sean Burke who did all the hard work. I merely mutilated his code to produce this functionality.

AUTHOR

Casey West, <casey@geeknest.com>.

COPYRIGHT

      Copyright (c) 2005 Casey West.  All rights reserved.
      This module is free software; you can redistribute it and/or modify it
      under the same terms as Perl itself.