PDF::Bu...e_basic(3)

🌸 PDF::Builder::Content::Hyphenate_basic — the manual page 💖

okay bestie, so this is the page for PDF::Builder::Content::Hyphenate_basic, which lives in the User Contributed Perl Documentation section of the manual (section 3, the library-calls girlies 🎀). Here's the whole vibe.

---

✨ NAME ✨

PDF::Builder::Content::Hyphenate_basic — simple hyphenation capability 🦋

Also, real quick: it inherits from PDF::Builder::Content::Text 👑 so keep that in mind, it's giving family tree.

---

✨ SYNOPSIS ✨

so here's the tea, and I need you to hear me on this one:

these are internal routines, and they're somewhat experimental 🧪. They may (or may not) get extended in the future — we simply do not know, and honestly? nobody's promising anything 💀.

They get called from various Content routines that take long strings of text and split them up into fixed-length lines ✂️.

---

😭 how the splitting actually goes

Words get split so the line fills up as completely as possible — without regard to widows and orphans, long runs of hyphens at the right edge, "rivers" of space flowing through a paragraph, and other problems like that. She's filling the line and she is NOT thinking about the aesthetics, no cap 😭.

Also it's only simple splitting — and ngl it's not even actually words being split, it's just splitting on a simple, language-independent basis 🌍. There's no dictionary and no rules-based splitting happening currently. None. Zero. Zip. 🙈

⚠️ real talk: this whole functionality may well be replaced by "hooks" that call language-specific word-splitting rules, plus actually worrying about how the results look (like, Knuth-Plass and friends 👀). So don't get too attached, bestie.

---

💅 and that's the whole page, fr fr

perl v5.42.0 🫶 2026-01-17 — that's the version and date this page was baked with, iconic, periodt. 🎀✨