Michael,
I decided to make a patch to the POD to help me remember what I had to
change to get my code working under the Apache::* modules. I'm not that
good with POD formatting so please edit if you know a better way to
display this info. Let me know if you think this info belongs in a
separate doc (e.g., C::A::P::Apache::Tutorial).
Thanks,
William
--- CGI-Application-Plugin-Apache.pm.orig 2004-11-13 18:06:27.000000000 -0500
+++ Apache.pm 2004-11-13 18:15:42.000000000 -0500
@@ -395,6 +395,16 @@
But it's really up to you.
+=head1 UNSUPPORTED CGI::Application METHODS
+
+The following CGI::Application methods are not currently supported due to dependence on methods in CGI.pm which are not supported by Apache::Request.
+
+=over
+
+=item dump_html
+
+=back
+
=head1 COMPATIBILITY
Upon using this module you completely leave behind the world of L<CGI.pm|CGI>. Don't look back or
@@ -433,6 +443,20 @@
If for some reason you are using this plugin in a non-mod_perl environment, it will try to
do the right thing by simply doing nothing :)
+=head1 MIGRATING TO APACHE::* MODULES
+
+If you are used to CGI.pm, migrating to the Apache::* modules will entail a few changes. The following is a list of changes you will need to make (see COMPATIBILITY if you want to support both CGI.pm and Apache::*):
+
+=over
+
+=item $q->url ==> $q->uri (see Apache::URI)
+
+=item $q->delete('rm'); ==> $q->parms->unset('rm');
+
+=item $q->delete ==> $q->parms->clear();
+
+=back
+
=head1 AUTHOR
Michael Peters <mpeters@plusthree.com>
