.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
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 OPTIONS
.Bl -tag -width Ds
.It Fl s , Fl Fl match-section
A section with this name (id@type) in the analyser will only be
trimmed against a section with the same id in the bidix. (The default
is to trim all sections of the analyser against all sections of the
bidix.) Using this option can some times speed up trimming
considerably. For example, if you have some complicated regular
expressions, try putting them in a

  <section id="regex" type="standard">

in both .dix files and passing
.Dq regex@standard
to \fI--match-section\fP.
.Pp
This argument may be used multiple times to specify multiple sections
that must match by name.
.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!