NAME

fstsymbols - manipulate FST symbol tables

SYNOPSIS

fstsymbols [OPTIONS] [in.fst [out.fst]]

DESCRIPTION

Performs operations (set, clear, relabel) on the symbol tables attached to an FST.

OPTIONS

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

--allow_negative_labels[=BOOLEAN]

Allow negative labels (not recommended; may cause conflicts). Default: false.

--clear_isymbols[=BOOLEAN]

Clear the input symbol table. Default: false.

--clear_osymbols[=BOOLEAN]

Clear the output symbol table. Default: false.

--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.

--isymbols=FILENAME

Set the input label symbol table. Default: "".

--osymbols=FILENAME

Set the output label symbol table. Default: "".

--relabel_ipairs=FILENAME

The input relabel pairs (numeric labels).

--relabel_opairs=FILENAME

The output relabel pairs (numeric labels).

--save_isymbols=FILENAME

Save FST file's input symbol table to file. Default: do not save.

--save_osymbols=FILENAME

Save FST file's output symbol table to file. Default: do not save.

--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.

--tmpdir=PATHNAME

Set the temporary directory to use. Default: /tmp.

--v[=N]

Set the verbosity level. Default: 0.

--verify[=BOOLEAN]

Verify FST properities before saving.

SEE ALSO

fstarcsort(1), fstclosure(1), fstcompile(1), fstcompose(1), fstcompress(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), fstsynchronize(1), fsttopsort(1), fstunion(1)