.Dd March 8, 2006
.Dt LT-COMP 1
.Os Apertium
.Sh NAME
.Nm lt-comp
.Nd augmented letter transducer compiler for Apertium
.Sh SYNOPSIS
.Nm lt-comp
.Op Fl a | v | l | r | m | h
.Cm lr | rl
.Ar dictionary_file
.Ar output_file
.Op Ar acx_file
.Sh DESCRIPTION
.Nm lt-comp
is the application responsible for compiling dictionaries used by
.Xr lt-proc 1
in Apertium into a compact and efficient representation
(a class of finite-state transducers called augmented letter transducers).
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl a , Fl Fl alt
Sets the value of the
.Sy alt
attribute to use in compilation.
.Pp
Note that if no value is set, all entries containing an \fIalt\fR
attribute are omitted.
.It Fl v , Fl Fl var
Sets the value of the
.Sy v
attribute to use in compilation.
This should only be used with monodixes; for bidixes, see
.Fl l
and
.Fl r .
.Pp
Note that if no value is set, all entries containing a
.Sy v
attribute are considered to be
.Em left-to-right .
.It Fl l , Fl Fl var-left
Sets the value of the
.Sy vl
attribute for use in compilation of bidixes.
.Dq Left
here refers to the side of the dictionary, so this option is only valid in
.Cm rl
mode.
.It Fl r , Fl Fl var-right
Sets the value of the
.Sy vr
attribute for use in compilation of bidixes.
.Dq Right
here refers to the side of the dictionary, so this option is only valid in
.Cm lr
mode.
.It Fl m , Fl Fl keep-boundaries
Keep any morpheme boundaries defined by the '<m/>' symbol
.It Fl H , Fl Fl hfst
expect HFST symbols
.It Fl S , Fl Fl no-split
don't attempt to split into word and punctuation transducers
.It Fl j , Fl Fl 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.
.It Fl h , Fl Fl help
Prints a short help message.
.It Cm lr
The resulting transducer will process dictionary entries
.Em left-to-right .
.It Cm rl
The resulting transducer will process dictionary entries
.Em right-to-left .
.El
.Sh FILES
.Bl -tag -width Ds
.It Ar dictionary_file
The input dictionary.
.It Ar output_file
The compiled dictionary (a finite state transducer).
.It Ar acx_file
Optional XML file of equivalent characters in monodices.
.El
.Sh SEE ALSO
.Xr apertium 1 ,
.Xr apertium-tagger 1 ,
.Xr lt-expand 1 ,
.Xr lt-proc 1
.Sh COPYRIGHT
Copyright \(co 2005, 2006 Universitat d'Alacant / Universidad de Alicante.
This is free software.
You may redistribute copies of it under the terms of
.Lk https://www.gnu.org/licenses/gpl.html the GNU General Public License .
.Sh BUGS
Many... lurking in the dark and waiting for you!