Return-Path: Delivered-To: apmail-httpd-test-dev-archive@httpd.apache.org Received: (qmail 17886 invoked by uid 500); 18 Jul 2003 17:30:51 -0000 Mailing-List: contact test-dev-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: test-dev@httpd.apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list test-dev@httpd.apache.org Received: (qmail 17865 invoked from network); 18 Jul 2003 17:30:50 -0000 Date: Fri, 18 Jul 2003 10:30:59 -0700 Subject: Re: Apache::TestRequest Doc Patch Content-Type: multipart/mixed; boundary=Apple-Mail-7-785364297 Mime-Version: 1.0 (Apple Message framework v552) Cc: test-dev@httpd.apache.org To: Stas Bekman From: David Wheeler In-Reply-To: <4E1F3CCA-B92B-11D7-AEE1-0003931A964A@kineticode.com> Message-Id: <987463D2-B945-11D7-AEE1-0003931A964A@kineticode.com> X-Mailer: Apple Mail (2.552) X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N --Apple-Mail-7-785364297 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII; format=flowed On Friday, July 18, 2003, at 07:22 AM, David Wheeler wrote: >> Done. They will probably require more polishing... > > Cool, thanks, I'll take a look in a bit. I applied just a bit of polishing. Note that POD has an F<> tag that's used for identifying files. This is better than using I<>, which means italic, of course. Regards, David -- David Wheeler AIM: dwTheory david@kineticode.com ICQ: 15726394 http://kineticode.com/ Yahoo!: dew7e Jabber: Theory@jabber.org Kineticode. Setting knowledge in motion.[sm] --Apple-Mail-7-785364297 Content-Disposition: attachment; filename=TestMM.patch Content-Transfer-Encoding: 7bit Content-Type: application/octet-stream; x-unix-mode=0644; name="TestMM.patch" --- lib/Apache/TestMM.pm.~1.28.~ Fri Jul 18 10:18:18 2003 +++ lib/Apache/TestMM.pm Fri Jul 18 10:27:14 2003 @@ -108,21 +108,21 @@ =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'); =head1 DESCRIPTION C provides wrappers for the C -craft, making it easier to extend the autogenerated I with -the C +craft, making it easier to extend the autogenerated F with +C. =head1 FUNCTIONS @@ -134,13 +134,15 @@ Apache::TestMM->import(qw(test clean)); -imports C overrides for the default C +Imports C overrides for the default C I and I targets, as if you have defined: sub MY::test {...} sub MY::clean {...} -in I. C does this for you. +in F. C does this for you so that these make +targets will run the Apache server and the tests for it, and clean up after +its mess. =head2 C @@ -148,19 +150,18 @@ Apache::TestMM::filter_args(); WriteMakefile(...); -As you know when C is called it parses C<@ARGV> -hoping to find special options like C. On the -other hand C accepts a lot of options of its own. When -C is called, it removes any -C specific options from C<@ARGV> and stores them -internally, so when C is called they aren't in -C. +When C is called it parses C<@ARGV>, hoping to find special +options like C. C accepts a lot of +options of its own. When C is called, it +removes any C-specific options from C<@ARGV> and stores them +internally, so when C is called they aren't in C<@ARGV> and +thus won't be processed by C. -The options can be set when I is called: +The options can be set when F is called: % perl Makefile.PL -apxs /path/to/apxs -or you can push them manually to C<@ARGV> from the code: +Or you can push them manually to C<@ARGV> from the code: push @ARGV, '-apxs', $apxs_path; @@ -168,9 +169,9 @@ Apache::TestMM::generate_script('t/TEST'); -is called, C specific options which were extracted by +is called, C-specific options extracted by C are written to the autogenerated -file. In our example the autogenerated I will include: +file. In our example, the autogenerated F will include: %Apache::TestConfig::Argv = qw(apxs /path/to/apxs); @@ -181,11 +182,12 @@ Apache::TestMM::generate_script('t/TEST'); C accepts the name of the script to generate and -will look for a template with the same name and suffix I<.PL>. So in -our example it'll look for I. The autogenerated script -I will include the contents of I, and special +will look for a template with the same name and suffix F<.PL>. So in +our example it'll look for F. The autogenerated script +F will include the contents of F, and special directives, including any configuration options passed via -C> called from I, special -fixup code, etc. +C> called from F, special +fixup code, etc. If no argument is passed to C, +it will create a file named F by default. =cut --Apple-Mail-7-785364297--