On Mar 24, 2004, at 11:39 AM, Stas Bekman wrote:
David, as usual you are more than welcome to submit a patch that explains things. That'd be the Apache::TestMM manpage.
Here you go. My mailer will likely screw up the line endings, so I've also attached it so that you'll get it, Stas.
--- TestMM.pm.~1.31.~ Tue Mar 16 12:34:31 2004 +++ TestMM.pm Thu Mar 25 09:28:38 2004 @@ -122,13 +122,13 @@ =head1 SYNOPSIS
require Apache::TestMM;
-
+
# import MY::test and MY::clean overrides for MM
Apache::TestMM->import(qw(test clean));
-
+
# parse command line args
Apache::TestMM::filter_args();
-
+
# autogenerate the script
Apache::TestMM::generate_script('t/TEST');@@ -203,5 +203,140 @@
C<L<filter_args()|/C_filter_args_>> called from F<Makefile.PL>, special
fixup code, etc. If no argument is passed to C<generate_script()>,
it will create a file named F<t/TEST> by default.
+
+=head1 OPTIONS
+
+The F<filter_args()> function supports a large number of command-line options
+being passed to F<Makefile.PL>. You may wish to document some of these in your
+F<README> file, especially F<-apxs> and F<-httpd>. The command-line options
+are:
+
+=over 4
+
+=item -access_module_name
+
+access module name
+
+=item -apxs
+
+location of apxs (default is from C<Apache::BuildConfig>)
+
+=item -auth_module_name
+
+auth module name
+
+=item -bindir
+
+Apache F<bin/> dir (default is C<apxs -q BINDIR>)
+
+=item -cgi_module_name
+
+cgi module name
+
+=item -defines
+
+values to add as C<-D> defines (for example, C<VAR1 VAR2>)
+
+=item -documentroot
+
+DocumentRoot (default is F<$ServerRoot/htdocs>
+
+=item -group
+
+Group to run test server as (default is C<$GROUP>)
+
+=item -httpd
+
+server to use for testing (default is F<$bindir/httpd>)
+
+=item -httpd_conf
+
+inherit config from this file (default is apxs derived)
+
+=item -libmodperl
+
+path to mod_perl's F<.so> (full or relative to C<LIBEXECDIR>)
+
+=item -maxclients
+
+maximum number of concurrent clients (default is 1)
+
+=item -perlpod
+
+location of perl pod documents (for testing downloads)
+
+=item -port
+
+Port [port_number|select] (default 8529)
+
+=item -proxyssl_url
+
+url for testing ProxyPass / https (default is localhost)
+
+=item -sbindir
+
+Apache F<sbin/> dir (default is C<apxs -q SBINDIR>)
+
+=item -servername
+
+ServerName (default is localhost)
+
+=item -serverroot
+
+ServerRoot (default is C<$t_dir>)
+
+=item -src_dir
+
+source directory to look for F<mod_foos.so>
+
+=item -ssl_module_name
+
+ssl module name
+
+=item -sslca
+
+location of SSL CA (default is F<$t_conf/ssl/ca>)
+
+=item -sslcaorg
+
+SSL CA organization to use for tests (default is asf)
+
+=item -startup_timeout
+
+seconds to wait for the server to start (default is 60)
+
+=item -t_conf
+
+the F<conf/> test directory (default is F<$t_dir/conf>)
+
+=item -t_conf_file
+
+test F<httpd.conf> file (default is F<$t_conf/httpd.conf>)
+
+=item -t_dir
+
+the F<t/> test directory (default is F<$top_dir/t>)
+
+=item -t_logs
+
+the F<logs/> test directory (default is $F<t_dir/logs>)
+
+=item -target
+
+name of server binary (default is C<apxs -q TARGET>)
+
+=item -thread_module_name
+
+thread module name
+
+=item -top_dir
+
+top-level directory (default is C<$PWD>)
+
+=item -user
+
+User to run test server as (default is C<$USER>)
+
+=back
=cut
Regards,
David
