[KinoSearch] Two things

[Marvin Humphrey]

On Thu, May 07, 2009 at 04:39:12PM -0700, webmasters at ctosonline.org wrote:

> >Current KS never deals in list context.

> I have no problem understanding ‘array’. Let’s use it. :-)

> -    /** Return a list of Span objects, indicating where in the given field the
> +    /** Return an array of Span objects, indicating where in the given

D'oh! :)

Fixed by r4563.

> > I might have to do something asinine like use #AN_ARRAY# and swap in  
> > the name of choice for the bindings.
> 
> I don’t see that as asinine, but it might be easier just to put a note  
> somewhere that arrays are always references.

I was thinking that such a note might belong in the tutorial, but there wasn't
an obvious place for it, since none of the methods used in the tutorial return
an array.

I'd like to avoid adding a footnote to the primary KinoSearch.pm documentation
-- that's prime real estate, and it should be no longer than absolutely
necessary.

I'm not sure where else to put it, so for now, I think we'll just leave it be
until we see how many people get confused.  That was my intended experiment; I
thought it had failed, but that was because I didn't realize that I had
actually used "list".

> Works nicely (at least with the test I sent you). 

Excellent.

Marvin Humphrey