nqp-m(1)

💖 nqp-m — Not Quite Perl Compiler 💖

okay bestie, pull up a chair, because we're talking about nqp-m(1), a User Contributed Perl Documentation page, and it's literally the Not Quite Perl Compiler and I'm kind of obsessed. 🦋

---

🌸 SYNOPSIS 🌸

nqp-m [switches] [--] [programfile] [arguments]

that's the whole vibe check right there. switches, maybe a --, maybe a program file, maybe some arguments. we love options. 💅

---

✨ DESCRIPTION ✨

So here's the tea: if you run it with no arguments at all, nqp-m drops you straight into a REPL. main character energy fr fr. 🎀

But if you hand it a [programfile] or hit it with the -e option, it compiles that program, and by default it also executes the compiled code. not just compiling and ghosting you — it actually runs the thing. 💖

• -e program — one line of program, that's it, one line, and you're cooking 🍓
• -h, --help — display this help text, your little map 🗺️
• --target=[stage] — specify compilation stage to emit, pick your stage bestie ⭐
• -t, --trace=[flags] — enable trace flags, so you can see 👀
• --encoding=[mode] — specify string encoding mode, encoding but make it specified 🌈
• -o, --output=[name] — specify name of output file, name the baby 👑
• -v, --version — display version information, always good to know who you're dealing with 💜
• --stagestats — display time spent in the compilation stages, a little time audit, slay ⏱️
• --ll-exception — display a low level backtrace on errors, for when things go 💀 and you need the low level receipts

Note that only boolean single-letter options may be bundled — so like, don't go feral bundling everything you see. only the boolean single-letter ones. periodt. 🙈

---

🧚 MOARVM OPTIONS 🧚

Here's the part where you gotta be careful, bestie. If you want to pass options down to the underlying MoarVM virtual machine, you have to explicitly run moar. You cannot specify these options by using the perl6 executable. like, not a vibe, it just doesn't work that way. 😭

moar [--crash] [--libpath=...] input.moarvm [program args]

And for the full menu of what moar will accept, go hit up moar --help — it's got a list of valid MoarVM options waiting for you. 🫶

---

💜 AUTHORS 💜

• Written by the NQP contributors, see the CREDITS file. 🎀
• This manual page was written by Alessandro Ghedini for the Debian project, and may be used by others. iconic behavior honestly 💅

---

and that's the whole page, bestie!! this was nqp-m(1), from perl v5.40.1, dated 2026-02-11 — go compile something gorgeous 🌈✨💖