uuagc(1)

💖 uuagc(1) — the Attribute Grammar compiler, but make it fashion 💖

okay bestie, listen up — this is the manual page for uuagc(1) from the User Commands section, and honestly? she's iconic. Let's get into it. 🦋

✨ NAME ✨

uuagc — the Attribute Grammar compiler. yes that's the whole name. short, sweet, main character energy. 👑

🌸 SYNOPSIS 🌸

uuagc [ options ...  ] file

that's it. that's the vibe. give her some options and a file and she'll do her thing. 💅

🎀 DESCRIPTION 🎀

okay so uuagc is the compiler for the (Utrecht University) Attribute Grammar system. periodt.

she takes AG source files (.ag, adorable) as input and hands you back regular Haskell source files (.hs) as output. like, a full glow-up transformation. ✨

Available options: (there are SO many, and we're doing ALL of them, no skipping, I refuse 😤)

• -m — generate the default module header
• --module[=name] — generate a module header, and you get to specify the module name
• -d, --data — generate the data type definition
• --strictdata — generate strict data fields (only when data is actually generated, iykyk)
• --strictwrap — generate strict wrap fields for WRAPPER generated data
• -c, --catas — generate catamorphisms
• -f, --semfuns — generate semantic functions
• -s, --signatures — generate signatures for semantic functions
• --newtypes — use newtypes instead of type synonyms
• -p, --pretty — generate a pretty printed list of attributes
• -w, --wrappers — generate wappers for semantic domains 👀 (yes, "wappers", that's what it says, we don't make the rules)
• -r, --rename — rename data constructors
• --modcopy — use the modified copy rule
• --nest — use nested tuples
• --syntaxmacro — experimental: generate syntax macro code (using knit catas)
• -o file, --output=file — specify the output file
• -v, --verbose — verbose error message format
• -h, -?, --help — get usage information
• -a, --all — do everything (-dcfsprm) — the overachiever option, love her 🫶
• -P search path, --=search path — specify seach path
• --prefix=prefix — set the prefix for semantic functions
• --self — generate the self attribute
• --cycle — check for cyclic definitions 🔄
• --version — get version information
• -O,--optimize — optimize generated code (--visit --case)
• --visit — try generating visit functions
• --seq — force evaluation using function seq (visit functions only)
• --unbox — use unboxed tuples
• --case — use nested cases instead of let (visit functions only)
• --Werrors — turn warnings into fatal errors 💀 (she's serious about this one)
• --dumpgrammar — dump the internal grammar representation (in generated code)

⚖️ COPYRIGHT ⚖️

okay so legally we have to do this part and honestly the people who made this deserve their flowers 💐

• Copyright © 1998 — 2005 Doaitse Swierstra, Arthur Baars and Alexey Rodriguez
• Copyright © 2005 — 2007 Alexey Rodriguez
• Copyright © 2005 — 2007 Joost Verhoog
• Copyright © 2006 — 2007 Arie Middelkoop
• Copyright © 2006 — 2007 Jeroen Fokker
• Copyright © 2007 Atze Dijkstra

This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. (no cap, read the fine print bestie, it's important)

You should have received a copy of the GNU General Public License along with this package; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

💜 AUTHOR 💜

This manual page was written by Arjan Oosting <arjanoosting@home.nl> for the Debian system (but may be used by others). slay, Arjan 🫶

and that's the whole thing, bestie!! you made it to the end, so proud of you 🥹✨

this was uuagc version 0.9.4, dated April 2007 — yeah she's vintage, but vintage is literally always in. 🎀🦋💅