1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License, Version 1.0 only
6# (the "License").  You may not use this file except in compliance
7# with the License.
8#
9# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10# or http://www.opensolaris.org/os/licensing.
11# See the License for the specific language governing permissions
12# and limitations under the License.
13#
14# When distributing Covered Code, include this CDDL HEADER in each
15# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16# If applicable, add the following below this CDDL HEADER, with the
17# fields enclosed by brackets "[]" replaced with your own identifying
18# information: Portions Copyright [yyyy] [name of copyright owner]
19#
20# CDDL HEADER END
21#
22
23Source code for a program that translates device independent troff output into
24PostScript.
25
26Several new text encoding schemes, based on widthshow, have been added. Each can
27be accessed using the -e option and often reduce print time by 20% or more. Level
280 is the slowest but most stable choice. Level 2 encoding (which right now is the
29default) is fast and does a good job placing text and justifying the right margin.
30You can change the default encoding scheme by adjusting the definition of ENCODING
31in ../Makefile. Levels 0, 1, and 2 are the only reasonable defaults, but at present
32only level 0 is guaranteed. The new encoding schemes are not thoroughly tested,
33but passed the tests I ran.
34
35Other interesting features include color support, the ability to treat complex
36paths built from the standard drawing commands as single entities (eg. for filling
37a polygon with a color), and reverse video printing as a special case of color.
38Also added, although using it is far from trivial, is the ability to set text
39along an arbitrary baseline (see ../postscript/baseline.ps). All are accessed via
40special device control escapes (from routine devcntrl() in dpost.c).
41
42ASCII font and description files for many standard PostScript fonts can be found
43in ../font/devpost. They should be installed in /usr/lib/font/devpost, and are
44read when you add the -Tpost option to troff. A typical command line would be,
45
46    pic file | tbl | eqn | troff -mm -Tpost | dpost >file.ps
47
48while,
49
50    pic -T720 file | tbl | eqn -r720 | troff -mm -Tpost | dpost >file.ps
51
52should work if you're using old versions of eqn and pic.
53
54