source: x/installing/xorg7.xml@ ff104774

6.3 6.3-rc3
Last change on this file since ff104774 was ff104774, checked in by Randy McMurchy <randy@…>, 15 years ago

Removed extraneous spaces from the XML

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

  • Property mode set to 100644
File size: 8.6 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.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. To see which packages
53 have changed between releases of Xorg, see the upstream
54 <ulink url=";/src/update/">update</ulink>
55 and
56 <ulink url=";/src/deprecated/">deprecated</ulink>
57 directories.</para>
59 <note>
60 <para>Even if you intend to download only the necessary packages, you
61 should download the wget file lists. The list of files are ordered by
62 dependency, and the package versions listed in the files are known to
63 work well with each other. Further, the wget file lists contain comments
64 for specific packages that are deprecated or are not recommended to
65 install. Newer packages are likely intended for the
66 next release of <application>Xorg</application> and have already proved
67 to be incompatible with current versions of software installed in BLFS.
68 The installed size of <application>Xorg</application> can be reduced
69 considerably by installing only the packages that you will need and use,
70 however, the BLFS book cannot account for all dependencies and build
71 options for the individual <application>Xorg</application> packages.
72 The instructions assume that all packages have been built. A
73 <ulink url="&blfs-wiki;/Xorg7">wiki</ulink>
74 page containing dependency information is under development. You are
75 encouraged to add to these pages if you discover additional information
76 that may be helpful to other users who selectively install individual
77 packages.</para>
78 </note>
81 <para>Additionally, because of the large number of repetitive commands,
82 you are encouraged to script the build. For most sections, you can use
83 a script with commands similar to the following, to compile and install
84 all packages in a wget file list:</para>
87 <para>Additionally, because of the large number of repetitive commands,
88 you are encouraged to partially automate the build. The commands below
89 (or similar) can be entered at the command line to compile each group of
90 packages (proto, utils, libs, apps, drivers). The wiki links on each
91 group's page contain specific commands to compile the entire group of
92 packages, based on the content of the wget files.</para>
94<screen>bash -e #exit on all errors
97mkdir $section
98cd $section
100# download and check packages
101grep -v '^#' ../${section}-${version}.wget | wget -i- -c \
102 -B${section}/
103md5sum -c ../${section}-${version}.md5
105# build packages
106for package in $(grep -v '^#' ../${section}-${version}.wget)
108 packagedir=$(echo $package | sed 's/.tar.bz2//')
109 tar -xf $package
110 cd $packagedir
111 ./configure $XORG_CONFIG
112 make
113 make install
114 cd ..
115 rm -rf $packagedir
116 rm -f $package
117done 2&gt;&amp;1 | tee -a ../xorg-${section}-compile.log #log the entire loop</screen>
119 <para>The above shell will exit immediately on error. If it runs to
120 completion, you should manually exit the shell before continuing on to
121 the next set of instructions.</para>
123 <sect2>
124 <title>Setting up the Xorg Build Environment</title>
126 <para>First, you'll need to create a working directory:</para>
128<screen><userinput>mkdir xc &amp;&amp;
129cd xc</userinput></screen>
131 <para>As with previous releases of the X Window System, it may be
132 desirable to install <application>Xorg</application> into an alternate
133 prefix. This is no longer common practice among Linux distributions.
134 The common installation prefix for <application>Xorg</application> on
135 Linux is <filename class="directory">/usr</filename>. There is no
136 standard alternate prefix, nor is there any exception in the current
137 revision of the Filesystem Hierarchy Standard for Release 7 of the X
138 Window System. Alan Coopersmith of Sun Microsystems, has recently
139 stated "At Sun, we were using
140 <filename class="directory">/usr/X11</filename> and plan to stick with
141 it." Only the <filename class="directory">/opt/*</filename> prefix or
142 the <filename class="directory">/usr</filename> prefix adhere to the
143 current FHS guidelines.</para>
145 <para>Choose your installation prefix, and set the
146 <envar>XORG_PREFIX</envar> variable with the following
147 command:</para>
149<screen><userinput>export XORG_PREFIX="<replaceable>&lt;PREFIX&gt;</replaceable>"</userinput></screen>
151 <para>Throughout these instructions, you will use the following
152 <command>configure</command> switches for all of the packages. Create the
153 <envar>XORG_CONFIG</envar> variable to use for this parameter
154 substitution:</para>
156<screen><userinput>export XORG_CONFIG="--prefix=$XORG_PREFIX --sysconfdir=/etc \
157 --mandir=$XORG_PREFIX/share/man --localstatedir=/var"</userinput></screen>
159 <note>
160 <para>Make sure that you also add these variables to your personal or
161 system-wide profile as they are used throughout this book. See
162 <xref linkend="postlfs-config-profile"/> for more information.</para>
163 </note>
165 <para>If you've decided to use an alternate prefix, be sure to add
166 <filename class="directory">
167 $XORG_PREFIX/bin</filename> to your
168 <envar>PATH</envar> environment variable and <filename class="directory">
169 $XORG_PREFIX/lib/pkgconfig</filename>
170 to your <envar>PKG_CONFIG_PATH</envar> variable. For detailed instructions,
171 see <xref linkend="postlfs-config-profile"/>. You should also add
172 <filename class="directory">
173 $XORG_PREFIX/lib</filename> to the
174 <filename>/etc/</filename> file and <filename class="directory">
175 $XORG_PREFIX/share/man</filename> as
176 a MANDATORY_MANPATH in <filename>/etc/man_db.conf</filename>.</para>
178 <para>Packages in Xorg store their configuration files in
179 <filename class="directory">$XORG_PREFIX/lib/X11</filename> by default.
180 This is strictly against FHS guidelines. To simplify installation,
181 create the proper installation directories in
182 <filename class="directory">/etc/X11</filename> and create symlinks
183 in <filename class="directory">$XORG_PREFIX/lib/X11</filename> to
184 satisfy the installation. Execute the following commands as the
185 <systemitem class="username">root</systemitem> user:</para>
187<screen role="root"><userinput>
188install -v -m755 -d \
189 /etc/X11/{app-defaults,fs,twm,xdm,xinit,xkb,xsm} &amp;&amp;
191install -v -m755 -d $XORG_PREFIX/lib/X11 &amp;&amp;
193for link in \
194 /etc/X11/{app-defaults,fs,twm,xdm,xinit,xkb,xsm}
196 ln -sv $link $XORG_PREFIX/lib/X11
200 </sect2>
Note: See TracBrowser for help on using the repository browser.