Mail::M...oformat(3)

💖 Mail::M...oformat(3) 💖

okay bestie, welcome to the manual page for Mail::Message::Convert::TextAutoformat — aka the glow-up station for your plain text messages. This is from the User Contributed Perl Documentation, and no, the truncated name in the corner is not a glitch, that's just how the man page header likes to do its lil thing. 🎀

---

✨ NAME ✨

Mail::Message::Convert::TextAutoformat — Reformat plain text messages. That's it, that's the whole job. 💅

---

🌸 INHERITANCE 🌸

the family tree, and yes she's got lineage:

Mail::Message::Convert::TextAutoformat
  is a Mail::Message::Convert
  is a Mail::Reporter

---

🦋 SYNOPSIS 🦋

the little taste test, the vibe check, the "here's how you'd actually use it":

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

my $beautified_body = $af->autoformatBody($body);

look at her go. ✨

---

🌈 DESCRIPTION 🌈

so basically she plays trics with plain text — for example bodies with type text/plain — using Damian Conway's Text::Autoformat. like she takes your messy lil text and makes it cute.

Extends "DESCRIPTION" in Mail::Message::Convert.

---

💜 METHODS 💜

Extends "METHODS" in Mail::Message::Convert.

🎀 Constructors

Extends "Constructors" in Mail::Message::Convert.

• $class->new(%options) — Inherited, see "Constructors" in Mail::Reporter

here's the option table, bestie, keep it close:

 -Option --Defined in            --Default
  fields   Mail::Message::Convert  <see description>
  options                          +{ all => 1 }

• fields => $name|$regex|\@names|\@regexes
• options => \%af — the %af options to pass to the Text::Autoformat function autoformat().

💫 Attributes

Extends "Attributes" in Mail::Message::Convert.

🌸 Converting

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

• $obj->autoformatBody($body) — formats a single message body (a Mail::Message::Body object) into a new body object using Text::Autoformat.

the body should have content type text/plain — otherwise the output is probably weird. 😭 consider yourself warned, bestie.

• $obj->selectedFields($head) — Inherited, see "Converting" in Mail::Message::Convert

🚨 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

---

💀 DIAGNOSTICS 💀

• Error: class $package does not implement method $method. — Fatal error: the specific $package (or one of its superclasses) does not implement this method where it should. This message means that some other related classes do implement this method however the class at hand does not. Probably you should investigate this and probably inform the author of the package. Cast by notImplemented().

like she's literally telling you "girl, somebody forgot to write this method" — go investigate, go email the author, you got this. 🫶

---

👀 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.

---

and that's the whole page, bestie!! 🎀✨ this one came to you courtesy of perl v5.42.0, dated 2026-02-05 — mwah, go format some text, you ate. 💅🦋💖