this package contains an Apache-Test skeleton
that should help get you started creating a
self-contained environment so that other developers
can reproduce your bugs.

THIS PACKAGE IS FOR mod_perl 2.0 (1.99_XX) ONLY!
a mod_perl 1.0 package is available from 
http://perl.apache.org/~geoff/

here are the specifics...

t/cgi-bin is reachable via requests to /perl-bin 
using typical ModPerl::Registry settings.  you can
edit t/cgi-bin/bug.pl to your satisfaction.

t/My/Bug.pm is set under PerlResponseHandler using
the 'modperl' handler and is reachable via requests to
/bug.  you may want to change the handler to 'perl-script'
if you need mod_perl 1.0-type behavior.  edit Bug.pm
to your satisfaction.

t/conf/extra.conf.in is your configuration file, 
exactly the same as httpd.conf.  you can edit it
to your satisfaction.  if you are troubleshooting
XS files, you may need to exchange extra.conf.in
with extra.last.conf.in

t/conf/modperl_extra.pl is the same as your normal
startup.pl.  you can edit it to your satisfaction.

t/bug.t is the test script.  by default it makes one
request to each of /perl-bin/bug.pl and /bug.  you
can edit bug.t once you know what the output of your
tests should look like.

if you need more help with Apache-Test, take a look
at the docs:

  http://www.perl.com/pub/a/2003/05/22/testing.html
  http://perl.apache.org/docs/general/testing/testing.html

after all your edits are made, configure the tests via

  $ perl Makefile.PL -apxs /usr/local/apache2/bin/apxs

if your built mod_perl as a DSO, or

  $ perl Makefile.PL -httpd /usr/local/apache2/bin/httpd

if you built statically.

then, just run

  $ make
  $ make test TEST_VERBOSE=1

and you should be on your way.

once you get your test suite tweaked to where the bug
is reproducable via 'make test', edit the MANIFEST
and run

  $ make dist

to roll it up.  after that, be sure to untar it to
a different directory and test it again to make 
sure it is fully self-containted.

after all that, you can send mail to the mod_perl list
(modperl@perl.apache.org) , preferably
with a link to a place where the tarball can be found.
please do not attach the tarball.  thanks.

--Geoff
