1A joint production of:
2
3	Adam de Boor		University of California,  Berkeley
4
5	David Rosenthal
6	Stuart Marks
7	Robin Schaufler
8	Mike Schwartz
9	Frances Ho
10	Geoff Lee
11	Mark Opperman		Sun Microsystems
12
13	Bob Scheifler		MIT Laboratory for Computer Science
14	Keith Packard
15
16This version of the Sun X11 drivers uses ../mi,  ../mfb and ../cfb to support
17the following configurations:
18
19	Sun/2		bw2	cg2/3/5
20	Sun/3		bw2	cg2/3/4/5
21	Sun/4		bw2	cg2/4
22	SPARCstation		cg3/6
23	Sun/386i	mono	color
24
25The following configurations are NOT supported:
26
27	Sun/1		bw1	cg1	(requires separate port)
28	Sun/2			gp	(use /dev/cgtwo0)
29	Sun/3			gp	(use /dev/cgtwo0)
30	Sun/4			gp	(use /dev/cgtwo0)
31
32The mfb and cfb code has been substantially tuned for 1- and 8-bit framebuffers
33(with code for both fast and slow cpu-to-memory ratios).  It installs and runs
34on these configurations under SunOS 3.2, 3.4, and 4.0.  However, we must stress
35that it is completely unsupported, and if you have problems installing or using
36it you are on your own.
37
38
39Things to check before building:
40
411)	config/sun.cf - set the SunOSMajorVersion and SunOSMinorVersion 
42	parameters to the right values.
43
442)	config/Project.tmpl - check LIBDIR, FONTDIR, etc.; set 
45	define LibDir, FontDir, etc. in site.def as required.
46
47
48
49Then build the system by:
50
511)	Go for it.  In the top-level directory, type
52
53	make World
54
55	This takes about forty minutes on a 4/260, and somewhat longer
56	on other Suns.
57
58
592)	Go for it.  In the top-level directory, type
60
61	make install
62
63	Otherwise, you'll want to create a bunch of symbolic links to
64	the various executables and data files scattered throughout
65	the hierarchy.
66
67
68
693)	On the console, or from an rlogin connection, put whatever you
70	chose for BINDIR (in Imake.tmpl) in your search path, and then
71	start the server:
72
73	    xinit
74	or
75	    xinit -- -dev /dev/??? [see below]
76
77	If it's from the console,  you probably want to redirect the
78	output thus:
79
80	    xinit >& /tmp/x11.out
81
824)	xinit should start up an xterm window that acts as a console.  When
83	this xterm terminates, the xinit will kill the server.  You can also
84	start up client programs from a terminal or rlogin, but you must
85	first set the DISPLAY environment variable:
86
87	    setenv DISPLAY unix:0
88	    xterm &
89
90
915)	Make sure that you have special devices in /dev for the appropriate 
92	framebuffer.  See the manual page for Xsun for details or run the
93	constype program. VME systems require special .o files when more
94        than one of a particular frame buffer type is installed.
95
96
976)	In general,  Xsun auto-configures to use all the available framebuffers
98	(see the Xsun manual page).  In some circumstances, you may need to 
99	use the -dev switch on the command line to specify a specific device
100	to use.  In particular, on the GP, GP+, and GP2, you'll need to
101	specify -dev /dev/cgtwo0 your xdm Xservers file or your xinit script.
102
103
1047)	To shut the server down,  send it a Hangup or Terminate signal.
105
106
1078)	If X crashes, it will leave the keyboard in a funny state.  There is a
108	program called "kbd_mode" that will reset the mode of the keyboard.
109	"kbd_mode -a" is the appropriate setting for the bare console, and
110	"kbd_mode -e" is the appropriate setting for running with SunWindows.
111	You may have to issue this command from a terminal or from an rlogin
112	connection.  If you run from the bare console, you can give the
113	command
114
115	xinit ; kbd_mode -a
116
117	so that the keyboard mode will ALWAYS be set properly when the server
118	terminates.
119