hyphen_show(1)

✨ hyphen_show(1) ✨

okay bestie, so this is a page from the General Commands Manual and it's all about hyphen_show — a lil program that hunts down hyphenations for you. let's get into it 💖

---

🌸 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 ]

(yeah the original really does wrap that bracket onto its own line, we keep it exactly like that, no notes 💅)

---

💜 DESCRIPTION 💜

hyphen_show is a program (written in C language, she's a classic 👑) which looks for hyphenations in a .dvi-file created by TeX/LaTeX.

Here's the tea though: there is no line structure in the .dvi-file, so line breakings have to be concluded from horizontal and vertical gaps. 😭 And look, there are constructs where hyphenations cannot be found at all, 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. it's giving "blame the layout, not the girl" fr fr.

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). no dupes, no drama ✨

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. so DIY-friendly, we love a low-maintenance queen 🫶

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. so she's got main character energy and a day job 💅

---

🦋 DOCUMENTATION 🦋

For the implementator a README is included in the package. (yes, for the implementator — that's the original spelling, we respect the heritage 🙈)

---

✨ 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. 👑

that's literally the whole option list. one option. she said "I need exactly one flag and it's perfect." iconic 💖

---

🌈 FILES 🌈

• texfilename.dvi — this file is scanned for hyphenations (must exist). no file, no vibes, sorry bestie 😭
• 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). ⚠️ yes she will absolutely overwrite it, so don't come crying later, back up your stuff fr fr

---

🌟 SOURCES 🌟

hyphen_show.c may be copied by anonymous ftp from

ftp://ftp.iwd.uni-bremen.de:/pub/tex/hyphenation/

go get your girl 💅

---

👑 AUTHORS 👑

Guenther Lamprecht, Wolfhard Lotz, Roland Weibezahn — legends, all three of them 💜

• e-mail: weibezahn@iwd.uni-bremen.de
• www: http://ftp.iwd.uni-bremen.de/xtem/xtem_texmenu.html

---

and that's the whole page, bestie. go hyphenate responsibly 🎀

Version: 6 — May 28, 1997 💖 that's the version and the date, straight from the footer, mwah 😘 ✨🌸🦋