WXPERL_OVERLOAD(1)

💖 WXPERL_OVERLOAD 💖

okay bestie, gather round, because this little script is literally the behind-the-scenes icon of wxPerl extensions and nobody ever talks about her. her name is wxperl_overload, she lives in the User Contributed Perl Documentation section of the manual (section 1, iykyk), and her whole job is making overload declarations for wxPerl extensions. no cap. 🎀

---

✨ NAME ✨

wxperl_overload — create overload declarations for wxPerl extensions 🦋

like… she makes the overload declarations. that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

so here's how you summon her. usually she gets invoked from a Makefile (she's a busy girl, she doesn't come when you call her directly most of the time 🙈):

# usually invoked from Makefile
wxperl_overload <.cpp file> <.h file> files...

wxperl_overload <.cpp file> <.h file> file.lst

notice the two flavors: you can hand her a bunch of files right there on the command line, or you can hand her a single .lst file that lists them. either way she eats. 😌

---

📖 DOCUMENTATION 📖

okay so the lore:

this script is usually invoked from an ExtUtils::MakeMaker-generated file by using WX_OVERLOAD in Makefile.PL. that's her natural habitat. that's her main character moment. 👑

what she actually does, step by step:

• she scans the files given on the command line, or the files listed in the .lst file, searching for wxPerl overload declarations 🔍
• she writes a .h file with a matching .cpp file, and that .cpp contains the definition for wxPerl overload constants ✨

and that's it. that's the whole job. she shows up, she scans, she writes the pair of files, she leaves. queen behavior. periodt. 💖

ngl she's a build-tooling girly, so if something looks weird, it's probably your Makefile's fault and not hers. just saying. 🫶

---

okay that's the whole page, bestie!! this was documented as part of perl v5.42.0, dated 2025-07-28, and filed under WXPERL_OVERLOAD(1). go forth and overload responsibly. 💅✨🌸