LT-COMP(1)

💖 lt-comp — the Apertium dictionary compiler, bestie edition 💖

okay so this is the lt-comp(1) page from the General Commands Manual, and I'm about to make it make sense for you. sit down, hydrate, let's go 🫶

✨ NAME ✨

lt-comp — augmented letter transducer compiler for Apertium. yes it's a mouthful, no you don't have to say it out loud at parties.

✨ SYNOPSIS ✨

lt-comp [-a | -v | -l | -r | -m | -h] lr | rl dictionary_file
        output_file [acx_file]

look at that little command. so small. so powerful. 🎀

✨ DESCRIPTION ✨

lt-comp is the application that compiles the dictionaries lt-proc(1) uses in Apertium into a compact and efficient representation. the vibe? a whole class of finite-state transducers called augmented letter transducers. that's the glow-up. that's the transformation arc. 🔥

✨ OPTIONS ✨

• -a, --alt — sets the value of the alt attribute to use in compilation. 💅 heads up though: if you set no value, every entry that has an alt attribute gets omitted. gone. not invited. no cap.
• -v, --var — sets the value of the v attribute to use in compilation. this one is monodixes only, bestie — for bidixes you want -l and -r instead, scroll down. and note: if no value is set, every entry with a v attribute is considered left-to-right.
• -l, --var-left — sets the value of the vl attribute for use in compilation of bidixes. "Left" here means the side of the dictionary, so this option is only valid in rl mode. periodt.
• -r, --var-right — sets the value of the vr attribute for use in compilation of bidixes. "Right" here means the side of the dictionary, so this option is only valid in lr mode. twin of the one above, opposite energy. 🦋
• -m, --keep-boundaries — keep any morpheme boundaries defined by the '<m/>' symbol. don't let them get lost in the shuffle. 🙈
• -H, --hfst — expect HFST symbols.
• -S, --no-split — don't attempt to split into word and punctuation transducers. sometimes you just want to leave things whole, yk?
• -j, --jobs — parallelise minimisation by using one cpu core per section. 🌈 by default, this also creates a new section after 50.000 entries. you can override this number by setting the environment variable LT_MAX_SECTION_ENTRIES to some number. if set to 0, sections are never split (but kept exactly as in the dix file). you can also set the environment variable LT_JOBS=true if you always want parallel minimisation even if lt-comp was called without this option. main character energy fr fr.
• -h, --help — prints a short help message. iconic behaviour.
• lr — the resulting transducer will process dictionary entries left-to-right. ➡️
• rl — the resulting transducer will process dictionary entries right-to-left. ⬅️

✨ FILES ✨

• dictionary_file — the input dictionary. the raw material. the before picture. ✨
• output_file — the compiled dictionary (a finite state transducer). the after picture. 💅
• acx_file — optional XML file of equivalent characters in monodices.

✨ SEE ALSO ✨

apertium(1), apertium-tagger(1), lt-expand(1), lt-proc(1)

the friend group. the ensemble cast. go say hi to all of them. 🫶

✨ COPYRIGHT ✨

Copyright © 2005, 2006 Universitat d'Alacant / Universidad de Alicante. This is free software. You may redistribute copies of it under the terms of the GNU General Public License: https://www.gnu.org/licenses/gpl.html.

✨ BUGS ✨

Many... lurking in the dark and waiting for you! 💀

not me warning you about the bugs like they're the monster under the bed. they are though. they literally are. 😭

apertium made this one, the manual page is dated March 8, 2006, and that's the whole thing bestie — go compile something cute. 💖🌸🦋