3. Install XFree86

Installation of the software packages requires root login, which can be obtained easily via the superuser/setuser command: "su -" (see, man su).

If you have a version of XFree86 installed already, you may want to move it or delete it:

cd /usr mv X11R6 X11R6-old cd /etc mv X11 X11-old

If these locations are not correct for your distribution of Linux, you will have to look around your filesystem a bit - try looking in /var

cd /usr/src mkdir release cd release tar -xvzf X401src-1.tgz tar -xvzf X401src-2.tgz tar -xvzf X401src-3.tgz tar -xvzf doctools-1.2.tar.gz -- unpack the man pages (actually, glx pages are already present) cd /usr/src tar -xvzf mangl.tar.Z tar -xvzf manglx.tar.Z tar -xvzf manglu.tar.Z

A file has to be edited to allow these man pages to compile/install with the rest of the distribution:

cd /usr/src/release/xc/doc/man/GL Edit the file: Imakefile SUBDIRS = glx gl glu

When you unpacked the man*.tar.Z files above, two new directories where added: gl glu

cd /usr/src/release cd doctools make make install cd .. cd xc make World -- before installing, make sure you have moved or deleted prior installation of X make install make install.man -- make symlinks cd /usr/include ln -s ../X11R6/include/DPS DPS ln -s ../X11R6/include/GL GL ln -s ../X11R6/include/X11 X11 ln -s ../X11R6/include/bitmaps bitmaps cd .. ls -s X11R6 X11

Add /usr/X11R6/lib to your /etc/ld.so.conf file, then run "ldconfig" to update /etc/ld.so.cache so the libraries will be visible.

The GL/GLX/GLU HTML documentation is located at /usr/src/release/xc/doc/hardcopy/GL. This directory can be copied as follows:

cd /usr/src/release/xc/doc/hardcopy cp -r GL /usr/X11R6/lib/X11/doc/html

You might notice broken symlinks in /usr/X11R6/lib/X11/doc/html. This seems to be a bug in the XFree86 build/install. The manindex3.html file is also corrupted. The broken symlinks can simply be deleted.

cd /usr/X11R6/lib/X11/doc/html rm *3x.html -- if you want to play with mass renaming files, you can -- use a command like the following: for afile in *3.html; do export afile; mv "$afile" "`awk 'BEGIN {print gensub("3.html","3x.html","G",ENVIRON["afile"]) }'`"; done;

Hopefully this HTML doc problem will be fixed soon!

When X is up and running (later), try using the xman program to see that the gl,glx,glu and glut man pages are in section 3. If you have KDE2, khelpcenter allows manpage browsing.