>> the only thing I find strange is arg1, which is always the object. >> while -> >> makes $self the first argument to the send() subroutine in the strict >> perl >> sense, from the user standpoint the first argument to the send() >> method is >> really $buf. > > > Well, the object is really the first argument, since: > > $socket->recv($len); > > is really: > > APR::Socket::recv($socket, $len);
yes, that's what I was saying :) my point was, though, that I would expect that given $socket->recv($len) users would colloquially say that $len is the first argument and not the second. > > Besides, notice that the actual variable name is listed in the item and > even the fact that it's an object, so it says: > > * arg1: $socket (APR::Socket object) > * arg2: $len (number) yeah, that's what I found confusing. well, not confusing to me personally, of course, but potentially confusing for users. > > e.g. we could say: > > * obj: $socket > * arg1: $len that might be better. > but once we do that someone might just as well argue that it's confusing > to have $len denoted as arg1. I suppose, but only if they wanted to cause trouble :) > > Either way is fine, as long as we keep things consistent. yeah, I feel the same way. no biggie to me to keep it like it is, especially since you're doing all the work :) --Geoff --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
