OTT(1)

🌸 NAME 🌸

Ott — manual page for Ott version 0.34, distribution of Mon Dec 30 10:12:45 GMT 2024 💖

---

✨ DESCRIPTION ✨

okay so bestie, welcome to OTT(1), you made it 💅 this is the manual page for Ott version 0.34, distribution of Mon Dec 30 10:12:45 GMT 2024 — same version, same date, she's consistent, we love that for her 🎀

here's the whole vibe, the way you actually call her:

ott <options> <filename1> .. <filenamen>

want the ocamlyacc trace? iconic. use: OCAMLRUNPARAM=p ott ...

and lowkey the bestie shortcut, because nobody wants to type -i eight times:

ott <options> <filename1> .. <filenamen>

is equivalent to

ott -i <filename1> .. -i <filenamen> <options>

same energy, different outfit ✨

---

🎀 the options (all of them, no skipping, no cap) 🎀

• -i <filename> — input file 💖 can be used multiple times (stack 'em up bestie)
• -o <filename> — output file, also can be used multiple times
• -writesys <filename> — output system definition
• -readsys <filename> — input system definition
• -tex_filter <src><dst> — files to TeX filter
• -coq_filter <src><dst> — files to Coq filter
• -hol_filter <src><dst> — files to HOL filter
• -lem_filter <src><dst> — files to HOL filter (yes, it says HOL again, that's literally what the page says, I'm just the messenger 🫶)
• -isa_filter <src><dst> — files to Isabelle filter
• -ocaml_filter <src><dst> — files to OCaml filter
• -merge <false> — merge grammar and definition rules (defaults to <false>)
• -parse <string> — test parse symterm, eg ":nontermroot: term"
• -fast_parse <false> — do not parse :rulename: pseudoterminals
• -signal_parse_errors <false> — return >0 if there are bad defns
• -picky_multiple_parses <false> — picky about multiple parses
• -quotient_rules <true> — quotient rules, as per {{ quotient-with ntr }} homs
• -generate_aux_rules <true> — generate auxiliary rules or constructor arguments from {{ aux ... }} homs
• -aux_style_rules <true> — auxiliary rules (true) vs constructor arguments (false)
• -output_source_locations <0> — include source location info in output (0=none, 1=drules, 2=grammar+drules)
• -colour <true> — use (vt220) colour for ASCII pretty print 🌈
• -show_sort <false> — show ASCII pretty print of syntax
• -show_defns <false> — show ASCII pretty print defns
• -tex_show_meta <true> — include meta prods and rules in TeX output
• -tex_show_categories <false> — signal production flags in TeX output
• -tex_suppress_category <[]> — suppress productions and rules with this category in TeX output
• -tex_suppress_ntr <[]> — suppress nonterminal root in TeX output
• -tex_colour <true> — colour parse errors in TeX output
• -tex_wrap <true> — wrap TeX output in document pre/postamble
• -tex_name_prefix <string> — prefix for tex commands (default "ott")
• -isabelle_primrec <true> — use "primrec" instead of "fun" for functions
• -isabelle_inductive <true> — use "inductive" instead of "inductive_set" for relations
• -isa_syntax <false> — use fancy syntax in Isabelle output ✨
• -isa_generate_lemmas <false> — lemmas for collapsed functions in Isabelle
• -coq_avoid <1> — coq type-name avoidance (0=nothing, 1=avoid, 2=secondaryify)
• -coq_expand_list_types <false> — expand list types in Coq output
• -coq_lngen <false> — lngen compatibility
• -coq_names_in_rules <true> — copy user names in rule definitions
• -coq_use_filter_fn <false> — use list_filter instead of list_minus2 in substitutions
• -ocaml_include_terminals <false> — include terminals in OCaml output (experimental!)
• -ocaml_pp <target.ml filename> — generate OCaml AST pretty printer files (experimental!) (also included in .mly target)
• -ocaml_pp_ast_module — override default OCaml module name for AST module (experimental!)
• -ocaml_pp_json <false> — include JSON output in pretty printer (experimental)
• -pp_grammar — (debug) print term grammar
• -dot <filename> — (debug) dot graph of syntax dependencies
• -alltt <filename> — (debug) alltt output of single source file
• -sort <true> — (debug) do topological sort
• -process_defns <true> — (debug) process inductive reln definitions
• -showraw <false> — (debug) show raw grammar
• -ugly <false> — (debug) use ugly ASCII output 😭
• -no_rbcatn <true> — (debug) remove relevant bind clauses
• -lem_debug — (debug) print lem debug locations
• -help — display this list of options
• --help — display this list of options

---

tiny vibe check before you go: the -ocaml_* pretty-printer crew is marked experimental, and the (debug) gang is literally labelled debug, so don't act surprised when they act up 🙈

and that's the whole page bestie, you ate 🍓 go compile something gorgeous. this was Ott version 0.34, distribution ... June 2025 — mwah, periodt 👑💜