Canvas's find returns a hash ref in scalar context ...

This is a behavior changes (may be related to Change 2850) which is
not documented in Canvas.pod (in Tk-804.027).

Here's a patch for the doc:

diff -Naur Tk-804.027.old/pod/Canvas.pod Tk-804.027/pod/Canvas.pod
--- Tk-804.027.old/pod/Canvas.pod	2004-02-28 17:19:37.000000000 +0100
+++ Tk-804.027/pod/Canvas.pod	2004-10-14 14:19:24.000000000 +0200
@@ -599,9 +599,9 @@

=item I<$canvas>-E<gt>B<find>(I<searchCommand, >?I<arg, arg, ...>?)

-This method returns a list consisting of all the items that
+In array context, this method returns a list consisting of all the items th
at
meet the constraints specified by I<searchCommand> and
-I<arg>'s.
+I<arg>'s. In scalar context, this method returns the same informations in a
n array ref.
I<SearchCommand> and I<args> have any of the forms
accepted by the B<addtag> method.
The items are returned in stacking order, with the lowest item first.


Cheers

--
Dominique Dumont
"Delivering successful solutions requires giving people what they
need, not what they want." Kurt Bittner
-++**==--++**==--++**==--++**==--++**==--++**==--++**==
This message was posted through the Stanford campus mailing list
server.  If you wish to unsubscribe from this mailing list, send the
message body of "unsubscribe ptk" to majordomo@lists.stanford.edu

Dominique Dumont <domi@komarr.grenoble.hp.com> writes:
>This is a behavior changes (may be related to Change 2850) which is
>not documented in Canvas.pod (in Tk-804.027).

Thanks for the patch.
This wasn't a deliberate change, but a side effect of cleaning up
the coreTk/perl glue code.


>
>Here's a patch for the doc:
>
>diff -Naur Tk-804.027.old/pod/Canvas.pod Tk-804.027/pod/Canvas.pod
>--- Tk-804.027.old/pod/Canvas.pod	2004-02-28 17:19:37.000000000 +0100
>+++ Tk-804.027/pod/Canvas.pod	2004-10-14 14:19:24.000000000 +0200
>@@ -599,9 +599,9 @@
>
> =item I<$canvas>-E<gt>B<find>(I<searchCommand, >?I<arg, arg, ...>?)
>
>-This method returns a list consisting of all the items that
>+In array context, this method returns a list consisting of all the items t
hat
> meet the constraints specified by I<searchCommand> and
>-I<arg>'s.
>+I<arg>'s. In scalar context, this method returns the same informations in 
an array ref.
> I<SearchCommand> and I<args> have any of the forms
> accepted by the B<addtag> method.
> The items are returned in stacking order, with the lowest item first.
>
>
>Cheers


-++**==--++**==--++**==--++**==--++**==--++**==--++**==
This message was posted through the Stanford campus mailing list
server.  If you wish to unsubscribe from this mailing list, send the
message body of "unsubscribe ptk" to majordomo@lists.stanford.edu

Nick Ing-Simmons <nick@ing-simmons.net> writes:

> Thanks for the patch.  This wasn't a deliberate change, but a side
> effect of cleaning up the coreTk/perl glue code.

No problem. Cleaning up is always good... Eventually. ;-)

Cheers

--
Dominique Dumont
"Delivering successful solutions requires giving people what they
need, not what they want." Kurt Bittner
-++**==--++**==--++**==--++**==--++**==--++**==--++**==
This message was posted through the Stanford campus mailing list
server.  If you wish to unsubscribe from this mailing list, send the
message body of "unsubscribe ptk" to majordomo@lists.stanford.edu

Dominique Dumont <domi@komarr.grenoble.hp.com> writes:
>This is a behavior changes (may be related to Change 2850) which is
>not documented in Canvas.pod (in Tk-804.027).
>
>Here's a patch for the doc:

Applied.

>
>diff -Naur Tk-804.027.old/pod/Canvas.pod Tk-804.027/pod/Canvas.pod
>--- Tk-804.027.old/pod/Canvas.pod	2004-02-28 17:19:37.000000000 +0100
>+++ Tk-804.027/pod/Canvas.pod	2004-10-14 14:19:24.000000000 +0200
>@@ -599,9 +599,9 @@
>
> =item I<$canvas>-E<gt>B<find>(I<searchCommand, >?I<arg, arg, ...>?)
>
>-This method returns a list consisting of all the items that
>+In array context, this method returns a list consisting of all the items t
hat
> meet the constraints specified by I<searchCommand> and
>-I<arg>'s.
>+I<arg>'s. In scalar context, this method returns the same informations in 
an array ref.
> I<SearchCommand> and I<args> have any of the forms
> accepted by the B<addtag> method.
> The items are returned in stacking order, with the lowest item first.
>
>
>Cheers


-++**==--++**==--++**==--++**==--++**==--++**==--++**==
This message was posted through the Stanford campus mailing list
server.  If you wish to unsubscribe from this mailing list, send the
message body of "unsubscribe ptk" to majordomo@lists.stanford.edu