Return to buildtables.1 CVS log

Up to [Research Unix] / researchv10no / cmd / postscript / buildtables

Annotation of researchv10no/cmd/postscript/buildtables/buildtables.1, revision 1.1

1.1     ! root        1: .ds dF /usr/lib/font
        !             2: .ds dQ /usr/lib/postscript
        !             3: .TH BUILDTABLES 1 "DWB 3.2"
        !             4: .SH NAME
        !             5: .B buildtables
        !             6: \- build
        !             7: .B troff
        !             8: tables on a PostScript printer
        !             9: .SH SYNOPSIS
        !            10: \*(mBbuildtables\f1
        !            11: .OP "" options []
        !            12: .OP "" "name \(el" []
        !            13: .SH DESCRIPTION
        !            14: .B buildtables
        !            15: builds font width tables or the typesetter description
        !            16: file on a PostScript printer.
        !            17: No arguments means build a default set of tables;
        !            18: usually a superset of the LaserWriter Plus collection.
        !            19: The following
        !            20: .I options
        !            21: are understood:
        !            22: .TP 1.0i
        !            23: .OP \-b speed
        !            24: Transmit data over
        !            25: .I line
        !            26: at baud rate
        !            27: .I speed.
        !            28: Recognized baud rates are 1200, 2400, 4800, 9600, and 19200.
        !            29: The default
        !            30: .I speed
        !            31: is 9600 baud.
        !            32: .TP 1.0i
        !            33: .OP \-l line
        !            34: Build the tables on the PostScript printer attached to
        !            35: .I line.
        !            36: There is no default.
        !            37: .TP 1.0i
        !            38: .OP \-t name
        !            39: Use
        !            40: .I name
        !            41: as the template for fonts not in the default set.
        !            42: Choose
        !            43: .MW R
        !            44: for proportionally spaced fonts and
        !            45: .MW CW
        !            46: for fixed width fonts.
        !            47: Try
        !            48: .MW ZD
        !            49: (ZapfDingbats) if the font has a non-standard
        !            50: character set.
        !            51: The default is
        !            52: .MR R .
        !            53: .TP 1.0i
        !            54: .OP \-C file
        !            55: Copy
        !            56: .I file
        !            57: into each PostScript table program;
        !            58: .I file
        !            59: must contain legitimate PostScript.
        !            60: .TP 1.0i
        !            61: .OP \-H hostdir
        !            62: Use
        !            63: .I hostdir
        !            64: as the host-resident font directory.
        !            65: A file in
        !            66: .I hostdir
        !            67: that matches the name of the
        !            68: .B troff
        !            69: font is assumed to be a host-resident font program and is included
        !            70: in the PostScript width table program.
        !            71: There is no default.
        !            72: .TP 1.0i
        !            73: .OP \-S file
        !            74: Use
        !            75: .I file
        !            76: as the shell library file.
        !            77: Overrides the choice made with the
        !            78: .OP \-T
        !            79: option.
        !            80: .TP 1.0i
        !            81: .OP \-T name
        !            82: Set the target device to
        !            83: .I name.
        !            84: .br
        !            85: Device
        !            86: .I name
        !            87: means
        !            88: .ft 2
        !            89: .MI \*(dF/dev name /shell.lib
        !            90: .ft 1
        !            91: is the shell library file.
        !            92: There is no default.
        !            93: .PP
        !            94: If
        !            95: .OP \-l
        !            96: is omitted output files are the PostScript programs that
        !            97: build the tables, rather than the tables themselves.
        !            98: One of
        !            99: .OP \-T
        !           100: or
        !           101: .OP \-S
        !           102: is required.
        !           103: If both are given
        !           104: .OP \-S
        !           105: wins.
        !           106: Although
        !           107: .OP \-H
        !           108: is the preferred mechanism for including host-resident font files,
        !           109: .OP \-C
        !           110: makes sense when only one width table is built.
        !           111: .PP
        !           112: The shell library file defines a collection of functions used to
        !           113: build
        !           114: .BR troff (1)
        !           115: tables.
        !           116: The default set of tables is the list of names returned by the
        !           117: .MW AllTables
        !           118: function.
        !           119: Changes to the default list can be made by updating the
        !           120: .MW BuiltinTables
        !           121: function.
        !           122: .PP
        !           123: Each
        !           124: .B buildtables
        !           125: argument
        !           126: must be a default table name, or a pair of names enclosed in quotes.
        !           127: If the argument is a pair, the first name is the
        !           128: .B troff
        !           129: font and the second is the full PostScript font name.
        !           130: Tables are created in the current directory.
        !           131: Each is assigned a name that matches the
        !           132: .B troff
        !           133: table name.
        !           134: .PP
        !           135: The PostScript table programs created by
        !           136: .BR trofftable (1)
        !           137: are written to files that have
        !           138: .MW .ps
        !           139: appended to the
        !           140: .B troff
        !           141: table name.
        !           142: The
        !           143: .MW .ps
        !           144: file is deleted after the table is built.
        !           145: Options not listed above are passed to
        !           146: .B trofftable.
        !           147: The PostScript table programs return data to the host computer using
        !           148: PostScript's
        !           149: .MW print
        !           150: operator.
        !           151: See
        !           152: .BR hardcopy (1)
        !           153: if you do not have access to the printer's serial port.
        !           154: .SH EXAMPLES
        !           155: .PP
        !           156: Build the default collection of devpost tables on the printer
        !           157: connected to
        !           158: .MW /dev/tty00
        !           159: (no font name arguments):
        !           160: .EX
        !           161: buildtables -l/dev/tty00 -Tpost
        !           162: .EE
        !           163: To do the same and to restrict the tables that are built,
        !           164: Add
        !           165: .B troff
        !           166: font names (or
        !           167: .MR DESC )
        !           168: to restrict the tables built on the printer connected to
        !           169: .MR /dev/tty00 :
        !           170: .EX
        !           171: buildtables -l/dev/tty00 -Tpost R I B BI DESC S
        !           172: .EE
        !           173: Enclose the
        !           174: .B troff
        !           175: and PostScript font names in quotes to
        !           176: build the width table for a font not in the default set
        !           177: (also on the printer connected to
        !           178: .MR /dev/tty00 ):
        !           179: .EX
        !           180: buildtables -l/dev/tty00 -TLatin1 "GL Garamond-Light"
        !           181: .EE
        !           182: A font must be available on the printer when the table is built.
        !           183: Use
        !           184: .OP \-H
        !           185: or
        !           186: .OP \-C
        !           187: to include host-resident fonts.
        !           188: .SH WARNINGS
        !           189: .PP
        !           190: A width table will not build properly if the printer cannot access
        !           191: the PostScript font.
        !           192: .PP
        !           193: The
        !           194: .OP \-TLatin1
        !           195: option only works on PostScript printers that support the full
        !           196: .SM ISO
        !           197: Latin-1 character set.
        !           198: The error message from older printers will likely indicate a missing
        !           199: .MW ISOLatin1Encoding
        !           200: array.
        !           201: .SH FILES
        !           202: .MW \*(dF/dev*/shell.lib
        !           203: .br
        !           204: .MW \*(dQ/dpost.ps
        !           205: .br
        !           206: .MW \*(dQ/trofftable.ps
        !           207: .br
        !           208: .SH SEE ALSO
        !           209: .BR dpost (1),
        !           210: .BR hardcopy (1),
        !           211: .BR postio (1),
        !           212: .BR troff (1),
        !           213: .BR trofftable (1),
        !           214: .BR font (5)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.