NAME
    Apache::RewritingProxy - proxy that works by rewriting requested
    documents with no client proxy config needed.

SYNOPSIS
    # Configuration in httpd.conf

            <Location /foo>
            SetHandler perl-script
            PerlHandler Apache::RewritingProxy
            Options ExecCGI
            PerlSendHeader On
            </Location>

    requests to /foo/http://domain.dom/ will return the resource
    located at http://domain.dom with all links pointing to
    /foo/http://otherlink.dom

DESCRIPTION
    This module allows proxying of web sites without any
    configuration changes on the client's part. The client is simply
    pointed to a URL using this module and it fetches the resource
    and rewrites all links to continue using this proxy.

    RewritingProxy can also now be subclassed to allow users to
    write different handlers for the text. See the eg for examples
    of this in action.

INSTALLATION
    perl Makefile.PL; make; make install;

REQUIREMENTS
    You need the following modules installed for this module to
    work:

      LWP::UserAgent
      HTML::TokeParser
      URI::URL
      Of course, mod_perl and Apache would also help greatly.
      Mod_Perl needs to have lots of hooks enabled.  Preferably ALL_HOOKS
      If not, the proxy will just give lots of server errors and not really
      do that much.  In particular, the Apache::Table and Apache::Util
      seem to be necessary for the module to run properly. 

TODO/BUGS
    Make cookies work better.

    Eat fewer cookies in real life.

    Add caching or incorporate some other caching mechanism.

SEE ALSO
    mod_perl(3), Apache(3), LWP::UserAgent(3)

AUTHOR
    Apache::RewritingProxy by Ken Hagan <ken.hagan@louisville.edu>

            Debugging, suggestions, and helpful comments courtesy of
            Mike Reiling <miker@softcoin.com>
            Steve Baker <steveb@web.co.nz>
            Tim DiLauro <timmo@jhu.edu>
            and a few other people foolish enough to download
            and run this thing.

COPYRIGHT
    The Apache::RewritingProxy module is free software; you can
    redistribute it and/or modify it under the same terms as Perl
    itself.