FARCONVERT(1)

✨ NAME ✨

farconvert — the manual page for farconvert 1.8.4, bestie. Section 1, user commands, main character energy 💅

---

🦋 DESCRIPTION 🦋

okay so. farconvert converts FST and container types. that's the whole vibe. it takes one kind of thing and turns it into another kind of thing, no cap ✨

Here's how you actually call it:

Usage: farconvert [in.far [out.far]]

so like, you can hand it an input and an output, or just vibe and let it do its thing with defaults 🫶

---

🌸 PROGRAM FLAGS 🌸

• --far_type — type = std::string, default = "default". FAR file format type, and it's gotta be one of: "default", "fst", "stlist", "sttable". if you leave it as "default" it just uses the input FAR type, which is lowkey the polite thing to do 💖
• --fst_type — type = std::string, default = "". Output FST type. that's it, that's the flag 🌈

---

🎀 LIBRARY FLAGS 🎀

Flags from: compile-strings.cc

• --far_field_separator — type = std::string, default = the literal newline character, shown here exactly as the page has it:

--far_field_separator: type = std::string, default = "
"

Set of characters used as a separator between printed fields. yes the default is literally a line break, she contains multitudes 🙈

Flags from: flags.cc

• --help — type = bool, default = false. show usage information 👑
• --helpshort — type = bool, default = false. show brief usage information (the tl;dr version, we love her)
• --tmpdir — type = std::string, default = "/tmp". temporary directory
• --v — type = int32_t, default = 0. verbosity level. crank it up if you want the tea ☕

Flags from: fst.cc

• --fst_align — type = bool, default = false. Write FST data aligned where appropriate
• --fst_default_cache_gc — type = bool, default = true. Enable garbage collection of cache 🧹
• --fst_default_cache_gc_limit — type = int64_t, default = 1048576. Cache byte size that triggers garbage collection. that's one mebibyte for the number girlies 💜
• --fst_read_mode — type = std::string, default = "read". Default file reading mode for mappable files
• --fst_verify_properties — type = bool, default = false. Verify FST properties queried by TestProperties
• --save_relabel_ipairs — type = std::string, default = "". Save input relabel pairs to file
• --save_relabel_opairs — type = std::string, default = "". Save output relabel pairs to file

Flags from: symbol-table.cc

• --fst_compat_symbols — type = bool, default = true. Require symbol tables to match when appropriate. she's a little demanding but honestly valid 🫶
• --fst_field_separator — type = std::string, default = " ". Set of characters used as a separator between printed fields. (yes, that's nine whole spaces in there, iconic)

Flags from: util.cc

• --fst_error_fatal — type = bool, default = true. FST errors are fatal; o.w. return objects flagged as bad: e.g., FSTs: kError property set, FST weights: not a Member(). so like, by default an error is a whole dramatic thing 💀

Flags from: weight.cc

• --fst_weight_parentheses — type = std::string, default = "". Characters enclosing the first weight of a printed composite weight (e.g., pair weight, tuple weight and derived classes) to ensure proper I/O of nested composite weights; must have size 0 (none) or 2 (open and close parenthesis). so it's none-or-both, no in-between situationships ✋
• --fst_weight_separator — type = std::string, default = ",". Character separator between printed composite weights; must be a single character. ONE. character. periodt 💅

---

no cap, that's every single flag on the page. nothing skipped, nothing invented, all facts intact 🦋

---

and that's the whole page, bestie!! this was farconvert 1.8.4, from July 2018, and the original footer called it FARCONVERT(1) at the bottom. go forth and convert some FSTs, you absolute legend 👑✨🌸