.TH sylseg-sk 1  "December 1, 2006" "version 0.5" "USER COMMANDS"
.SH NAME
sylseg-sk \- segments a Slovak words in to the sylables
.SH SYNOPSIS
.B sylseg-sk
[\-\-best] [\-\-color] [\-\-dl debug level] [\-\-help] [\-\-ofile <file_name>] 
[<input_file>]
.SH DESCRIPTION
The sylabic segmentation is esential for some linguistic or speech
recognition applications. Depending on the language either rule based
or statistical approach is beying used. For Slovak the statistical
approach seems to be more suitable.
.PP
sylseg-sk implements one of the statistical approaches for the syllabic
segmentaion. Each input word is segmented into the syllables.
The several possible segmentations are generated and sorted
by the likelihood. If no input file is specified, the standard input
is expected. If input file is used then the output is written in to
the file as well. The filename is input filename with the extension 
".syllables".
.PP
The input output code page is ISO 8859-2. To use it with different CP
use some CP convertor and pipes. For example to have input and output
in UTF-8 use (for interactive use): 
.B filterm  UTF8-iso2 iso2-UTF8 sylseg-sk
or (for batch processing)
.B iconv -f UTF-8 -t ISO_8859-2 | sylseg-sk | iconv -f ISO_8859-2 -t UTF-8
.PP
Performance of the syllabic segmentation depend on the used statistics.
To improve the quality of the segmentaion is possible to train the better
system with the sylseg-sk-training tool and replace the original file
located in /usr/share/sylseg_sk/sylseg-sk.stats 
.PP
The design of the sylseg-sk is language independent. With retrained 
statistics it theoreticaly should work for any language. 
.SH OPTIONS
.TP
\-\-best
Print the best result only.
.TP
\-\-color
Enable color output.
.TP
\-\-dl 1..5
Set the debug level. Control the amount of displayed information
The debug level 0 displays nothing. The maximum level 5 displays full
debugging report. The default debug level is 1.
.TP
\-\-help
display a short help text
.TP
\-\-ofile <file_name>
Write output also in to given file.
.SH EXAMPLES
.TP
Use standard input and debug level 3:
.B sylseg-sk
\-\-dl 3
.PP
.TP
Process all the from file aaa.txt and print just the best segmentation:
.B sylseg-sk
\-\-best aaa.txt
.PP
.SH EXIT STATUS
sylseg-sk returns a zero if it succeeds to process all the input words
.SH AUTHOR
Jozef Ivanecky (dodo (at) kanoistika.sk)
.SH SEE ALSO
sylseg-sk-training(1), filterm(1), iconv(1), konwert(1)