|
|
1.1 root 1: .bp
2: .sh 1 "Installing the Interpress Toolkit on Unix"
3: .lp
4: The initial installation of the \*(IP toolkit
5: is accomplished by positioning to
6: the top level directory and issuing a ``make all''. This
7: creates the Interpress run time library and various executables in the
8: appropriate lib and bin subdirectories. A subsequent ``make install'' will
9: copy the relevant parts of the toolkit (executables, manual pages, font
10: libraries, include files and run time library) to the appropriate local
11: directories for convenient use (currently /usr/new/...). If local
12: requirements dictate that a different directory be used, the Makefile can be
13: modified accordingly.
14: .lp
15: Doing a ``make clean'' at the top level
16: will remove all the object files and executables
17: from this sub-tree.
18: .sh 2 "Installing Support For \*(TR"
19: .lp
20: This package only works with Typesetter-Independent \*(TR. Most Unix
21: systems are distributed with a \*(TR for the Graphics Systems C/A/T-4
22: phototypesetter. Typesetter-Independent \*(TR is available from
23: AT&T either seperately or as part of the Documentor's Workbench.
24: .lp
25: At this writing, all development and testing has occured on Xerox 8044s.
26: More to the point, the 8044 is the only printer for which the \*(TR
27: fonts are supplied.
28: On the other hand, there are no known limitiations that
29: might prevent this package from working on other printers.
30: .sh 3 "Installing the Fonts on Your Printer"
31: .lp
32: Special \*(TR fonts have been developed for use with this package.
33: While the product font ``Classic'' was used in earlier releases, it
34: was decided to create new fonts for the following reasons:
35: .ba +5
36: .ip "\(bu"
37: Many existing \*(TR documents were created for the C/A/T phototypesetter
38: and use its many point sizes.
39: .ip "\(bu"
40: The Eqn preprocessor requires many special symbols,
41: like the bracket building characters, which had to be specially created.
42: .ip "\(bu"
43: In the commercial Xerox fonts, some characters do not exist in all point sizes.
44: .ba -5
45: .lp
46: The Troff fonts are distributed on five (5) floppies.
47: If the floppies were not included in the distribution, they can be obtained
48: from Xerox by writing to the address in Appendix I.
49: These fonts include the point sizes: 6-14, 16, 18, 20, 22, 24,
50: 28, 30, 32 and 36.
51: .lp
52: To install the fonts on your printer, login on the printer with a system
53: administrator's account and issue the ``enable'' command.
54: Then type on the console: ``Stop Printing''.
55: Insert the first floppy
56: (order doesn't matter), then type ``Install From Floppy''. Answer ``Yes'' to
57: all questions. Continue to insert and install the rest of the floppies. When
58: done, type ``Start Printing'' and wait while a new font catalog is compiled.
59: .sh 3 "Installing the Host Software"
60: .lp
61: We use the Multiple Device Queuing System (MDQS) software package
62: from BRL-VGR.arpa to spool to our printers. The programs ``maha'' and
63: ``dipress'' both exec the program ``qip'' to enqueue an Interpress master.
64: You may want to use the shell script ./src/bin/qip as a model to work from.
65: Comments in that file detail what options qip is called with.
66: .lp
67: The top level makefile has a variable at the front whose value
68: is the location of your TI-Troff executable. You should examine
69: it for correctness in your environment.
70: .lp
71: Font metrics are information about fonts rather than the character
72: representations themselves. The most commonly needed information
73: is a character's width. In this distribution,
74: font metrics for TI-Troff are created from an Interpress metric master(s).
75: The conf/troff directory is set-up to install metrics for the following
76: font families: TroffClassic, (product) Classic, Modern, Terminal and Titan.
77: If you have metrics for other fonts on your printer,
78: copy them into conf/troff and modify the makefile to use them.
79: Ipmetrics will create a shell script that wants to execute the program
80: ``makedev''. This program comes with TI-Troff and you will want
81: it in your search path.
82: See the manual page for ipmetrics for more information on this topic.
83: .lp
84: Should you want to use a pre-System V, Rel. 2 TI-Troff, note that the format
85: of the font file changed slightly (but incompatibly) between releases. If
86: you have an older TI-\*(TR, change the size of the array ``intname'' (internal
87: name) in dev.h from 21 to 10.
88: .lp
89: In the TI-Troff world, pre-processors know certain information about
90: the output devices. These pre-processors
91: .i must
92: be modified if correct output is to be produced. Files processed with
93: the default device type look squeezed together.
94: You will have to edit programs like eqn and pic
95: to know about ``-Tip'' or ``-Tipress''. The minimum point size of our
96: current release is 6 pt. and the \*(IP masters have a grid
97: resolution of 2540 units per inch (ten microns).
98: Below are differences from our System V,
99: release 2 sources for eqn, pic and tbl:
100: .(b L
101: .nf
102: EQN/e.h:
103: 33a39
104: > #define DEVIPRESS 7 /* Xerox Interpress */
105:
106: EQN/io.h:
107: 177a183,185
108: > else if (strncmp(&svargv[1][2], "ip", 2) == 0 )
109: > {res = 2540; minsize = 6; ttype = DEVIPRESS; }
110: EQN/sqrt.c:
111: 9c9
112: < if (ttype == DEVCAT || ttype == DEVAPS)
113: ---
114: > if (ttype == DEVCAT || ttype == DEVAPS || ttype == DEVIPRESS)
115:
116: PIC/pic.h
117: 26a27
118: > #define DEVIPRESS 7 /* Xerox Interpress */
119:
120: PIC/main.c
121: 103a108,112
122: > } else if (strncmp(&argv[1][2], "ip", 2) == 0 ) {
123: > res = 2540;
124: > devtype = DEVIPRESS;
125: > DX = DY = 1;
126: .)b
127: .lp
128: TI-\*(TR itself has a bug where it won't always correctly parse font numbers
129: in it's input if there are more than nine fonts. The basic error
130: occurs on lines of the form:
131: .(l I
132: \f(TRif ((k = i - '0') >= 0 && k <= nfonts && k < smnt)
133: return(k)
134: .)l
135: In this example (taken from t6.c), ``i'' represents the font name right
136: justified and zero filled. In \*(TR, fonts can be named by their name
137: or by their position number. The above test trys to see if the value
138: of ``i'' is a position number and if so, return the integer value of that
139: number. But note that the ASCII to binary conversion only works for
140: one digit position numbers. If the position is greater than ten, then
141: the test will fail.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.