![[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 / post.src|
Return to README CVS log | Up to [Research Unix] / researchv10no / cmd / post.src |
1.1 root 1: Stuff appears to work, but it's obviously not well tested. I fully
2: expect several iterations before things are correct!! Make sure you
3: can back this out quickly.
4:
5: This code supports UTF encoding. Directory dpost.utf is a version that
6: reads UTF encoded files. Directory dpost is DWB 3.3 source and should be
7: close to what you're currently using. Main source code changes were in
8: dpost.utf (files font.h, font.c, and dpost.c). Select either dpost or
9: dpost.utf in TARGETS in postscript.mk. Both build and install a program
10: called dpost!!
11:
12: dpost.utf is more general and includes code that lets it read either
13: format. Only catch is troff must tell it (with x E UTF) that the file
14: is UTF and troff currently doesn't output encoding info, so you're
15: stuck with two post-processors!
16:
17: Added common/rune.h and common/rune.c so code can be compiled elsewere.
18: Both files are only used by dpost. Remove RUNELIB in commmon/rune.h if
19: fullrune(), chartorune(), and runetochar() are available on your system.
20: You will also need to set READING in common/gen.h. It controls how dpost
21: (from dpost.utf) reads troff output. It should be UTFENCODING on Plan 9
22: and ONEBYTE elsewhere. If troff includes encoding hint (x E UTF) then
23: READING selects the default which sould be ONEBYTE.
24:
25: Leave WRITING (in common/gen.h) set to ONEBYTE. It only controls dpost
26: output and dpost (right now) does not work 100% with UTF.enc. Fix should
27: be easy, but I don't have time now.
28:
29: Other translators passed bytes through so only needed slightly modified
30: proglogues and a new encoding scheme (psencoding/UTF.enc). It works for
31: Latin1, but still needs a bit more attention. Prologue changes were easy
32: and only involved adding lines like,
33:
34: /show {show} bind def
35: /stringwidth {stringwidth} bind def
36:
37: Guarantees text procedures used in prologues aren't operators and can be
38: successfully redefined in UTF.enc. Unbinding means a small but probably
39: not noticeable speed penalty. You may not want to include those changes
40: on other system.
41:
42: -------------
43: Major Changes
44: -------------
45:
46: See the VERSION file.
47:
48: -------------------
49: Tuning The Makefile
50: -------------------
51:
52: Source files, man pages, and low level makefiles can all be updated
53: to reflect settings in postscript.mk in one simple step (described
54: later). In most cases you only need to edit file postscript.mk.
55:
56: First save a copy of file postscript.mk. Then adjust the following
57: definitions in file postscript.mk:
58:
59: SYSTEM best match for your version of Unix. Current choices for
60: SYSTEM are:
61:
62: SYSV - System V
63: V9 - Ninth Edition
64: BSD4_2 - Berkeley (eg. Sun)
65:
66: Controls conditional compilation in a few places.
67:
68: GROUP group assigned to all installed files
69:
70: OWNER owner of everything that's installed
71:
72: BINDIR dpost and picpack go here. All other programs go in POSTBIN.
73: BINDIR must already exist - it will not be created during an
74: install.
75:
76: HOSTDIR hostresident font directory for PostScript printers. Only
77: used in the font download program.
78:
79: FONTDIR width table directory - for troff and most postprocessors
80:
81: MAN1DIR command manpages. A command and its manpage are installed
82: together - there's no easy way to avoid it. Setting MAN1DIR
83: to an existing temporary directory (e.g. /tmp) means an
84: install will work but manpages won't go anywhere permanent.
85: MAN1DIR must already exist - it will not be created during
86: an install.
87:
88: POSTBIN where most PostScript support programs go. dpost and picpack
89: the exceptions.
90:
91: POSTLIB prologues and miscellaneous PostScript files. Primarily for
92: the programs that live in POSTBIN.
93:
94: CFLGS common compiler options - used to build CFLAGS in the low
95: level makefiles. CLFGS and LDFLGS are best set on the make
96: command line.
97:
98: LDFLGS common link editor options - used to build LDFLAGS in the
99: low level makefiles. LDFLGS and CFLGS are best set on the
100: make command line.
101:
102: DKHOST set it to TRUE to compile the DKHOST Datakit support code
103: in postio. Temporarily resets SYSTEM to SYSV if DKHOST is
104: TRUE and SYSTEM is BSD4_2. Ignored if SYSTEM is not SYSV
105: or BSD4_2.
106:
107: DKSTREAMS enables streams based DKHOST support in postio when DKHOST
108: is TRUE and SYSTEM is SYSV or BSD4_2. Choices are TRUE,
109: FALSE, or a stream module name (e.g. dknetty or dkty). TRUE
110: selects dknetty. Newer systems may expect dkty.
111:
112: ROUNDPAGE must only be set to TRUE or FALSE. TRUE means PostScript
113: translators include code that maps clipping path dimensions
114: into known paper sizes.
115:
116: TARGETS the default list of what's built by make. Each target must
117: be the name of a source directory. A target that names a
118: non-existent source directory is ignored. Setting TARGETS
119: on the make command line overrides the default list.
120:
121: -------------------
122: Updating The Source
123: -------------------
124:
125: Whenever file postscript.mk changes you should update source files,
126: man pages, and low level makefiles by typing,
127:
128: make -f postscript.mk changes
129:
130: ------------------------
131: More System Dependencies
132: ------------------------
133:
134: The package has been compiled and tested on System V and Ninth Edition
135: Unix Systems and on Sun workstations. Most differences are handled via
136: the SYSTEM definition in postscript.mk. Problems that remain are:
137:
138: SYSV - System V
139: Use the native compiler if you're on an internal System V UTS
140: machine.
141:
142: V9 - Ninth or Tenth Edition
143: chown is in /etc and chgrp no longer exists - it's been folded into
144: the chown command. You may be forced to build a simple chgrp shell
145: script (put it in your bin) that calls chown. If you're not superuser
146: set OWNER to your login name and GROUP to your group id.
147:
148: BSD4_2 - Sun Workstations
149: Use the Bourne shell. chown is should be in /usr/etc. Add /usr/etc
150: to your PATH and export PATH. If you're not superuser set OWNER to
151: your login name and GROUP to your group id.
152:
153: ----------------------
154: Installing The Package
155: ----------------------
156:
157: To build (but not install) the default package (i.e. everything named by
158: TARGETS in postscript.mk) type,
159:
160: make -f postscript.mk all
161:
162: To build and install the package type,
163:
164: make -f postscript.mk all install
165:
166: After the package is installed use,
167:
168: make -f postscript.mk clobber
169:
170: to delete binary files and compiled programs from the source directories.
171:
172: To select part of the package define TARGETS on the command line. For
173: example,
174:
175: make -f postscript.mk TARGETS="dpost devpost" all install
176:
177: builds and installs dpost and the PostScript font tables. Quotes hide
178: white space from the shell.
179:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.