Copyright (C) 1997  G. Lamprecht, W. Lotz, R. Weibezahn; IWD, Bremen University


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.


The program hyphen_show may be used and copied under the conditions of the
(added) GNU GENERAL PUBLIC LICENSE,
the Copyright must not be deleted or modified.

IN NO EVENT SHALL THE LRW/IWD BE LIABLE TO ANY PARTY FOR
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE LRW
HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE LRW/IWD SPECIFICALLY DISCLAIMS ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
ON AN "AS IS" BASIS, AND THE LRW/IWD NO OBLIGATION TO
PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

You may get hyphen_show  directly from the authors 
 (anonymous, password: RFC-conform e-mail address):
 ftp://ftp.iwd.uni-bremen.de/pub/tex/xtem/hyphenation/
or
 WWW:   http://www.iwd.uni-bremen.de/xtem/xtem_texmenu.html



Installation (if not done by "xteminstall" -- xtem's installation procedure): 

for system dependent compilation, link calls etc. see file hyphen_show.c.
for tests and implememntation on various systems we are much obliged to:

   AIX (gcc, xlc)
             Gerlinde Kettl, University of Regensburg

   OpenVMS (cc, decc)    
	     Volker Schaa, Gesellschaft f. Schwerionenforschung (GSI), Darmstadt

   BORLAND-C 
	     Wolfram Liebchen, Forschungsinstitut fuer Optik

we (the authors) developed and tested this program with:
 
   Sun SOLARIS 2.5 (gcc, cc)

   Linux  (gcc)


1. compile program, e.g.:

     gcc  hyphen_show.c  -o hyphen_show


2. test program, e.g.:

     hyphen_show  test.dvi
					(or use any other .dvi-file)


3. install program, e.g.:

     mv  hyphen_show  -c OT1  /usr/local/bin/hyphen_show


4. install man-page or hlp-file, e.g.:

    cp  hyphen_show.1  /usr/local/man/man1/hyphen_show.1
  or
    LIBRARY/INSERT/HELP  DECUS[.HLB]  HYPHEN_SHOW[.HLP


In case of errors etc. give us a message:

    weibezahn@iwd.uni-bremen.de

Authors: Guenther Lamprecht, Wolfhard Lotz, Roland Weibezahn
