![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to README CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / postscript|
Return to README CVS log | Up to [Research Unix] / researchv10no / cmd / postscript |
1.1 root 1:
2: Version 3.3 PostScript printer support programs. The package is now
3: included as part of the DWB package. The instructions in this file
4: ONLY apply if the PostScript support package has been separated from
5: the DWB package.
6:
7: -------------
8: Major Changes
9: -------------
10:
11: In what follows TARGETS, BINDIR, and POSTBIN refer to definitions made
12: in the top level makefile (file postscript.mk). All are described in the
13: next section. The important changes are:
14:
15: 1: dpost now reads ASCII font tables. makedev and the old binary font
16: tables are completely gone.
17:
18: 2: The default PostScript font tables (directory postscript/devpost)
19: now only include the standard 35 fonts available on most PostScript
20: printers. All width tables were built on a version 47.0 QMS PS-810
21: using files in postscript/buildtables.
22:
23: 3: Additional tables (the ones that were in the devpost collection
24: in DWB 3.0) have been moved to directory postscript/devpost.add.
25: By default they are not installed. If you need these tables include
26: devpost.add in the TARGETS list in file postscript.mk.
27:
28: If you're not already using the extra font tables don't start now.
29: Font names are poorly chosen, particularly since the .fp request
30: can now handle long font names (as synonyms). The devpost.add
31: tables are completely unsupported. There is no guarantee these
32: tables will be included in future releases.
33:
34: 4: The original collection of PostScript font tables are supplied
35: (directory devopost), but by default are not installed. If you need
36: the tables add devopost to the TARGETS list in file postscript.mk.
37:
38: If you're not already using the old PostScript font tables don't
39: start now. The devopost tables are unsupported and will likely not
40: be included in future releases.
41:
42: 5: dpost recognizes two new fields in the ASCII font tables. An entry
43: that begins with fontname, as in
44:
45: fontname Times-Roman
46:
47: is expected to be the full PostScript font name. All PostScript font
48: tables should include a fontname entry. The second entry is,
49:
50: named in prologue
51:
52: and is used to disable runtime abbreviation of font names - dpost
53: assumes the abbreviation is already in the prologue (file dpost.ps).
54:
55: 6: All traces of the Varitimes font tables (VR, VI, VB, and VX) have
56: been removed.
57:
58: 7: Bracket building problems on have been fixed by adding a Metrics
59: entry for braceleftbt to dpost.ps. Compensates for an apparent
60: mistake in Adobe's Symbol font.
61:
62: 8: Translators (e.g. dpost, postprint) no longer leave save objects on
63: the operand stack. New and old versions of the translators and
64: prologues should not be mixed.
65:
66: 9: Passing output from new translators through an old version of
67: postreverse may fail if the more than one page image is being
68: printed on each sheet of paper. The new version of postreverse
69: is safe and probably should be installed on all your systems,
70: even if you don't install any other part of the package.
71:
72: 10: dpost and picpack are now only installed in directory BINDIR. The
73: makefiles,
74:
75: postscript/dpost/dpost.mk
76: postscript/picpack/picpack.mk
77:
78: delete dpost and picpack from POSTBIN before installing the new
79: versions. Change the two makefiles if you expect to find dpost
80: and picpack in directory POSTBIN.
81:
82: 11: The mechanism for compiling DKHOST code in postio on internal
83: System V machines has been changed. The only way to get it is to
84: set DKHOST to TRUE in postscript.mk. Makefiles now assume dk.h and
85: libdk.a are in standard places (i.e. /usr/include and /usr/lib).
86: If that's not the case on your system you may have to edit file
87: postio/postio.mk.
88:
89: 12: Man pages and programs are installed together - there's no easy
90: way to avoid it. Setting MAN1DIR and MAN5DIR to some existing
91: temporary directory (e.g. /tmp) means programs will be properly
92: installed but man pages won't go anywhere permanent.
93:
94: Check the VERSION file for additional changes.
95:
96: -------------------
97: Tuning The Makefile
98: -------------------
99:
100: Source files, man pages, and low level makefiles can all be updated
101: to reflect settings in postscript.mk in one simple step (described
102: later). In most cases you only need to edit file postscript.mk.
103:
104: First save a copy of file postscript.mk. Then adjust the following
105: definitions in file postscript.mk:
106:
107: SYSTEM best match for your version of Unix. Current choices for
108: SYSTEM are:
109:
110: SYSV - System V
111: V9 - Ninth Edition
112: BSD4_2 - Berkeley (eg. Sun)
113:
114: Controls conditional compilation in a few places.
115:
116: GROUP group assigned to all installed files
117:
118: OWNER owner of everything that's installed
119:
120: BINDIR dpost and picpack go here. All other programs go in POSTBIN.
121: BINDIR must already exist - it will not be created during an
122: install.
123:
124: HOSTDIR hostresident font directory for PostScript printers. Only
125: used in the font download program.
126:
127: FONTDIR width table directory - for troff and most postprocessors
128:
129: MAN1DIR command manpages. A command and its manpage are installed
130: together - there's no easy way to avoid it. Setting MAN1DIR
131: to an existing temporary directory (e.g. /tmp) means an
132: install will work but manpages won't go anywhere permanent.
133: MAN1DIR must already exist - it will not be created during
134: an install.
135:
136: POSTBIN where most PostScript support programs go. dpost and picpack
137: the exceptions.
138:
139: POSTLIB prologues and miscellaneous PostScript files. Primarily for
140: the programs that live in POSTBIN.
141:
142: CFLGS common compiler options - used to build CFLAGS in the low
143: level makefiles. CLFGS and LDFLGS are best set on the make
144: command line.
145:
146: LDFLGS common link editor options - used to build LDFLAGS in the
147: low level makefiles. LDFLGS and CFLGS are best set on the
148: make command line.
149:
150: DKHOST must only be set to TRUE or FALSE. TRUE means compile DKHOST
151: Datakit support code in postio. Only used if SYSTEM is SYSV.
152:
153: DOROUND must only be set to TRUE or FALSE. TRUE means PostScript
154: translators include code that maps clipping path dimensions
155: into known paper sizes.
156:
157: TARGETS the default list of what's built by make. Each target must
158: be the name of a source directory. A target that names a
159: non-existent source directory is ignored. Setting TARGETS
160: on the make command line overrides the default list.
161:
162: -------------------
163: Updating The Source
164: -------------------
165:
166: Whenever file postscript.mk changes you should update source files,
167: man pages, and low level makefiles by typing,
168:
169: make -f postscript.mk changes
170:
171: ------------------------
172: More System Dependencies
173: ------------------------
174:
175: The package has been compiled and tested on System V and Ninth Edition
176: Unix Systems and on Sun workstations. Most differences are handled via
177: the SYSTEM definition in postscript.mk. Problems that remain are:
178:
179: SYSV - System V
180: Use the native compiler if you're on an internal System V UTS
181: machine.
182:
183: V9 - Ninth or Tenth Edition
184: chown is in /etc and chgrp no longer exists - it's been folded into
185: the chown command. You may be forced to build a simple chgrp shell
186: script (put it in your bin) that calls chown. If you're not superuser
187: set OWNER to your login name and GROUP to your group id.
188:
189: BSD4_2 - Sun Workstations
190: Use the Bourne shell. chown is should be in /usr/etc. Add /usr/etc
191: to your PATH and export PATH. If you're not superuser set OWNER to
192: your login name and GROUP to your group id.
193:
194: ----------------------
195: Installing The Package
196: ----------------------
197:
198: To build (but not install) the default package (i.e. everything named by
199: TARGETS in postscript.mk) type,
200:
201: make -f postscript.mk all
202:
203: To build and install the package type,
204:
205: make -f postscript.mk all install
206:
207: After the package is installed use,
208:
209: make -f postscript.mk clobber
210:
211: to delete binary files and compiled programs from the source directories.
212:
213: To select part of the package define TARGETS on the command line. For
214: example,
215:
216: make -f postscript.mk TARGETS="dpost devpost" all install
217:
218: builds and installs dpost and the PostScript font tables. Quotes hide
219: white space from the shell.
220:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.