LaTeX:...rogram(3pm)

💖 LaTeX::Driver::FilterProgram 💖

okay so bestie, welcome to the User Contributed Perl Documentation section, which is where this lil gem lives. it's giving "niche but iconic" and honestly? we're obsessed. let's get into it ✨

---

🌸 NAME 🌸

LaTeX::Driver::FilterProgram — the LaTeX driver's very own FilterProgram, no cap 💅

---

🎀 VERSION 🎀

1.3.1

she's version one-point-three-point-one and she knows it 🫶

---

✨ SYNOPSIS ✨

use LaTeX::Driver::FilterProgram;
LaTeX::Driver::FilterProgram->execute(format => $format);

that's it. that's the whole vibe check right there 💖

---

🦋 DESCRIPTION 🦋

okay so real talk: this module is not meant to be used by you, bestie. like, she's not for public consumption. the only ones allowed in the group chat are the programs "latex2pdf", "latex2ps" and "latex2dvi" — all of which ship inside the LaTeX::Driver distribution. she implements the guts of those filter programs, which is honestly such a main character move. she's the one doing all the work behind the scenes while the pretty little front-end programs take the credit 😭

---

🌈 SUBROUTINES/METHODS 🌈

💜 execute(%params)

this is the only method. the one. the icon. the moment. periodt.

she implements the guts of the filter programs — like, all of it — by gathering up the parameters for the "LaTeX::Driver" object constructor from the command line options, plus the options that got passed in from the calling script, which should be the format option, obviously. and then? having constructed a driver object, she runs the driver. slay 💅

and here's the tea: if the -tt2 option is specified, then the source document is taken to be a Template Toolkit template 🧚 and a Template object gets constructed, and the template gets processed through that before being fed to the "LaTeX::Driver" module for latex formatting. so it's like a lil makeover before the big show, yk?

template variables may be defined with the -define option, and those get passed to the Template Toolkit processing stage. fair warning tho: they are ignored if the -tt2 option is not specified. so like, don't come crying if you skip the -tt2 and your defines ghost you 🙈

---

👑 DIAGNOSTICS 👑

the module invokes the "LaTeX::Driver" module, and optionally the "Template" module. any errors from those modules are propagated outwards. so if something goes wrong, bestie, she is NOT keeping it to herself — she's telling everybody. very "screenshot and send to the group chat" energy 💀

---

🍓 CONFIGURATION AND ENVIRONMENT 🍓

the module invokes the latex family of programs via the "LaTeX::Driver" module. and those programs? they have their own set of environment variables and configuration files. so that's a whole separate rabbit hole, iykyk 🕳️✨

---

🧚 DEPENDENCIES 🧚

the module requires that the Template Toolkit is installed for the -tt2 option. no Toolkit, no -tt2. simple as that, fr fr 💅

---

🌸 INCOMPATIBILITIES 🌸

None known. (she's unproblematic, we love that for her 🫶)

---

💀 BUGS AND LIMITATIONS 💀

None known. (iconic behaviour honestly 👑)

---

⭐ AUTHOR ⭐

Andrew Ford <a.ford@ford-mason.co.uk>

---

💖 LICENSE AND COPYRIGHT 💖

Copyright (C) 2007 Andrew Ford. All Rights Reserved.

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

---

okay bestie that's a wrap!! this page came to you courtesy of perl v5.40.1, dated 2026-01-25, and it lives under the LaTeX:...rogram(3pm) header name in the User Contributed Perl Documentation manual. go forth and filter, mwah 💋💅✨