ml-burg(1)

💖 ml-burg(1) — General Commands Manual 💖

okay bestie, gather round, we're doing a tree parser generator today and honestly? it's giving compiler-core, it's giving main character energy 🌳✨

---

🌸 NAME 🌸

ml-burg — a tree parser generator for Standard ML 🎀

---

✨ SYNOPSIS ✨

ml-burg file.burg

like, that's it. one file in. that's the whole vibe check. 🦋

---

💅 DESCRIPTION 💅

so this page is a brief little rundown of the ml-burg command, okay? and not me exposing the lore but — this manual page was written for the Debian distribution specifically because the original program literally does not have a manual page. no cap. someone had to do it and it was Debian. 😭

Here's the tea on what ml-burg actually does 🍓:

The ml-burg program generates a Standard ML program whose whole job is to perform bottom-up rewriting of an input tree. Cost information associated with each rewrite rule is used to derive the minimum rewrite cost for the entire tree. A successful reduction corresponds to rewriting the input tree to a special non-terminal symbol called the start non-terminal ⭐. And once you've successfully reduced? bestie, facilities are provided to walk the tree emitting semantic actions corresponding to the rules that matched. iconic behaviour, honestly 👑

lowkey the whole pipeline: rewrite rules + costs in, minimal-cost reduction out. slay.

And when ml-burg is presented with file.burg, the file file.sml is generated. that's the transformation. in goes .burg, out comes .sml. periodt. 💖

---

🌈 SEE ALSO 🌈

go read your siblings, besties, they're all part of the family:

• sml(1)
• ml-lex(1)
• ml-yacc(1)
• ml-makedepend(1)
• ml-build(1)

These programs are documented fully by The ML-Burg -- Documentation, by Florent Guillaume and Lal George 🫶 — and you can find it right here:

/usr/share/doc/smlnj-doc/ml-burg_manual.pdf.gz

fr fr, if you want the deep lore, that PDF is the deep lore. 📖✨

---

💜 AUTHOR 💜

This manual page was written by Aaron Matthew Read <amread@nyx.net>, for the Debian GNU/Linux system (but may be used by others). we love a generous king 🫶👑

---

and that's the whole page, bestie!! written back on November 14, 2002, from the General Commands Manual, and yeah it's the ml-burg(1) source you just read 💅 mwah, go compile something gorgeous 💖✨🦋