fstarcsort(1)

💅 fstarcsort(1) — the Unix manual page, but make it cute

okay bestie, gather round, because this is fstarcsort, a real one from the User Commands corner of your friendly neighbourhood manual. no cap, she's a little queen and she Does One Thing. 🎀

---

✨ NAME ✨

fstarcsort — sort arcs of an FST 🦋

---

🌸 SYNOPSIS 🌸

fstarcsort [OPTIONS] [in.fst [out.fst]]

like, that's it. options go first, then optionally where to read from and where to write to. iconic honestly. ✨

---

🫶 DESCRIPTION 🫶

Sorts arcs of an FST. 💖

(that's the whole thing. she sorts. she serves. periodt. 👑)

---

🌈 OPTIONS 🌈

okay so first, the whole rules-of-the-game thing for the booleans, and this is lowkey important:

Boolean options accept either true or false as a value, or the implicit value true if neither value is specified. 💅

so like, if you just say the flag with no value at all, it's a yes. noted. now the full menu:

• --fst_align[=BOOLEAN] — write FST data aligned where appropriate. Default: false.
• --fst_compat_symbols[=BOOLEAN] — require symbol tables to match when appropriate. Default: true.
• --fst_default_cache_gc[=BOOLEAN] — enable garbage collection of cache. Default: true.
• --fst_default_cache_gc_limit=N — set the cache byte size that triggers garbage collection. Default: 1048576.
• --fst_error_fatal[=BOOLEAN] — if true, FST errors are fatal. Otherwise, returned objects are flagged as bad. For example, FSTs are returned with the kError property set to true, and FST weights set so that Member() returns false. Default: true. 🚨
• --fst_field_separator=STRING — set the characters used as a separator between printed fields. Default: " ".
• --fst_read_mode=STRING — set the default file reading mode for mappable files, either "read" or "map". Default: "read".
• --fst_verify_properties[=BOOLEAN] — verify fst properties queried by TestProperties. Default: false.
• --fst_weight_parentheses=STRING — set the 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). Default: no parentheses.
• --fst_weight_separator=CHARACTER — set the character separator between printed composite weights. Default: comma.
• --help[=BOOLEAN] — show usage information. Default: false. 🆘
• --helpshort[=BOOLEAN] — show brief usage information. Default: false.
• --save_relabel_ipairs=FILENAME — save input relabel pairs to file. Default: do not save.
• --save_relabel_opairs=FILENAME — save output relabel pairs to file. Default: do not save.
• --sort_type=TYPE — set the comparison method, either ilabel or olabel. Default: ilabel. ⭐ (this is the whole personality of the tool btw, iykyk)
• --tmpdir=PATHNAME — set the temporary directory to use. Default: /tmp.
• --v[=N] — set the verbosity level. Default: 0. 🗣️

---

👀 SEE ALSO 👀

the whole friend group, fr fr — go say hi to all of them:

fstclosure(1), fstcompile(1), fstcompose(1), fstconcat(1), fstconnect(1), fstconvert(1), fstdeterminize(1), fstdifference(1), fstdisambiguate(1), fstdraw(1), fstencode(1), fstepsnormalize(1), fstequal(1), fstequivalent(1), fstinfo(1), fstintersect(1), fstinvert(1), fstisomorphic(1), fstlinear(1), fstloglinearapply(1), fstmap(1), fstminimize(1), fstprint(1), fstproject(1), fstprune(1), fstpush(1), fstrandgen(1), fstrelabel(1), fstreplace(1), fstreverse(1), fstreweight(1), fstrmepsilon(1), fstshortestdistance(1), fstshortestpath(1), fstsymbols(1), fstsynchronize(1), fsttopsort(1), fstunion(1)

---

💖 and that's the page!! this was OpenFst version 1.8.5, dated Mar 2026. drink water, sort your arcs, love yourself. mwah. 🧚💜