Hi! I'm in the process of writing the documentation for my first module
I feel worthy to be uploaded to CPAN. This module is tentatively named
Apache::Request::I18N, and it also defines Apache::Upload::I18N (the
same way that Apache::Request defines Apache::Upload). I'd like to know
if any of you object to the name, or have a better suggestion, before I
upload it.
Here's the first part of the documentation, to let you know what this is
all about:
=head1 NAME
Apache::Request::I18N - Internationalization extension to Apache::Request
=head1 SYNOPSIS
use Apache::Request::I18N;
my $apr = Apache::Request::I18N->new($r, DECODE_PARMS => 'utf-8');
Or, add something like this to your Apache F<httpd.conf>:
PerlModule Apache::Request::I18N;
<Location ...>
SetHandler perl-script
PerlHandler Apache::Request::I18N <your other handlers ...>
PerlSetVar DecodeParms utf-8
</Location>
=head1 DESCRIPTION
I<Apache::Request::I18N> adds transparent support over I<Apache::Request> for
internationalized GET/POST parameters. Parameter names and values are
automatically decoded and converted either to Perl's internal UTF-8 format, or
to another character encoding.
Since this module inherits from I<Apache::Request>, it can be used as a
drop-in replacement. (It is not a B<perfect> replacement, though; see below
for exceptions.) It can also be used in a I<PerlHandler> directive, in which
case all subsequent handlers will -- if they play nicely -- automatically see
the converted values.
=cut
--
Frédéric Brière <*> [EMAIL PROTECTED]
=> <[EMAIL PROTECTED]> IS NO MORE: <http://www.abacomsucks.com> <=
