On Tue, 2004-01-20 at 16:02, Boris Zentner wrote:
just to clarify it, I mean it like Perrin but not that stong, I have no problem to load a package to use it. My problem is to load package bar to fill methods for package foo.
When someone passes your handler a live $r object, you shouldn't have to load that module to use it, since the code that is passing you $r must have already loaded the class in order to make a $r object. On the other hand, if you need to actually call a method like Apache::RequestRec->foo() then you should explicitly load that class.
cool. now we have an agreement between Boris and Perrin ;)
I now more or less have an idea on how to solve the code usage problem.
What I don't have clear yet is the docs issue. Certainly you want to find the method of class Apache::RequestRec in its the right manpage (Apache::RequestRec). But $r has about 150 methods. Having them all in one page is very impractical. Just like you never do 'perldoc perlfunc', but 'perldoc -f function', you won't want to load an 1MB html page for Apache/RequestRec.pod. Currently the split on the code level also nicely groups the methods into several manpages by their categories, making it easier to per-use and comprehend.
So my idea was to list all Apache::RequestRec methods in the Apache::RequestRec manpage, but have the bodies of most of them spread across Apache::RequestIO, etc, just like it is now. That's if you use the web interface. It won't quite work for 'perldoc'.
So now that you know what the problem is, please tell us your ideas on how to approach that.
__________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]