vislcg3(1)

👑 vislcg3 — the manual, but make it cute

okay bestie, so this is the manual page for vislcg3(1) and honestly? it's giving legend behavior. sit down, grab a boba, we're doing grammar disambiguation today 💅

✨ NAME ✨

vislcg3 — this application is part of ( cg3 )

This tool is part of the CG-3 constraint grammar system: https://edu.visl.dk/cg3.html.

🌸 SYNOPSIS 🌸

vislcg3 [OPTIONS]

🦋 DESCRIPTION 🦋

so vislcg3 is the grammar parser AND the disambiguator in the VISL constraint grammar system. what does that mean? it's the main character that looks at all the different analyses (or "readings") of a word that a morphological analyser handed over, and picks between them based on a set of grammatical rules. it's literally choosing the vibe that fits. 👑

and by default? vislcg3 reads input from stdin and writes output to stdout. classic. no notes.

---

💖 OPTIONS 💖

• -h, --help — shows this help (the moment u need it most)
• -?, --? — shows this help (yes, again, but make it question-mark shaped)
• -V, --version — prints copyright and version information, iykyk
• -g, --grammar — specifies the grammar file to use for disambiguation
• --grammar-out — writes the compiled grammar in textual form to a file
• --grammar-bin — writes the compiled grammar in binary form to a file
• --grammar-only — only compiles the grammar; implies --verbose
• --ordered — (will in future allow full ordered matching) — future era, not here yet
• -u, --unsafe — allows the removal of all readings in a cohort, even the last one 😳
• -s, --sections — number or ranges of sections to run; defaults to all sections
• --rules — number or ranges of rules to run; defaults to all rules
• --rule — a name or number of a single rule to run
• -d, --debug — enables debug output (very noisy) — like, SO noisy, protect ur ears
• -v, --verbose — increases verbosity
• -2, --vislcg-compat — enables compatibility mode for older CG-2 and vislcg grammars
• -I, --stdin — file to read input from instead of stdin
• -O, --stdout — file to print output to instead of stdout
• -E, --stderr — file to print errors to instead of stderr
• -C, --codepage-all — codepage to use for grammar, input, and output streams; defaults to UTF-8
• --codepage-grammar — codepage to use for grammar; overrides --codepage-all
• --codepage-input — codepage to use for input; overrides --codepage-all
• --codepage-output — codepage to use for output and errors; overrides --codepage-all
• -L, --locale-all — locale to use for grammar, input, and output streams; defaults to en_US_POSIX
• --locale-grammar — locale to use for grammar; overrides --locale-all
• --locale-input — locale to use for input; overrides --locale-all
• --locale-output — locale to use for output and errors; overrides --locale-all
• --no-mappings — disables all MAP, ADD, and REPLACE rules
• --no-corrections — disables all SUBSTITUTE and APPEND rules
• --no-before-sections — disables all rules in BEFORE-SECTIONS parts
• --no-sections — disables all rules in SECTION parts
• --no-after-sections — disables all rules in AFTER-SECTIONS parts
• -t, --trace — prints debug output alongside with normal output
• --trace-name-only — if a rule is named, omit the line number; implies --trace
• --trace-no-removed — does not print removed readings; implies --trace
• --trace-encl — traces which enclosure pass is currently happening; implies --trace
• --dry-run — make no actual changes to the input (just vibes, no consequences)
• --single-run — runs each section only once; same as --max-runs 1
• --max-runs — runs each section max N times; defaults to unlimited (0)
• -S, --statistics — gathers profiling statistics while applying grammar
• -Z, --optimize-unsafe — destructively optimize the profiled grammar to be faster ⚠️ destructive, bestie
• -z, --optimize-safe — conservatively optimize the profiled grammar to be faster
• -p, --prefix — sets the mapping prefix; defaults to @
• --unicode-tags — outputs Unicode code points for things like ->
• --unique-tags — outputs unique tags only once per reading
• --num-windows — number of windows to keep in before/ahead buffers; defaults to 2
• --always-span — forces scanning tests to always span across window boundaries
• --soft-limit — number of cohorts after which the SOFT-DELIMITERS kick in; defaults to 300
• --hard-limit — number of cohorts after which the window is forcefully cut; defaults to 500
• -D, --dep-delimit — delimit windows based on dependency instead of DELIMITERS; defaults to 10
• --dep-original — outputs the original input dependency tag even if it is no longer valid
• --dep-allow-loops — allows the creation of circular dependencies 🌀
• --dep-no-crossing — prevents the creation of dependencies that would result in crossing branches
• --no-magic-readings — prevents running rules on magic readings ✨ (yes that's the actual name)
• -o, --no-pass-origin — prevents scanning tests from passing the point of origin
• -e, --show-end-tags — allows the <<< tags to appear in output
• --show-unused-sets — prints a list of unused sets and their line numbers; implies --grammar-only
• --show-tag-hashes — prints a list of tags and their hashes as they are parsed during the run
• --show-set-hashes — prints a list of sets and their hashes; implies --grammar-only

---

💀 BUGS 💀

found something cursed? email it, fr fr:

Email to: Tino Didriksen <mail@tinodidriksen.com>

🎀 AUTHOR 🎀

(c) 2007-2025 GrammarSoft ApS

---

and that's the whole page, bestie. every flag, every default, every warning — all accounted for, no cap. go disambiguate something iconic. 🫶

signing off from the vislcg3(1) manual, dated 2014-05-07, version courtesy of GrammarSoft ApS — mwah, slay, periodt 💖✨