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)