XXX: improve perldoc

[perl/list-index.git] / lib / List / Index.pm

diff --git a/lib/List/Index.pm b/lib/List/Index.pm
index dca0d1f3970b83ffad665fc385ea2ed00b8bd778..5b46313d7272168dea172ddf5135ce9ef480dae0 100644 (file)
--- a/lib/List/Index.pm
+++ b/lib/List/Index.pm
@@ -23,7 +23,7 @@ sub ranges {
        my $pages    = $options->{pages   } || 1 + int $#$self / $pagesize;
 
        $pagesize = @$self / $pages;
-       my $offset = $pagesize;
+       my $offset = $pagesize + .5;
        my @links = ('');
        while ($offset < @$self) {
                my $link = substr $self->[$offset], 0, $length;
@@ -164,18 +164,18 @@ __END__
 
 =head1 NAME
 
-List::Index - Paginate alphabetic entries by finding minimal prefixes
+List::Index - Find and apply prefix ranges to paginate keywords
 
 =head1 SYNOPSIS
 
        use List::Index;
        my $index = List::Index->new(\@values);
        my @pages = $index->ranges({pagesize => 50});
-       printf '<a href="?q=%s-%s">%1$s</a> ', @$_ for @pages;
+       say "<a href='?q=$_'>$_</a>" for @pages;
 
        use List::Index 'rangematch';
-       my $limit = rangematch('b-bmq');  # matches prefix like 'baa'..'bmq'
-       @results = grep { $limit } @results;
+       my $limit = rangematch('b-bmq');  # ge 'b' && le 'bmq'
+       @request = grep { $limit } @values;
 
 =head1 DESCRIPTION