Return-Path: Delivered-To: apmail-perl-docs-dev-archive@www.apache.org Received: (qmail 97325 invoked from network); 10 Aug 2004 03:38:30 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 10 Aug 2004 03:38:30 -0000 Received: (qmail 90850 invoked by uid 500); 10 Aug 2004 03:38:30 -0000 Delivered-To: apmail-perl-docs-dev-archive@perl.apache.org Received: (qmail 90820 invoked by uid 500); 10 Aug 2004 03:38:30 -0000 Mailing-List: contact docs-dev-help@perl.apache.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: Delivered-To: mailing list docs-dev@perl.apache.org Received: (qmail 90807 invoked by uid 99); 10 Aug 2004 03:38:29 -0000 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Message-ID: <4118432C.9030303@stason.org> Date: Mon, 09 Aug 2004 20:38:20 -0700 From: Stas Bekman Organization: Hope, Humanized User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7) Gecko/20040708 X-Accept-Language: en-us, en, he, ru MIME-Version: 1.0 To: "Philippe M. Chiasson" , mod_perl docs-dev Subject: 4 pods are ready to go, philippe Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N cc'ing the list, in case someone will want to help philippe and/or have a go at the other remaining pod files. Philippe, I've prepared these 4 files for you: src/docs/2.0/api/Apache/CmdParms.pod src/docs/2.0/api/Apache/Command.pod src/docs/2.0/api/Apache/Directive.pod src/docs/2.0/api/Apache/Module.pod All the functions are inside, sorted and all is needed to is to fill in all possible ways to invoke those (consult the .xs and .h files to get the full picture), including optional arguments and their default values. and tests covering those things are needed. those tests can be turned into examples once working, at least that's how i did it, tests first, then the docs and examples. If you aren't sure about some of those start an unsupported API section (see for example src/docs/2.0/api/Apache/RequestRec.pod the end of) so the methods are there, but we don't commit to them. and if you add any to this section insert them into todo/api_status. finally I've left some comments for you in the API section, that deal with readwrite/readonly status of struct accessors. make sure that the docs reflect the reality, since at the moment they don't (the autogenerator didn't pick all forms). Thanks Philippe. p.s. besides these 4 files we need to start and finish these: src/docs/2.0/api/Apache.pod src/docs/2.0/api/Apache/Connection.pod src/docs/2.0/api/Apache/HookRun.pod src/docs/2.0/api/Apache/Log.pod src/docs/2.0/api/Apache/SubRequest.pod src/docs/2.0/api/Apache/URI.pod src/docs/2.0/api/Apache/Util.pod src/docs/2.0/api/ModPerl/Util.pod and a few others which aren't API (Registry and stuff). -- __________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:stas@stason.org http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com --------------------------------------------------------------------- To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org For additional commands, e-mail: docs-dev-help@perl.apache.org