.Dd February 7, 2014
.Dt LT-TRIM 1
.Os Apertium
.Sh NAME
.Nm lt-trim
.Nd compiled dictionary trimmer for Apertium
.Sh SYNOPSIS
.Nm lt-trim
.Ar analyser_binary
.Ar bidix_binary
.Ar trimmed_analyser_binary
.Sh DESCRIPTION
.Nm lt-trim
is the application responsible for trimming compiled dictionaries.
The analyses (right-side when compiling lr) of analyser_binary are trimmed
to the input side of bidix_binary (left-side when compiling lr,
right-side when compiling rl), such that only analyses which would
pass through
.So
.Xr lt-proc 1
.Fl b Cm bidix_binary
.Sc
are kept.
.Pp
.Sy Warning: this program is experimental!
It has been tested, but not deployed extensively yet.
.Pp
Both compound tags
.Po
.Dq <compound-only-L> ,
.Dq <compound-R>
.Pc
and join elements
.Po
.Dq <j/>
in XML,
.Dq +
in the stream
.Pc
and the group element
.Po
.Dq <g/>
in XML,
.Dq #
in the stream
.Pc
should be handled correctly,
even combinations of + followed by # in monodix are handled.
.Pp
Some minor caveats: If you have the capitalised lemma
.Dq Foo
in the monodix, but
.Dq foo
in the bidix, an analysis
.Dq \(a^Foo<tag>$
would pass through bidix when doing
.Xr lt-proc 1
.Fl b ,
but will not make it through trimming.
Make sure your lemmas have the same capitalisation in the
different dictionaries.
Also, you should not have literal
.Ql +
or
.Ql #
in your lemmas.
Since
.Xr lt-comp 1
doesn't escape these,
.Nm
cannot know that they are different from
.Dq <j/>
or
.Dq <g/> ,
and you may get @-marked output this way.
You can analyse
.Ql +
or
.Ql #
by having the literal symbol in the
.Dq <l>
part and some other string (e.g.,
.Dq plus )
in the
.Dq <r> .
.Pp
You should not trim a generator unless you have a
.Em very
simple translator pipeline,
since the output of bidix seldom goes unchanged through transfer.
.Sh FILES
.Bl -tag -width Ds
.It Ar analyser_binary
The untrimmed analyser dictionary (a finite state transducer).
.It Ar bidix_binary
The dictionary to use as trimmer (a finite state transducer).
.It Ar trimmed_analyser_binary
The trimmed analyser dictionary (a finite state transducer).
.El
.Sh SEE ALSO
.Xr apertium 1 ,
.Xr apertium-tagger 1 ,
.Xr lt-comp 1 ,
.Xr lt-expand 1 ,
.Xr lt-print 1 ,
.Xr lt-proc 1
.Sh AUTHOR
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!