<HTML
><HEAD
><TITLE
>Install XFree86</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.63
"><LINK
REL="HOME"
TITLE="Nvidia OpenGL Configuration mini-HOWTO"
HREF="index.html"><LINK
REL="UP"
TITLE="Install Software"
HREF="install.html"><LINK
REL="PREVIOUS"
TITLE="README and INSTALL files"
HREF="instnote.html"><LINK
REL="NEXT"
TITLE="Install Mesa"
HREF="instmesa.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Nvidia OpenGL Configuration mini-HOWTO</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="instnote.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 3. Install Software</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="instmesa.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="INSTX"
>3.2. Install XFree86</A
></H1
><P
> Installation of the software packages requires root login, which can be obtained
easily via the superuser/setuser command: <B
CLASS="COMMAND"
>su -</B
>
(see, <B
CLASS="COMMAND"
>man su</B
>).
</P
><P
> The following explains the installation of XFree86 from source in only the
most basic terms. Make sure to read all the XFree86 documentation to
learn about special options.
</P
><P
> If you have a version of XFree86 installed already, you may want to move it
or delete it. However, installing over an existing X is generally OK and
preserves any programs or libraries you might have installed into the X
directories (not that you should really do that):
<TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
> cd /usr
mv X11R6 X11R6-old
cd /etc
mv X11 X11-old
# you may have an X directory in /var also
cd /var
mv X11R6 X11R6-old
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><P
> If these locations are not correct for your distribution of Linux, you will
have to look around your filesystem a bit - try looking in
<TT
CLASS="FILENAME"
>/var</TT
>
</P
><P
> <TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
> cd /usr/src
mkdir release
cd release
tar -xvzf X420src-1.tgz
tar -xvzf X420src-2.tgz
tar -xvzf X420src-3.tgz
tar -xvzf doctools-1.3.tar.gz
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><P
> If you are using an old version of XFree86 for some reason, you may
want to use the man page packages. XFree 4.2.0 and later has all these
man pages already. Skip using the man page packages if you don't
need them. Check in /usr/src/release/xc/doc/man to see what all
is included with your XFree86.
<TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
> # unpack the man pages if they are missing.
cd /usr/src
tar -xvzf mangl.tar.Z
tar -xvzf manglu.tar.Z
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><P
> A file has to be edited to allow these man pages to compile/install with
the rest of the distribution:
<TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
> cd /usr/src/release/xc/doc/man/GL
# Edit the file: Imakefile
# SUBDIRS = glx gl glu
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><P
> When you unpacked the <TT
CLASS="FILENAME"
>man*.tar.Z</TT
> files above,
two new directories where added:
<TT
CLASS="FILENAME"
>gl</TT
>
<TT
CLASS="FILENAME"
>glu</TT
>
</P
><P
> <TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
> cd /usr/src/release
cd doctools
# Having this variable set confuses the sgml docs build.
# With it unset, the build uses the proper defaults.
unset $SGML_CATALOG_FILES
make
make install
# Note: doctools installs the perl program sgmlfmt to
# /usr/local/bin. It looks for the perl executable
# at /usr/local/bin/perl. If perl is installed
# on your system at /usr/bin/perl, then it will not
# find perl and the sgml docs build will fail!
# Make a symlink if needed (or edit the script):
cd /usr/local/bin
ln -s /usr/bin/perl perl
cd /usr/src/release
cd xc/config/cf
vi host.def
# add the following three lines to host.def:
# #define HasSgmlFmt YES
# #define BuildAllDocs YES
# #define HasZlib YES
# See the README file in doctools and xc/config/cf.
# HasZlib YES instructs XFree86 not to build and install
# it's own old zlib. If you do not have zlib installed
# (check /usr/lib/libz*), then omit the HasZlib line or
# go download it and install it first:
# http://www.info-zip.org/pub/infozip/zlib/
# A common zlib conflict occurs when a system already
# has zlib installed and XFree86 installs it's also.
# In this case, deleting /usr/X11R6/lib/libz.a fixes
# the problem.
cd /usr/src/release/xc
make World
# before installing, make sure you have moved
# or deleted prior installation of X
# unless you are sure you want to just overwrite
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 ..
ln -s X11R6 X11
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><P
> Add <TT
CLASS="FILENAME"
>/usr/X11R6/lib</TT
>
to your
<TT
CLASS="FILENAME"
>/etc/ld.so.conf</TT
> file,
then run the command <B
CLASS="COMMAND"
>ldconfig</B
> to update
<TT
CLASS="FILENAME"
>/etc/ld.so.cache</TT
> so the libraries will be visible.
</P
><P
> The GL/GLX/GLU HTML documentation is located at
<TT
CLASS="FILENAME"
>/usr/src/release/xc/doc/hardcopy/GL</TT
>.
This directory can be copied as follows:
<TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
> cd /usr/src/release/xc/doc/hardcopy
cp -r GL /usr/X11R6/lib/X11/doc/html
</PRE
></FONT
></TD
></TR
></TABLE
>
The <TT
CLASS="FILENAME"
>index.html</TT
> file in the docs might point to
<TT
CLASS="FILENAME"
>manindex5x.html</TT
>, but the filename may
actually be <TT
CLASS="FILENAME"
>manindex5.html</TT
>. Just make a symlink to fix it if needed:
<TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
> cd /usr/X11R6/lib/X11/doc/html
ln -s manindex5.html manindex5x.html
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><P
> When <SPAN
CLASS="APPLICATION"
>X</SPAN
> is up and running (later), try using the
<B
CLASS="COMMAND"
>xman</B
> program to see that the gl,glx,glu
and glut <B
CLASS="COMMAND"
>man</B
> pages are in section 3. If you have <SPAN
CLASS="APPLICATION"
>KDE2</SPAN
>,
<SPAN
CLASS="APPLICATION"
>khelpcenter</SPAN
> allows <B
CLASS="COMMAND"
>man</B
>-page browsing.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="instnote.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="instmesa.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>README and INSTALL files</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="install.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Install Mesa</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
