Term::...ISearch(3pm)

💖 Term::...ISearch(3pm) — bestie edition 💖

okay so this is the manual page for Term::ReadLine::Zoid::ISearch, a readline incremental search mode. yep that's the whole vibe. let's get into it 🦋

---

✨ NAME ✨

Term::ReadLine::Zoid::ISearch — a readline incremental search mode. it does exactly what it says on the tin, no cap 💅

---

🌸 SYNOPSIS 🌸

so here's the thing: this class isn't a "use it on its own" situation. it gets used as a mode under Term::ReadLine::Zoid, and that's where you go for the actual usage details. like, this is the supporting character, not the main character — but it is giving main character energy, fr fr.

---

🎀 DESCRIPTION 🎀

okay so real talk: this mode is meant to be a work alike for the incremental search that lives in the gnu readline library. if you know, you know. iykyk 🫶

in this mode, whatever string you type in gets treated as a perl regex, and that regex is what's used to do an incremental history search. so like, you're not typing a search term, you're typing a pattern. obsessed actually.

pressing ^R over and over again will give you alternative results — keep tapping it, keep getting new matches, it's literally a little slot machine but make it history 🌈

and then the special keys? movements, the "return" key, all that? those drop you out of this mode and set the edit line to the last search result. so whatever you landed on is what you're working with. periodt. ✨

ngl, "work alike" is doing a lot of heavy lifting here — this is a reimplementation of gnu readline's incremental search behaviour, not a copy of it.

---

👑 AUTHOR 👑

Jaap Karssenberg || Pardus [Larus] <pardus@cpan.org>

Copyright (c) 2004 Jaap G Karssenberg. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

like, legally speaking, that's the whole copyright + license situation, and we're keeping it exactly as-is because that's the rules 💜

---

🔥 SEE ALSO 🔥

...okay so this section is literally empty in the original. nothing here. a whole heading with zero content. iconic behaviour honestly. not me leaving it in anyway because the rules said keep every section 😭

---

and that's the whole page bestie!! this one came from perl v5.34.0 and it's dated 2022-06-17 — so yeah, vintage in the most affectionate way possible 💖 go forth and ^R responsibly 🎀🦋⭐