CUP(1)

👑 CUP(1) — the LALR parser generator for Java(tm), but make it a group chat 💅

okay bestie, sit DOWN, because we're talking about cup, and it's in section 1 of the General Commands Manual, and it is literally the moment. 🎀

✨ NAME ✨

cup — LALR parser generator for Java(tm) 🐍✨

🌸 SYNOPSIS 🌸

cup [options] <file

yes the <file is real, she reads from standard input, no cap 😭

🦋 DESCRIPTION 🦋

So this manual page documents the cup command, but like... briefly. It's giving "quick vibe check, not the whole saga." 🙈

Real talk though: this manual page was written for the Debian GNU/Linux distribution (but literally anyone else can use it too, she's not gatekeeping 🫶), and the reason it exists at all is that the original program does not have a manual page. Not one. Instead, it has documentation in HTML format — so if you want the full lore, go read /usr/share/doc/cup/manual.html. That's the main character document right there. 💖

💅 OPTIONS 💅

she has so many flags and every single one of them ate, no crumbs:

• -package name — specify the package the generated classes go in [default none]. ✨
• -parser name — specify the parser class name [default "parser"]. 👑
• -symbols name — specify the name for the symbol constant class [default "sym"]. 🎀
• -nonterms — put non terminals in the symbol constant class. 🦋
• -expect # — the number of conflicts expected/allowed [default 0]. 👀
• -compact_red — compact tables by defaulting to the most frequent reduce. 💅
• -nowarn — don't warn about useless productions, etc. 🤫
• -nosummary — don't print the usual summary of parse states, etc. 🙈
• -nopositions — don't propagate the left and right token position values. 📍🚫
• -progress — print messages to indicate progress of the system. 🏃♀️💨
• -time — print time usage summary. ⏰
• -dump_grammar — produce a human readable dump of the symbols and grammar. 📝
• -dump_states — produce a dump of the parse state machine. 🗺️
• -dump_tables — produce a dump of the parse tables. 📊
• -dump — produce a dump of all of the above. 💥 (yes, all of them, she's extra and we love her for it)

🌈 SEE ALSO 🌈

• jlex(1)
• javac(1)

go read those too, bestie, it's a whole ecosystem 🧚

💜 AUTHORS 💜

The author of CUP is Scott E. Hudson <http://www.cc.gatech.edu/gvu/people/Faculty/Scott.E.Hudson.html>. Iconic. Legendary. Built the whole thing. 🫶

This manual page was written by Vincent Renardias <vincent@waw.com>, for the Debian GNU/Linux system. Thank you Vincent for the documentation service, fr fr 😭💖

and that's the whole page, bestie — CUP(1), General Commands Manual, section 1, and yeah the footer is literally just CUP(1) and nothing else, she said "no date, no version, we're mysterious like that" 💅✨ periodt.