source: x/installing/xorg7.xml@ b7556c5

10.0 10.1 11.0 11.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since b7556c5 was b7556c5, checked in by DJ Lucas <dj@…>, 12 years ago

Added $XORG_PREFIX/share/pkgconfig to $PKG_CONFI_PATH.

git-svn-id: svn:// af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.5 KB
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
8<sect1 id="xorg7" xreflabel="Xorg-&xorg7-version;">
9 <?dbhtml filename="xorg7.html"?>
11 <sect1info>
12 <othername>$LastChangedBy$</othername>
13 <date>$Date$</date>
14 </sect1info>
16 <title>Introduction to Xorg-&xorg7-version;</title>
18 <indexterm zone="xorg7">
19 <primary sortas="a-xorg7">Xorg</primary>
20 </indexterm>
23 <para><application>Xorg</application> is a freely redistributable,
24 open-source implementation of the <application>X</application> Window
25 System. This system provides a client/server interface between display
26 hardware (the mouse, keyboard, and video displays) and the desktop
27 environment, while also providing both the windowing infrastructure and a
28 standardized application interface (API).</para>
30 <para condition="html" role="usernotes">User Notes:
31 <ulink url='&blfs-wiki;/Xorg7'/></para>
33 <bridgehead renderas="sect3">Xorg Download and Installation
34 Instructions</bridgehead>
36 <para>Xorg-7.0 introduced a completely auto-tooled, modular build system.
37 With the new modular build system, it is no longer possible to download
38 the entire package in a single file. In fact, there may be as many as
39 293 files that need to be fetched from the download location. To assist
40 with such a large task, installing <xref linkend="wget"/> is strongly
41 recommended for downloading the needed files. A complete
42 <application>wget</application> file list is provided for each section
43 that includes multiple packages.</para>
45 <para>Given the number of packages available, deciding which packages you
46 need to install for your particular setup may seem a bit overwhelming at
47 first. Take a look at
48 <ulink url="">this page</ulink>
49 and
50 <ulink url="">this thread</ulink>
51 to get an idea of what you will need. If you are unsure, you should
52 install all packages at the cost of extra disk space.</para>
54 <note>
55 <para>Even if you intend to download only the necessary packages, you
56 should download the wget file lists. The list of files are ordered by
57 dependency, and the package versions listed in the files are known to
58 work well with each other. Further, the wget file lists contain comments
59 for specific packages that are deprecated or are not recommended to
60 install. Newer packages are likely intended for the
61 next release of <application>Xorg</application> and have already proved
62 to be incompatible with current versions of software installed in BLFS.
63 The installed size of <application>Xorg</application> can be reduced
64 considerably by installing only the packages that you will need and use,
65 however, the BLFS book cannot account for all dependencies and build
66 options for the individual <application>Xorg</application> packages.
67 The instructions assume that all packages have been built. A
68 <ulink url="&blfs-wiki;/Xorg7">wiki</ulink>
69 page containing dependency information is under development. You are
70 encouraged to add to these pages if you discover additional information
71 that may be helpful to other users who selectively install individual
72 packages.</para>
73 </note>
75 <para>Additionally, because of the large number of repetitive commands,
76 you are encouraged to partially automate the build. The commands below
77 (or similar) can be entered at the command line to compile each
78 section (proto, util, lib, app, driver). The wiki links on each
79 section's page contain specific commands to compile the entire group of
80 packages, based on the content of the wget files.</para>
82<screen>bash -e #exit on all errors
85mkdir $section
86cd $section
88# download and check packages
89grep -v '^#' ../${section}-${version}.wget | wget -i- -c \
90 -B${section}/
91md5sum -c ../${section}-${version}.md5
93# build packages
94for package in $(grep -v '^#' ../${section}-${version}.wget)
96 packagedir=$(echo $package | sed 's/.tar.bz2//')
97 tar -xf $package
98 cd $packagedir
99 ./configure $XORG_CONFIG
100 make
101 make install
102 cd ..
103 rm -rf $packagedir
104done 2&gt;&amp;1 | tee -a ../xorg-${section}-compile.log #log the entire loop</screen>
106 <para>The above shell will exit immediately on error. If it runs to
107 completion, you should manually exit the shell before continuing on to
108 the next set of instructions.</para>
110 <sect2>
111 <title>Setting up the Xorg Build Environment</title>
113 <para>First, you'll need to create a working directory:</para>
115<screen><userinput>mkdir xc &amp;&amp;
116cd xc</userinput></screen>
118 <para>As with previous releases of the X Window System, it may be
119 desirable to install <application>Xorg</application> into an alternate
120 prefix. This is no longer common practice among Linux distributions.
121 The common installation prefix for <application>Xorg</application> on
122 Linux is <filename class="directory">/usr</filename>. There is no
123 standard alternate prefix, nor is there any exception in the current
124 revision of the Filesystem Hierarchy Standard for Release 7 of the X
125 Window System. Alan Coopersmith of Sun Microsystems, has recently
126 stated "At Sun, we were using
127 <filename class="directory">/usr/X11</filename> and plan to stick with
128 it." Only the <filename class="directory">/opt/*</filename> prefix or
129 the <filename class="directory">/usr</filename> prefix adhere to the
130 current FHS guidelines.</para>
132 <para>Choose your installation prefix, and set the
133 <envar>XORG_PREFIX</envar> variable with the following
134 command:</para>
136<screen><userinput>export XORG_PREFIX="<replaceable>&lt;PREFIX&gt;</replaceable>"</userinput></screen>
138 <para>Throughout these instructions, you will use the following
139 <command>configure</command> switches for all of the packages. Create the
140 <envar>XORG_CONFIG</envar> variable to use for this parameter
141 substitution:</para>
143<screen><userinput>export XORG_CONFIG="--prefix=$XORG_PREFIX --sysconfdir=/etc \
144 --mandir=$XORG_PREFIX/share/man --localstatedir=/var"</userinput></screen>
146 <note>
147 <para>Make sure that you use bash when setting these variables as the
148 book commands assume the use of bash, and use bash specific syntax. Also
149 be sure to add these variables to your personal or system-wide profile as
150 they are used throughout this book. See
151 <xref linkend="postlfs-config-profile"/> for more information.</para>
152 </note>
154 <para>If you've decided to use an alternate prefix, be sure to add
155 <filename class="directory">
156 $XORG_PREFIX/bin</filename> to your
157 <envar>PATH</envar> environment variable, and <filename class="directory">
158 $XORG_PREFIX/lib/pkgconfig</filename> and <filename class="directory">
159 $XORG_PREFIX/share/pkgconfig</filename>
160 to your <envar>PKG_CONFIG_PATH</envar> variable. For detailed instructions,
161 see <xref linkend="postlfs-config-profile"/>. You should also add
162 <filename class="directory">
163 $XORG_PREFIX/lib</filename> to the
164 <filename>/etc/</filename> file. Finally, you should modify
165 <filename>/etc/man_db.conf</filename>, adding appropriate
166 MANDATORY_MANPATH, MANPATH_MAP, and MANDB_MAP entries following the
167 examples for <filename class="directory">/usr/X11R6</filename>.</para>
169 </sect2>
Note: See TracBrowser for help on using the repository browser.