![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to setup_geo.nr CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 42BSD / ingres / doc / other|
Return to setup_geo.nr CVS log | Up to [CSRG BSD Unix] / 42BSD / ingres / doc / other |
1.1 root 1: .ds II \s-2INGRES\s0
2: .ds GQ \s-2GEO-QUEL\s0
3: .ds HE 'HOW TO SET UP GEO-QUEL''PAGE %'
4: .so nmacs
5: .ce
6: Instructions for setting up GEO-QUEL version 6.2.
7:
8: .ce
9: (March 22, 1979)
10:
11: This set of instructions will help you to get
12: \*(GQ running on your \*(II system.
13: If you have been running version 4.0 of \*(GQ
14: you should be aware of some differences
15: between the old and current versions.
16: They are identified in section 6 of this document.
17: Your \*(II system should have been completely
18: installed before starting to install \*(GQ.
19:
20:
21: .sh 1
22: Moving \*(GQ to /usr/bin.
23: .PS
24: The binary for \*(GQ is in .../bin/geoquel.
25: It should be moved or linked into /usr/bin.
26: This will provide you with a working system.
27:
28: Move \*(GQ to /usr/bin:
29:
30: .ti +8
31: mv .../bin/geoquel /usr/bin/geoquel
32:
33: Verify that the file mode of \*(GQ is 711.
34: Notice that it SHOULD NOT set user id.
35: The correct mode is:
36:
37: .ti +8
38: -rwx--x--x 1 ingres . . . geoquel
39: .sh 1
40: \*(GQ documentation.
41: .PS
42: The reference manual for \*(GQ may be found
43: in .../doc/geoquel.
44: To print a copy of the \*(GQ reference manual
45: on the line printer,
46: execute the command:
47:
48: .ti +8
49: setup georef | lpr
50:
51: These instructions can be printed using the command:
52:
53: .ti +8
54: nroff .../doc/other/setup_geo.nr
55:
56: Documentation for the graphic terminal support
57: software, GRAFPAC, is currently limited to the information
58: in the code.
59: The files in .../geoquel/grafpac are organized such that a
60: file names start with a descriptive two letter code.
61: The codes are:
62:
63: .in +8
64: .nf
65: gt GT40-GT42 specific routines
66: tk Tektronix 4014 specific routines
67: tv Device independent routines
68: .fi
69: .in -8
70:
71: GRAFPAC has been organized so that the
72: proceedure level interface is machine independent.
73:
74: .sh 1
75: Display Terminal Support
76: .PS
77: \*(GQ supports two types of display
78: terminals: Digital Equipment Corporation's
79: GT40-GT42, and Tektronix's 4014.
80: The Tektronix 4014 version can be used to
81: drive any 4010 type terminal but a
82: 4014 with extended graphics module is expected.
83:
84: When running \*(GQ in background or from a
85: terminal that cannot display graphic output,
86: it must guess which type of display list should
87: be drawn, GT40-GT42 or 4014 type.
88: The default has been set to
89: 4014.
90: If you would prefer another
91: default the file .../geoquel/geoquel.c
92: must be changed.
93: Specifically, the three compile options
94: at the head of the file must be adjusted.
95: See the comment in the code for further
96: information.
97:
98: To use a GT40 or GT42, you must load a monitor program
99: in the PDP-11.
100: This monitor can be found in .../geoquel/gt42.
101: A loaded copy of the monitor is supplied
102: in .../geoquel/gt42/gt42mon and can be used directly.
103: Simply 'cat' this file to the terminal.
104:
105: .ti +10
106: cat .../geoquel/gt42/gt42mon
107:
108: The format of this file is suitable for use with
109: the standard ROM loader normally at address 166000.
110:
111: If you decide to provide support for
112: another graphic device, you must re-write
113: the routines in .../geoquel/grafpac.
114: Naturally, we would be interested in hearing
115: about any other devices you develop support for.
116:
117: .sh 1
118: Possible source code changes.
119: .dn
120: If your machine has a hardware floating point unit.
121: .PS
122: You may wish to recompile \*(GQ without the
123: software floating point interpreter.
124: This will not affect the operation in any way
125: (since the software interpreter
126: will not be used if your
127: machine has floating point hardware).
128: The resulting copies of the object code will be
129: somewhat smaller.
130: There are various shell files which contain
131: C-compile statements.
132: On each of these
133: the "-f" flag must be removed.
134: The shell files are all located in the directory .../geoquel/setup.
135: The one exception is .../setup/geoquel.sh.
136:
137: .in +8
138: ed .../setup/geoquel.sh
139: .ti +5
140: (find "-f" on cc statement and remove)
141: .br
142: chdir .../geoquel/setup
143: .ti +5
144: (examine all files and remove -f's)
145: .in -8
146:
147: .sh
148: Recompilation.
149: .PS
150: To recompile \*(GQ, execute the command:
151:
152: setup geoquel
153:
154: This command will recompile \*(GQ from the
155: source code.
156: Various messages will be printed on the terminal telling
157: you what is being done and where it is.
158: The resulting copy of \*(GQ will be placed in .../bin/geoquel.
159: It should be moved to /usr/bin/geoquel.
160:
161: .sh 1
162: Setting up the ttytype file.
163: .PS
164: If you have been using version 4.0 of \*(GQ,
165: you will not need to do this step.
166:
167: The ttytype file describes
168: each terminal on your system.
169: \*(GQ will
170: not attempt to display graphical output on terminals
171: that are not capable of displaying it.
172: There is a sample of the file in
173:
174: .ti +8
175: ".../geoquel/ttytype.sample".
176:
177: This is a copy of the file in use on the Berkeley system.
178:
179: The ttytype file consists of a series of
180: lines;
181: the first character is the terminal id,
182: and the rest of the line tells
183: the type of the terminal.
184: The first of these characters is a terminal class,
185: and the rest signify the brand, or some other more
186: descriptive indication.
187: A completely blank line terminates the useful part
188: of the file, after which comments may
189: appear unrestricted.
190: In the sample file the currently recognized
191: (defined) terminal types are listed.
192:
193: Edit the sample file or create a new one to
194: match your system.
195: Place the file in .../files/ttytype:
196:
197: .ti +8
198: mv .../geoquel/ttytype.sample .../files/ttytype
199:
200: .sh 1
201: Previous versions of \*(GQ.
202: .PS
203: The large change in version number (4.0 to 6.2)
204: was done so that \*(GQ matches the \*(II version numbering.
205:
206: There has been very few external changes to the
207: \*(GQ language.
208: The HISTOGRAM command was greatly improved and the documentation
209: cleaned up.
210: In later modifications of \*(GQ there will be
211: some additional monitor commands and the underlying
212: graphics package will be updated.
213: Also, a rudimentary facility for accessing the \*(II
214: HELP and PRINT commands was added.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.