On Mon, Feb 23, 2004 at 04:54:02PM -0500, sungo wrote: > > so the question is: newbies seem to not understand $_[KERNEL] and > friends. what to do about it? > > my answer is this: POE::Sweeten::Args, written by Casey West, > specifically to alleviate this problem. Let's document it in the core > (Don't like this argument style? POE::Sweeten::Args offers two other > varieties.). If it really becomes must, lets talk to casey about > pulling it into the core with a name like POE::Arguments. > > basically, i think this is a solved problem and we just need to add more > docs about the possibilities. the key here is to add more possibilities > not remove old ones.
I agree that the documentation should point to POE::Sugar::Args, POE::Session::MessageBased, and whatever @_ alternatives are out there. If it goes into the core, though, we're stuck with it forever. We should make sure it's a good and lasting solution. Another idea to throw into the mix: While documenting different calling conventions, it might be good to describe how to subclass or replace POE::Session. POE::Session's generic interface would get documented, and the interaction between POE::Kernel and POE::Session outlined. The perldoc for POE::Loop has the sort of documentation I'm thinking of here. -- Rocco Caputo - [EMAIL PROTECTED] - http://poe.perl.org/