/usr/share/doc/hyphen-show/README is in hyphen-show 20000425-3+b1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | 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
|