.TH hyphen_show 1 "May 28, 1997" "Version: 6"
.SH NAME
\fBhyphen_show\fP \- a program to look for hyphenations in a .dvi-file 
created by TeX/LaTeX
.SH SYNTAX
\fBhyphen_show\fP  [ \fB-c\fI fontencoding\fP ]  \fItexfilename\fP[\fB.dvi\fP]  [ \fIfile_checked_hyphenations\fP ]
.SH DESCRIPTION
\fBhyphen_show\fP is a program (written in C language) which looks for 
hyphenations in a .dvi-file created by TeX/LaTeX.
.LP
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.)
.LP
On standard output you will find a list of hyphenations found  together with 
page numbers, both extracted from \fItexfilename\fB.dvi\fR.
In file \fItexfilename\fB.hyp\fR the user will find hyphenations only.
.LP
Each hyphenation is included only at it's first occurence and only if it's 
not already found in file \fIfile_checked_hyphenations\fP 
(if such a second file is specified at \fBhyphen_show\fP call).
.LP
Files \fItexfilename\fB.hyp\fR and \fIfile_checked_hyphenations\fR 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 \fItexfilename\fB.hyp\fR to file 
\fIfile_checked_hyphenations\fR e.g. by using \fBcat\fR command.
.LP
Program \fBhyphen_show\fR can be called as stand-alone program as described 
ahead; yet originally \fBhyphen_show\fR was written for use with 
\fBxtem_TeXMenu\fR, where it is started automatically 
(depending on the user's settings) after each TeX run
or where it can be started explicitely as an \fBxtem\fR utility program.
.SH DOCUMENTATION
For the implementator a README is included in the package.
.SH OPTIONS
.TP 10
.B -c\fI fontencoding\fP
specifies the font encoding which is used in TeX
(\\usepackage[\fIfontencoding\fP]{fontenc}).
At the moment the following font encodings are available:
T1 and OT1, i.e. \fIfontencoding\fP may get one of these values:
\fBT1\fP or \fBOT1\fP.
The default value is set to T1, yet can be adapted by the local implementation.
.SH FILES
.TP 10
.B \fItexfilename\fB.dvi
this file is scanned for hyphenations (must exist).
.TP
.B \fIfile_checked_hyphenations\fP
if specified, this file will be scanned for correct (`checked') hyphenations.
.TP
.B \fItexfilename\fB.hyp
all hyphenations found in \fItexfilename\fB.dvi\fR and not included in 
\fIfile_checked_hyphenations\fR up to now will be written into this file 
(will be created/overwritten).
.SH SOURCES
\fBhyphen_show.c\fP may be copied by anonymous ftp from
.ti +5
\fBftp://ftp.iwd.uni-bremen.de:/pub/tex/hyphenation/\fP
.SH AUTHORS
Guenther Lamprecht, Wolfhard Lotz, Roland Weibezahn
.br 
e-mail: weibezahn@iwd.uni-bremen.de
.br 
www: http://ftp.iwd.uni-bremen.de/xtem/xtem_texmenu.html