SYNOPSIS

SVK::Log::Filter::Head - pass the first N revisions

DESCRIPTION

The Head filter requires a single integer as its argument. The integer represents the number of revisions that the filter should allow to pass down the filter pipeline. Head only counts revisions that it sees, so if an upstream filter causes the pipeline to skip a revision, Head won't (and can't) count it. As soon as Head has seen the specified number of revisions, it stops the pipeline from processing any further revisions.

This filter is particularly useful when searching log messages for patterns (see SVK::Log::Filter::Grep). For example, to view the first three revisions with messages that match "foo", one might use

    svk log --filter "grep foo | head 3"

STASH/PROPERTY MODIFICATIONS

Head leaves all properties and the stash intact.