XXX: comment ranges method code

diff --git a/lib/List/Index.pm b/lib/List/Index.pm
index e30beef4734174a38f5443895ebad9042325efe8..574613e8b1c38e2e6b3eaf4c751fd42d53c6930e 100644 (file)
--- a/lib/List/Index.pm
+++ b/lib/List/Index.pm
@@ -28,12 +28,15 @@ sub ranges {
        while ($offset < @$self) {
                my $link = substr $self->[$offset], 0, $length;
                if ($context) {
-                       my $trim = 1;
+                       # take a value slightly before the current offset
                        my $before = $offset > $context ? $self->[$offset - $context] : '.';
+                       # see how much of it matches the current link
+                       my $trim = 1;
                        for my $match (split //, $before) {
                                scalar $link =~ /\G\Q$match/g or last;
                                $trim++;
                        }
+                       # truncate link upto where the earlier value starts to differ
                        substr($link, $trim) = '' unless $trim > length $link;
                }