README2 for troff2lj

July 27, 1988

This package contains my extensions to Sverre's program for using
arbitrary LaserJet soft fonts.  Programs to download LaserJet soft
fonts to the printer (download), to install LaserJet fonts as troff
fonts (installfont), and to analyze LaserJet soft fonts (dumpfont) are
also provided.

Installation

A new directory must be made to hold troff2lj configuration files, one
for each font except the special font (font S).  The default name for
that directory is /usr/lib/hpfontinfo.  You can change it by editing
hpconfig.h and installfont.sh.

You may have to edit the typedefs in hpconfig.h.  Also, compile with
LOHI defined if your machine stores integers low byte first (like a
VAX, unlike a 680x0).

In order for dewidth and ccfinfo to operate correctly, the size of the
object file headers on your system must be set correctly.  By default,
the size of the struct exec defined in <a.out.h> is used.  If
necessary, you can define HDRBYTES manually when compiling dewidth.c.

Watch out for soft fonts that have a null entry in the "symbol set"
field of their font descriptor; troff2lj expects soft fonts to use the
USASCII symbol set.  Use dumpfont to check this out, and if necessary,
use a binary file editor to change the value of that byte to a 21 decimal
(the encoded form of "0U", the selector for USASCII).

You might have problems using the Courier and Line Printer typefaces
which are built into the LaserJets, particularly if (like me) you have
an Elite font cartridge installed.  I think this is because troff2lj is
set up for proportionally spaced fonts, and thus ignores pitch
selection.  You could use the standard troff /usr/lib/font/ftCW file as
the width table and make fiXX (HPfontinfo) files by hand, but because
of the order that font attributes are checked to determine font
selection, you might get the wrong font.  If you have problems, you
could use nroff instead.

Comments On Macro Packages

You'll need to grep through your macro packages and change any ".lg"
statements to ".lg 0", since the LaserJet fonts don't contain
ligatures.  I was missing "ff"'s and "fi"'s in my manual page printouts
until I discovered a ".lg" statement in my -man macros.

Also, I suggest that you go through your macro packages and remove the
instructions that put in the typesetter cut marks, since they show up on
the LaserJet as an ugly dash in the corner of the page.  Usually you
will need to edit a ".tl" command to remove either "--" (as in the -ms
macros) or "\l..." (as in the -man macros).  Just replace them with null
arguments.

If for some reason you want to print out manual pages in a font that
you don't have in 10 point, you can set the -man macros' number
registers to select a different font size.  For example, to use 18
point type (with 20 point vertical spacing), put at the top of the
troff source file:

.nr )S 18
.nr )V 20

Check the MANIFEST for a full listing of the included files.

David MacKenzie
Environmental Defense Fund
edf@rocky2.rockefeller.edu (...rutgers!cmcl2!rocky2!edf).
