1
2Simple case
3===========
4
5Provided your machine is set up with
6
71. An ANSI C compiler
82. A (moderately) ANSI compliant library
93. The X11R5 header files and libraries
10
11this should be as simple as typing
12
13  configure
14
15followed by
16
17  make
18
19This will yield a binary called 'xinfocom' which you can install
20somewhere appropriate.  If you want to adjust the fonts used to yield
21a prettier display, then add the lines in the file Xresources into the
22appropriate place; often a file called '.Xresources' in your home
23directory, but installations vary.
24
25Note: 1.8 uses a configuration script generated using autoconf rather
26than the Imakefile used by version 1.7.  This is simply because the
27majority of Unix systems I have tried do *not* have a working imake
28installation; either imake is not supplied at all (HPUX or AIX) or
29assumes a vendor supplied compiler (Solaris).  The Imakefile is still
30supplied, but using configure is recommended.
31
32
33Something goes wrong
34====================
35
361. You don't have an ANSI compiler.
37
38Your best bet is to get an ANSI compiler.  I don't use pre-ANSI
39compilers and I don't write K&R source code.  Even if you manage to
40hack the sources back to almost K&R you are likely to fall foul of
41some of the implicit coercions (caused by the ANSI prototypes) which
42are no longer happening.  GCC should work fine; it's the compiler I
43used to generate the X11 release (on most of the versions of Unix I
44tested on.)
45
462. Your library isn't very ANSI.
47
48This shouldn't be too much of a problem.  The configure script
49and os_unix module should work round this.  If they don't then
50please let me know.
51
523. You can't find X11 headers or X11 libraries.
53
54If you have admin staff, talk to them nicely.  They probably have
55some machines somewhere that can compile X applications; if you
56ask nicely they might tell you where they are.  Just bear in mind
57that playing games is not likely to be something they consider to
58be vitally important.
59
60If you *are* the admin staff, then you must have had the libraries
61around when you installed X11.  If you are running on a vendor
62supplied version, then you *probably* have the libraries although
63you may have chosen not to install them; it can sometimes be
64tempting to save some disk space, especially if installing from
65floppy (been there, done that.)
66
674. You don't have X11R5.
68
69X11R6 will do instead :-)
70
71It worked fine for me under X11R4; my first Unix box at home was just
72about capable of running X11R4.  X11R3 is unlikely to work, but I
73haven't been able to test that.
74
755. It won't compile or it compiles and doesn't work.
76
77Time to practice your debugging skills.  You are more likely to be
78able to solve the problem than I am, because you have access to
79the machine where the problem occurs.  About all I can do is point
80you at someone else who has similar problems, or offer some
81probably misleading advice;  I've already tested it on all the
82machines I have access to.  At the most you should need to modify
83the wio_unix and os_unix files, and possibly the types header.
84
85(The machines I've tried are Sun SparcStations running SunOS 4.1.3 and
86Solaris 2.4; 486 and Pentium PCs running BSDI BSD/386 1.1, BSD/OS 2.0,
87LinuxFT 1.0 (ELF) and FreeBSD 2.1; an Acorn R140 running RISCiX 1.2;
88IBM 250 running AIX 3.2.5; HP 712/60 running HPUX 9.0.5.)
89
90If you do get it working in the end, let me know what you had to
91do.  That way you can save someone else some work.
92
936. You aren't trying to compile under X11 and Unix at all.
94
95If you want to port this ITF derivative to another platform then you
96need to contact me first.  In particular, the copying restrictions for
97the standard X11 release mean that you cannot legally distribute a
98derived version.  Also, the X11 release is just one branch of a source
99tree which also covers the Acorn Archimedes, Psion Series3 and
100MS-Windows and it would be useful to incorporate your changes into
101this common tree.
102
103