NAME

       hyphen_show - a program to look for hyphenations in a .dvi-file created by TeX/LaTeX

SYNTAX

       hyphen_show  [ -c fontencoding ]  texfilename[.dvi]  [ file_checked_hyphenations ]

DESCRIPTION

       hyphen_show  is  a program (written in C language) which looks for hyphenations in a .dvi-file created by
       TeX/LaTeX.

       As there is no line structure in the .dvi-file, line breakings must  be  concluded  from  horizontal  and
       vertical gaps.  There are constructs, where hyphenations cannot be found, and there are constructs, where
       we cannot extract correctly both fragments of an hyphenated word (especially at end of page,  because  of
       following footers, footnotes, running title etc.)

       On standard output you will find a list of hyphenations found  together with page numbers, both extracted
       from texfilename.dvi.  In file texfilename.hyp the user will find hyphenations only.

       Each hyphenation is included only at it's first occurence and only if it's  not  already  found  in  file
       file_checked_hyphenations (if such a second file is specified at hyphen_show call).

       Files texfilename.hyp and file_checked_hyphenations have the same structure and are simple text files, so
       the user can easily edit each of these files (especially delete lines with  incorrect  hyphenations)  and
       append file texfilename.hyp to file file_checked_hyphenations e.g. by using cat command.

       Program  hyphen_show  can be called as stand-alone program as described ahead; yet originally hyphen_show
       was written for use with xtem_TeXMenu, where  it  is  started  automatically  (depending  on  the  user's
       settings) after each TeX run or where it can be started explicitely as an xtem utility program.

DOCUMENTATION

       For the implementator a README is included in the package.

OPTIONS

       -c fontencoding
                 specifies  the font encoding which is used in TeX (\usepackage[fontencoding]{fontenc}).  At the
                 moment the following font encodings are available: T1 and OT1, i.e. fontencoding may get one of
                 these  values:  T1  or  OT1.   The  default value is set to T1, yet can be adapted by the local
                 implementation.

FILES

       texfilename.dvi
                 this file is scanned for hyphenations (must exist).

       file_checked_hyphenations
                 if specified, this file will be scanned for correct (`checked') hyphenations.

       texfilename.hyp
                 all hyphenations found in texfilename.dvi and not included in file_checked_hyphenations  up  to
                 now will be written into this file (will be created/overwritten).

SOURCES

       hyphen_show.c may be copied by anonymous ftp from
            ftp://ftp.iwd.uni-bremen.de:/pub/tex/hyphenation/

AUTHORS

       Guenther Lamprecht, Wolfhard Lotz, Roland Weibezahn
       e-mail: weibezahn@iwd.uni-bremen.de
       www: http://ftp.iwd.uni-bremen.de/xtem/xtem_texmenu.html