ref: 9861f1a92b373a16939fd6f3c167e5dad9f253d3
dir: /sys/src/cmd/postscript/trofftable/trofftable.1.man/
.ds dF /sys/lib/troff/font .ds dQ /sys/lib/postscript/prologues .TH TROFFTABLE 1 .SH NAME trofftable \- output a PostScript program that builds a font width table .SH SYNOPSIS .B trofftable [ .B -t .I name ] [ .B -C .I file ] [ .B -H .I hostdir ] [ .B -L .I file ] [ .B -S .I file ] [ .B -T .I name ] .I shortname [ .I longname ] .SH DESCRIPTION .I Trofftable writes a PostScript program on the standard output that builds a font width table or typesetter description file. The following options are understood: .TP .BI -t " name" Use .I name as the template for fonts not in the default set. Choose .B R for proportionally spaced fonts and .B CW for fixed width fonts. Try .B ZD (ZapfDingbats) if the font has a non-standard character set. The default is .BR R . .TP .BI -C " file" Copy .I file into each PostScript table program; .I file must contain legitimate PostScript. .TP .BI -H " hostdir" Use .I hostdir as the host resident font directory. A file in .I hostdir that matches the name of the troff font is assumed to be a host resident font program and is included in the PostScript width table program. There is no default. .TP .BI -L " file" Use .I file as the PostScript prologue. .br The default is .B \*(dQ/trofftable.ps .TP .BI -S " file" Use .I file as the shell library file. Overrides the choice made with the .B -T option. .TP .BI -T " name" Set the target device to .IR name . Device .I name means .br .BI \*(dF/dev name /shell.lib is the shell library file. There is no default. .PP One of .B -T or .B -S is required. If both are given .B -S wins. Either .B -H or .B -C can be used to include a host resident font. .PP The shell library file defines a collection of functions used to build troff tables. The default set of tables is the list of names returned by the .B AllTables function. Changes to the default list can be made by updating the .B BuiltinTables function. .PP .I Shortname is the name of the .B troff font and .I longname is the name of the PostScript font; .I longname can be omitted only if .I shortname is a default table name. PostScript table programs created by .I trofftable return data to the host computer using PostScript's .B print operator. See .IR hardcopy (1) if you don't have access to the printer's serial port. .SH EXAMPLES Get the PostScript program that builds a width table for font .BR R : .EX trofftable -Tpost R >R.ps .EE If a font is not in the default set include the .B troff and PostScript font names: .EX trofftable -TLatin1 GL Garamond-Light >GL.ps .EE A font must be available on the printer when the table is built. Use .B -H or .B -C to include host resident fonts. .SH WARNINGS A width table will not build properly if the printer cannot access the PostScript font. .PP The .B -TLatin1 option only works on PostScript printers that support the full .SM ISO Latin-1 character set. The error message from older printers will likely indicate a missing .B ISOLatin1Encoding array. .SH FILES .B \*(dF/dev*/shell.lib .br .B \*(dQ/dpost.ps .br .B \*(dQ/trofftable.ps .SH SEE ALSO .IR dpost (1), .IR hardcopy (1), .IR postio (1), .IR troff (1), .IR buildtables (1), .IR font (5)