Mail::M...ormatPS(3)

💖 Mail::Message::Convert::HtmlFormatPS 💖

okay bestie, so like. this is Mail::Message::Convert::HtmlFormatPS, a lil Perl module from the Mail::Message family, and its whole personality is: take an HTML/XHTML message body and turn it into PostScript. yes. actual PostScript. it's giving printer-friendly. 🎀

---

🌈 INHERITANCE

the family tree, periodt:

Mail::Message::Convert::HtmlFormatPS
  is a Mail::Message::Convert
  is a Mail::Reporter

so it's a Mail::Message::Convert, which is a Mail::Reporter. iconic lineage honestly. 👑

---

✨ SYNOPSIS

here's the whole vibe in four lines, no cap:

use Mail::Message::Convert::HtmlFormatPS;
my $af = Mail::Message::Convert::HtmlFormatPS->new;

my $postscript = $af->format($body);

make the object, call format, get PostScript back. that's it. that's the whole thing. slay. 💅

---

🦋 DESCRIPTION

okay so what it does: it translates an HTML/XHTML message body into a postscript body, and it does that by using HTML::FormatPS. 🫶

also it extends "DESCRIPTION" in Mail::Message::Convert — so go read that one too, bestie, it's the parent lore.

---

💜 METHODS

and yes, it extends "METHODS" in Mail::Message::Convert. 🌸

🎀 Constructors

extends "Constructors" in Mail::Message::Convert, obvi.

• $class->new(%options) — builds you a shiny new converter. here's the tea: any %options that start with capitals get blindly passed straight through to HTML::FormatPS. not filtered, not checked, just yeeted on over. and as of this writing, that package defines these ones: BottomMargin, FontFamily, FontScale, HorizontalMargin, Leading, LeftMargin, PageNo, PaperHeight, PaperSize, PaperWidth, RightMargin, TopMargin, and VerticalMargin. ✨

it improves base, so also see "Constructors" in Mail::Reporter.

and here's the option table, exactly as it stands:

 -Option--Defined in            --Default
  fields  Mail::Message::Convert  <not used>

so like, fields comes from Mail::Message::Convert and its default is <not used>.

• fields => $name|$regex|\@names|\@regexes — that's how you feed the fields option. one name, or a regex, or arrayrefs of names, or arrayrefs of regexes. your choice, main character. 🌟

🧚 Attributes

extends "Attributes" in Mail::Message::Convert. nothing extra listed here, it's just vibing off the parent. 💫

🔥 Converting

extends "Converting" in Mail::Message::Convert.

• $obj->format($body) — pass in an html or xhtml encoded body and a plain text body is returned. and heads up: characters are translated into Latin1. 🌈
• $obj->selectedFields($head) — inherited, so go see "Converting" in Mail::Message::Convert for the details. 😌

💀 Error handling

extends "Error handling" in Mail::Message::Convert.

• $obj->AUTOLOAD() — inherited, see "Error handling" in Mail::Reporter.
• $obj->notImplemented() — inherited, see "Error handling" in Mail::Reporter.

🍓 Cleanup

extends "Cleanup" in Mail::Message::Convert.

• $obj->DESTROY() — inherited, see "Cleanup" in Mail::Reporter. rip to the object, but like, in a healthy way. 💖

---

😭 DIAGNOSTICS

• Error: class $package does not implement method $method. — this one is a fatal error. so the specific $package (or one of its superclasses) does not implement this method where it should. what that means: some other related classes do implement this method, but the class you're holding right now does not. you should probably investigate this, and probably inform the author of the package. cast by notImplemented(). 🫠

---

⭐ SEE ALSO

this module is part of Mail-Message version 4.04, built on February 04, 2026. website: http://perl.overmeer.net/CPAN/ 🌐

---

👑 LICENSE

for contributors, see file ChangeLog. 📝

this software is copyright (c) 2001-2026 by Mark Overmeer.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. fr fr. 🫶

---

and that's a wrap bestie — this page came to you from perl v5.42.0, dated 2026-02-05, and it's the manpage for Mail::M...ormatPS(3). go convert something. mwah. 💅✨