| Subject: | Set::IntSpan::Fast description clarity |
| Date: | Tue, 27 Nov 2007 09:16:40 +1100 |
| To: | bug-set-intspan-fast [...] rt.cpan.org |
| From: | Kevin Ryde <user42 [...] zip.com.au> |
I had a slightly hard time following the introductory description part
of the Set::IntSpan::Fast pod docs. It was only on about the sixth
reading I realized the first paragraph is about plain Set::IntSpan,
which until then had me very confused about what's fast about "Fast".
I see of course the first para does say "Set::IntSpan", but with the
similar names I didn't twig that the description of one module began
with a description of another! :-) As a suggestion I think it could be
clearer to start with what IntSpan::Fast is (array of ranges, binary
search for most inclusion testing), then say how it differs from plain
IntSpan (linear searches for everything, is it?).