Sendpag...ageQueue(3)

🦋 Sendpag...ageQueue(3) — the Perl-ific manual page, bestie edition

okay so real quick before we dive in: this is a User Contributed Perl Documentation page. that's the manual name, that's the vibe. and the page itself is Sendpag...ageQueue(3) — yes the title is literally truncated with dots, it's giving "my name got cut off in the group chat preview", iconic 😭

---

✨ NAME ✨

PageQueue.pm — the module that extends the Queue module and gives it the Page module smarts. like it takes plain Queue and enrolls it in Page school. slay 💅

---

🌸 SYNOPSIS 🌸

here's the whole flow, bestie, copy it exactly:

    $pqueue=Sendpage::PageQueue($config);

    # read waiting pages
    while ($fh=$pqueue->getPage($db)) {
        # build up $page
        @stuff=$pqueue->pullPageFromFile($db,$fh);
        $page=Sendpage::Page->new(@stuff);

        # do something to change $page

        # write changes back to queue
        $pqueue->writePage($page);

        $pqueue->fileDone();
    }

    # add a new page
    $fh=$pqueue->addPage($page);

so you loop while getPage($db) keeps handing you filehandles, you pullPageFromFile($db,$fh) into @stuff, you build a Sendpage::Page->new(@stuff), you mess with $page however you want, you writePage($page) it back, and then you absolutely must fileDone(). and if you're adding a brand new page instead? addPage($page) and it's giving you a $fh. done and dusted 🎀

---

💖 DESCRIPTION 💖

this is a module for use in sendpage(1). that's the whole description. short and mysterious, main character energy honestly. 🔥

---

💀 BUGS 💀

ngl, the original says it plainly and we're gonna say it plainly too: obviously, needs more docs. that's it. that's the bug. not me reading a bug report that's just "write more docs" 😭

---

👑 AUTHOR 👑

Kees Cook <kees@outflux.net> — the one, the only. 🫶

---

🌈 SEE ALSO 🌈

go read these next, iykyk:

• perl(1)
• sendpage(1)
• Sendpage::KeesConf(3)
• Sendpage::KeesLog(3)
• Sendpage::Modem(3)
• Sendpage::PagingCentral(3)
• Sendpage::Page(3)
• Sendpage::Recipient(3)
• Sendpage::Queue(3)

---

🍓 COPYRIGHT 🍓

Copyright 2000 Kees Cook.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 💜

---

and that's the whole page, bestie — no cap, every flag-free, option-free, gloriously short line of it. this one came to you from perl v5.40.2, dated 2024-06-10, and the footer swears it's Sendpag...ageQueue(3) but we both know that name got truncated mid-sentence. anyway. mwah. 💅✨