Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

hyphen_show(1) [debian man page]

hyphen_show(1)						      General Commands Manual						    hyphen_show(1)

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 (espe-
       cially 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_TeX-
       Menu, 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 encod-
		 ings 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

Version: 6							   May 28, 1997 						    hyphen_show(1)

Check Out this Related Man Page

DVITYPE(1)						      General Commands Manual							DVITYPE(1)

NAME

       dvitype, odvitype - translate a dvi file for humans

SYNOPSIS

       dvitype dvi_name[.dvi]

DESCRIPTION

       This manual page is not meant to be exhaustive.	The complete documentation for this version of TeX can be found in the info file or manual
       Web2C: A TeX implementation.

       The dvitype program translates a DVI (DeVice Independent) file output by (for example) tex(1) or gftodvi(1), to	a  file  that  humans  can
       read.  It also serves as a DVI file-validating program (i.e., if dvitype can read it, it's correct) and as an example of a DVI-reading pro-
       gram for future device drivers.

       The output file can include all commands, just the important ones, or none at all (in which case only errors are reported).  A  subinterval
       of  pages  may  be  selected  for transliteration; the magnification and resolution of the ``output device'' may be changed; and so on. All
       options are specified with an on-line dialog.

       The .dvi extension is supplied if omitted from dvi_name.  The output goes to stdout.

OPTIONS

       -dpi=REAL
	      Set resolution to REAL pixels per inch; default 300.0.

       -magnification=NUMBER
	      Override existing magnification with NUMBER.

       -max-pages=NUMBER
	      Process NUMBER pages; default one million.

       -output-level=NUMBER
	      Verbosity level, from 0 to 4; default 4.

       -page-start=PAGE-SPEC
	      Start at PAGE-SPEC, for example `2' or `5.*.-2'.

       -show-opcodes
	      Show numeric opcodes (in decimal).

ENVIRONMENT

       The environment variable TEXFONTS is used to search for the TFM files used in the DVI file.  See tex(1) for the details of  the	searching.
       If TEXFONTS is not set, it uses the system default.

SEE ALSO

       gftype(1), pktype(1).
       Donald E. Knuth, TeX for nroffware.

AUTHORS

       Donald E. Knuth wrote the program.  It was published as part of the TeX for nroffware technical report, available from the TeX Users Group.
       Howard Trickey and Pavel Curtis originally ported it to Unix.

Web2C 2012							 19 December 1994							DVITYPE(1)
Man Page