Casey West

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.