Man Linux: Main Page and Category List

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