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

💖 SVK::Lo...r::Grep(3) 💖

okay bestie, welcome to the manpage for SVK::Log::Filter::Grep — she's part of the User Contributed Perl Documentation collection, and she is literally just here to search your log messages for a pattern. lowkey iconic behavior. 🎀

---

✨ SYNOPSIS ✨

SVK::Log::Filter::Grep - search log messages for a given pattern

that's the whole vibe, no cap. 🦋

---

🌸 DESCRIPTION 🌸

so here's the tea, bestie: the Grep filter needs one single Perl pattern (a regular expression, iykyk) as its argument. that's it. that's her whole thing. 💅

then she takes that pattern and applies it to the svn:log property of every revision she receives. and then:

• if the pattern matches → the revision gets to keep flowing on down the pipeline, slay ✨
• if the pattern doesn't match → the pipeline immediately skips to the next revision. not me being brutally efficient 😭

---

okay now the important part, don't skip this: the pattern is applied with the /i modifier, which means case insensitivity. so if you want case-sensitivity, or any other little tweak to how your pattern behaves, you must use the (?imsx-imsx) extended pattern. (go run perldoc perlre for the full lore, fr fr.)

for example, if you wanna search for log messages that match exactly the characters "foo", you might do:

svk log --filter "grep (?-i)foo"

but if you wanna search for "foo" without any regard for case (she's chill like that), you might try:

svk log --filter "grep foo"

---

heads up about capturing parentheses: the result of any capturing parentheses inside your pattern is NOT available. like, at all. 🙈 if demand dictates, the Grep filter could be modified to stash that captured value somewhere for other filters to access — but as of right now? nope. not a thing. 💀

---

and now, the gotcha that gets everybody: if your pattern contains a pipe character ('|'), it must be escaped by putting a '\' character right before it. otherwise, the portion of the pattern after the pipe character gets interpreted as the name of a log filter. so like… she's not being rude, she's just parsing. escape it or perish bestie 🫶

---

👑 STASH/PROPERTY MODIFICATIONS 👑

good news!! Grep leaves all properties and the stash completely intact. she minds her own business. we love a filter with boundaries. 💖

---

quick reminder bestie: this page is from perl v5.42.0, dated 2025-07-25, and it lives under SVK::Lo...r::Grep(3) in the User Contributed Perl Documentation. go forth and grep, my love. mwah. 💋✨🎀🦋🌸💅