racc(1)

💖 racc — like, the manual, but make it make sense 💖

ok so bestie, you're looking at the racc(1) page from the General Commands Manual, and I'm gonna walk you through it like we're texting at 2am. it's giving ✨parser generator✨ energy and honestly? she's iconic.

🌸 NAME 🌸

racc — the Ruby LALR parser generator. that's it, that's the whole vibe. 👑

✨ SYNOPSIS ✨

racc [options] file

like, you give her some options, you give her a file, she does her thing. periodt.

🦋 DESCRIPTION 🦋

so Racc is a LALR(1) parser generator. and the cute part? she's written in Ruby itself. no cap. she eats Ruby and she generates Ruby programs. it's giving self-made, self-sustaining, main character energy fr fr. 💅

🎀 OPTIONS 🎀

okay this is the part everyone skips and DON'T. every single flag matters, i don't make the rules.

• -g, --debug — outputs a parser so you can debug at the user level. little peek-behind-the-curtain moment, we love that. 🙈
• -o, --output-file <outfile> — names the output file. default is [<fname>.tab.rb].
• -e, --executable <rubypath> — inserts a #! line into the output. pass 'ruby' to get the default. she's executable now, she's employed, she's thriving. 💼
• -E, --embedded — spits out a file that doesn't need a runtime. self-sufficient queen. no dependencies, no drama. ✨
• -l, --no-line-convert — never converts line numbers. (this one's for ruby<=1.4.3, so like, a historical artifact, but we respect her.) 🏛️
• -c, --line-convert-all — converts line numbers also in the header and footer. thorough. detail-oriented. obsessed with her. 💖
• -a, --no-omit-actions — never omits actions. nothing gets left out on her watch.
• -v, --verbose — creates a <filename>.output file. she's a talker, she's telling you EVERYTHING. 😭
• -O, --log-file <fname> — sets the file name for the verbose output. default is [<fname>.output].
• -C, --check-only — syntax check only. no output, just vibes. she's just looking. 👀
• -S, --output-status — outputs status time to time. little progress updates, like a group chat read receipt. 🫶
• --no-extentions — runs without any ruby extentions. (yes that's spelled exactly like that in the original, i am NOT fixing it, i am preserving the artifact, it's part of her charm now 💀)
• -h, --help — prints this message and quits. the classic. the beloved.
• --version — prints the version and quits. 🏷️
• --runtime-version — prints the runtime version and quits. two different versions, two different flags, don't @ me.
• --copyright — prints the copyright and quits. legal girlie moment. ⚖️

lowkey important reminder: these flags do exactly what they say and nothing more. i'm not out here inventing behaviour, bestie, i'm just making it fun to read. 🧚

🌈 SEE ALSO 🌈

• /usr/share/doc/racc/html.en/index.html (English)
• /usr/share/doc/racc/html.ja/index.html (Japanese)

go read the docs, they're right there on your machine, slay. 📚

and that's the whole page, bestie. this manual page is dated April 2005 and it's from racc(1) — the racc(1) manual, general commands section. she's been iconic since 2005 and she's not stopping. 💜

you ate this. go build a parser. 🎀