[ANNOUNCE] Apache::Clean

[Geoffrey Young <ge...@modperlcookbook.org>]

The URL

   http://www.modperlcookbook.org/download/Apache-Clean-0.03.tar.gz

has entered CPAN as

   file: $CPAN/authors/id/G/GE/GEOFF/Apache-Clean-0.03.tar.gz
   size: 3575 bytes
   md5: bb3c4e6132ac461e22f510e1974f81b9

This release gives access to more of the features of HTML::Clean, like
the ability to specify HTML::Clean options by name (such as
'shortertags').  It also is (I think) the only Apache:: module
currently on CPAN that uses the new Apache::Test harness from mod_perl
2.0, so it should be a good example for that as well.

I bunged up the README and internal docs (I forgot to mention the new
CleanOption variable), so if there are any other bugs taht jump out at
people I'll get them fixed asap...

--Geoff

README:

NAME 

Apache::Clean - mod_perl interface into HTML::Clean

SYNOPSIS

httpd.conf:

 <Location /clean>
    SetHandler perl-script
    PerlHandler Apache::Clean

    PerlSetVar  CleanLevel 3

    PerlSetVar  CleanOption shortertags
    PerlAddVar  CleanOption whitespace
 </Location>  

Apache::Clean is Filter aware, meaning that it can be used within
Apache::Filter framework without modification.  Just include the
directives

  PerlModule Apache::Filter
  PerlSetVar Filter On

and modify the PerlHandler directive accordingly...

DESCRIPTION

Apache::Clean uses HTML::Clean to tidy up large, messy HTML, saving
bandwidth.  It is particularly useful with Apache::Compress for 
ultimate savings.

The only current configuration directives are CleanLevel, which
defaults
to 3, and CleanOption, which has no default.  Apache::Clean will only 
tidy up whitespace (via $h->strip) and
will not perform other options of HTML::Clean (such as browser
compatibility).  See the HTML::Clean manpage for details.

Only documents with a content type of "text/html" are affected - all
others are passed through unaltered.

NOTES

Verbose debugging is enabled by setting $Apache::Clean::DEBUG=1
or greater.  To turn off all debug information, set your apache
LogLevel directive above info level.

This is alpha software, and as such has not been tested on multiple
platforms or environments.  It requires PERL_LOG_API=1, 
PERL_FILE_API=1, and maybe other hooks to function properly.

FEATURES/BUGS

  No known bugs or features at this time...

SEE ALSO

perl(1), mod_perl(3), Apache(3), HTML::Clean(3), Apache::Compress(3),
Apache::Filter(3)

AUTHORS

Geoffrey Young <ge...@modperlcookbook.org>
Paul Lindner <pa...@modperlcookbook.org>
Randy Kobes <ra...@modperlcookbook.org>

COPYRIGHT

Copyright (c) 2002, Geoffrey Young, Paul Lindner, Randy Kobes.  
All rights reserved.

This module is free software.  It may be used, redistributed
and/or modified under the same terms as Perl itself.

HISTORY

This code is derived from the Cookbook::Clean and
Cookbook::TestMe modules available as part of
"The mod_perl Developer's Cookbook".

For more information, visit http://www.modperlcookbook.org/