PDF::F...Grammar(3pm)

💖 PDF::FDF::Simple::Grammar — the precompiled grammar tea 💖

okay so this is the precompiled grammar for PDF::FDF::Simple, bestie. that's the whole vibe. it's a 3pm man page (perl module docs, iykyk) and it's here to explain why this file exists and how to escape it if you're feeling feral.

---

✨ NAME ✨

PDF::FDF::Simple::Grammar — precompiled grammar for PDF::FDF::Simple 🎀

---

🌸 DESCRIPTION 🌸

okay so listen. this thing? it's the precompiled grammar. that's it, that's the girl. she gets generated from:

lib/auto/PDF/FDF/Simple/grammar

by running:

./Build grammar

and like, usually done by the maintainer or a developer. so if you're just vibing and using the module, you probably never touch this. it's giving backstage pass energy. 🫶

---

🦋 Developing without precompile 🦋

so here's the fun part, bestie. you can completely dodge the precompiled grammar and use the raw grammar file instead — you just gotta set this environment variable to a true value:

export PDF_FDF_SIMPLE_IGNORE_PRECOMPILED_GRAMMAR=1

and boom 💅 that's it. this is useful if you want to work on the grammar without the need to precompile everytime. like, imagine editing the grammar and having to rebuild every single time?? not the vibe. this variable is the vibe.

⭐ pro tip from the original, no cap: the path to the grammar file is determined using File::ShareDir in the respective lib/auto/ subdirectory that belongs to the currently used module, depending on @INC.

so when you get confused — like, "why are my changes not working??" 😭 — check which grammar file it is actually using. it's probably not the one you think. this happens to literally everyone. 🙈

some typical different @INCs are used with:

prove -l t/*.t               # ./lib/
prove -b t/*.t               # ./blib/
./Build test                 # ./blib/
perl -MPDF::FDF::Simple ...  # perl's @INC

see how they hit different directories?? ./lib/ vs ./blib/ vs perl's own @INC — three completely different grammar files, three completely different moods. so yeah. when in doubt, check the @INC. it never lies. ✨

---

and that's the whole page, babe 🎀 no cap, every single line of the original made it in here, just with better vibes.

this manual page was cooked up by the User Contributed Perl Documentation crew, version perl v5.34.0, dated 2022-06-14. 💖 thanks for reading, ily, go compile something iconic. 💅🌟