NAME

       swath - General-purpose Thai word segmentation utility

SYNOPSIS

       swath [options] < infile > outfile

DESCRIPTION

       Thai  script  has  no  word delimitor.  Applications need to recognize word boundaries before they can do
       useful things with Thai text, such as line wrapping.

       Swath provides word analysis filter to insert word delimitors into a given text stream.   It  reads  text
       from  standard  input,  analyzes  it  for  word boundaries by consulting a Thai word list, and outputs to
       standard output the same text with the predefined word delimitors inserted.

       Currently, it can read plain text, HTML, RTF, LaTeX and Lambda  (Unicode  version  of  LaTeX  with  Omega
       typesetter kernel) documents and insert common word delimitors for each format (pipe `|' for plain text).
       But user can always override this with a preferred delimitor.

OPTIONS

       -b [delimitor]
              Define the string to be inserted as word delimitor in the output text.

       -d [dict-path]
              Specify alternative dictionary location.  dict-path must be  either  a  directory  containing  the
              swath  dictionary  file  `swathdic.tri',  or a path to the dictionary file itself.  The dictionary
              file must be a trie file prepared using trietool(1) utility from the libdatrie package.

              If this option is given, swath will override normal dictionary search and will exit if  the  given
              dictionary  cannot  be  found.   Otherwise,  if  SWATHDICT environment is set, it will try to open
              dictionary from the location specified by its value.  Otherwise, it will try the  current  working
              directory, and finally the usual installed location.

       -f [format]
              Specify format of the input.  Possible formats are: html, rtf, latex, lambda.

       -m [scheme]
              Choose  word  matching  scheme  when  analyzing word boundaries.  Possible schemes are `long' (for
              longest or greedy matching) and `max' (for maximal matching, with least words preferred).  Maximal
              matching is the default value.

       -u input-enc,output-enc
              Specify  encodings  of  the input and the output.  input-enc and output-enc can be one of 'u' (for
              UTF-8 encoding) and 't' (for TIS-620 encoding).  Swath will  convert  the  character  encoding  as
              necessary.  If this option is omitted, TIS-620 encodings on both input and output are assumed.

       -v, --verbose
              Turn on verbose mode.

       -help, --help
              Show help.

ENVIRONMENT VARIABLES

       SWATHDICT
              If specified, swath will search for dictionary from this location before the usual places (current
              working directory and usual installed directory, respectively).  This value is  overridden  by  -d
              option.

EXAMPLES

       For LaTeX (to be used with babel-thai package):

       $ swath -f latex < thaifile.tex > thaifile.ttex
       $ latex thaifile.ttex

       For  HTML  (to  provide  web  pages to web browsers that cannot wrap Thai lines properly, but support the
       <wbr> tag):

       $ swath -f html < myweb.html > myweb-wbr.html

       To preprocess a Thai UTF-8 encoded LaTeX file for babel-thai with tis620 inputenc:

       $ swath -f latex -u u,t < thaifile.tex > thaifile.ttex
       $ latex thaifile.ttex

       This is equivalent to filtering with iconv(1):

       $ iconv -f UTF-8 -t TIS-620 thaifile.tex | swath -f latex > thaifile.ttex
       $ latex thaifile.ttex

       To use longest matching scheme with LaTeX document:

       $ swath -f latex -m long < thaifile.tex > thaifile.ttex
       $ latex thaifile.ttex

       To use an alternative dictionary from libthai:

       $ swath -f latex -d /usr/share/libthai/thbrk.tri < thaifile.tex > thaifile.ttex

AUTHOR

       This manual page was written by Theppitak Karoonboonyanan <theppitak@gmail.com>.

                                                  January 2008                                          SWATH(1)