SVK::Lo...r::Head(3)

💖 SVK::Log::Filter::Head(3) 💖

okay so bestie, welcome to the SVK::Log::Filter::Head page 💅 it lives in the User Contributed Perl Documentation section of your manual, and it's genuinely one of the cutest little filters in the whole pipeline. let's get into it 🫶

---

✨ SYNOPSIS ✨

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

that's it. that's the whole vibe. she passes the first N revisions, periodt. 👑

---

🌸 DESCRIPTION 🌸

so Head is a filter, and she takes exactly one integer as her argument. no more, no less. that integer is literally the number of revisions she's gonna let slide on down the filter pipeline 💫

and here's the tea, bestie: Head only counts revisions that she actually sees. so if some upstream filter does a little skip-skip and the pipeline never hands her a revision, she won't count it — and honestly she can't, it's not a her problem 😭. she's not psychic, she's a filter.

the second she's seen the number of revisions you told her about? she stops the pipeline dead. no further revisions get processed. that's the whole job, and she ate. 💀✨

ngl this filter is lowkey iconic when you're out here searching log messages for patterns (peep SVK::Log::Filter::Grep for that 🧚). for example, if you wanna see the first three revisions whose messages match "foo", you might go:

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

see how they're stacked? grep does the matching, head does the cutting. it's giving teamwork 💜

---

🎀 STASH/PROPERTY MODIFICATIONS 🎀

Head is a respectful queen. she leaves all properties and the stash completely intact. doesn't touch a thing. no cap. 🙈

---

and that's the whole page, bestie!! 🌈⭐ this was the SVK::Log::Filter::Head manual, straight out of the User Contributed Perl Documentation, brought to you by perl v5.42.0 on 2025-07-25 🦋🍓 mwah, love u, go read your logs 💖💅