---
name: "hyphen_show"
section: "1"
platform: "linux"
package: "hyphen-show"
version: "20000425-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hyphen_show"
---

# hyphen\_show(1)

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

## 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