source: x/installing/xorg7.xml@ 50631cf

10.0 10.1 11.0 11.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 50631cf was 50631cf, checked in by Dan Nichilson <dnicholson@…>, 15 years ago

Added more links to the Xorg7 intro page and fixed a wiki link

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6783 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 6.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="xorg7" xreflabel="Xorg-&xorg7-version;">
9 <?dbhtml filename="xorg7.html"?>
10
11 <sect1info>
12 <othername>$LastChangedBy$</othername>
13 <date>$Date$</date>
14 </sect1info>
15
16 <title>Introduction to Xorg-&xorg7-version;</title>
17
18 <indexterm zone="xorg7">
19 <primary sortas="a-xorg7">Xorg</primary>
20 </indexterm>
21
22
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>
29
30 <para condition="html" role="usernotes">User Notes:
31 <ulink url='&blfs-wiki;/Xorg7'/></para>
32
33 <bridgehead renderas="sect3">Xorg Download and Installation
34 Instructions</bridgehead>
35
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>
44
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="http://wiki.x.org/wiki/ModuleDescriptions">this page</ulink>
49 and
50 <ulink url="http://lists.x.org/archives/xorg-modular/2005-November/000801.html">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="http://xorg.freedesktop.org/releases/X11R&xorg7-version;/src/update/">update</ulink>
55 and
56 <ulink url="http://xorg.freedesktop.org/releases/X11R&xorg7-version;/src/deprecated/">deprecated</ulink>
57 directories.</para>
58
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. Newer packages are likely intended for the
64 next release of <application>Xorg</application> and have already proved
65 to be incompatible with current versions of software installed in BLFS.
66 The installed size of <application>Xorg</application> can be reduced
67 considerably by installing only the packages that you will need and use,
68 however, the BLFS book cannot account for all dependencies and build
69 options for the individual <application>Xorg</application> packages.
70 The instructions assume that all packages have been built. A
71 <ulink url="&blfs-wiki;/Xorg7">wiki</ulink>
72 page containing dependency information is under development. You are
73 encouraged to add to these pages if you discover additional information
74 that may be helpful to other users who selectively install individual
75 packages.</para>
76 </note>
77
78 <para>Additionally, because of the large number of repetitive commands,
79 you are encouraged to script the build. For most sections, you can use
80 a script with commands similar to the following, to compile and install
81 all packages in a wget file list:</para>
82
83<screen>bash -e #exit on all errors
84for package in $(cat ../wgetlist.wget)
85do
86 packagedir=$(echo $package | sed 's/.tar.bz2//')
87 tar -xf $package
88 cd $packagedir
89 ./configure $XORG_CONFIG
90 make
91 make install
92 cd ..
93 rm -rf $packagedir
94 rm -f $package
95done 2&gt;&amp;1 | tee -a ../xorg-compile.log #log the entire loop</screen>
96
97 <para>The above shell will exit immediately on error. If it runs to
98 completion, you should manually exit the shell before continuing on to
99 the next set of instructions.</para>
100
101 <sect2>
102 <title>Setting up the Xorg Build Environment</title>
103
104 <para>First, you'll need to create a working directory:</para>
105
106<screen><userinput>mkdir xc &amp;&amp;
107cd xc</userinput></screen>
108
109 <para>As with previous releases of the X Window System, it may be
110 desirable to install <application>Xorg</application> into an alternate
111 prefix. This is no longer common practice among Linux distributions.
112 The common installation prefix for <application>Xorg</application> on
113 Linux is <filename class="directory">/usr</filename>. There is no
114 standard alternate prefix, nor is there any exception in the current
115 revision of the Filesystem Hierarchy Standard for Release 7 of the X
116 Window System. Alan Coopersmith of Sun Microsystems, has recently
117 stated "At Sun, we were using
118 <filename class="directory">/usr/X11</filename> and plan to stick with
119 it." Only the <filename class="directory">/opt/*</filename> prefix or
120 the <filename class="directory">/usr</filename> prefix adhere to the
121 current FHS guidelines.</para>
122
123 <para>Choose your installation prefix, and set the
124 <envar>XORG_PREFIX</envar> variable with the following
125 command:</para>
126
127<screen><userinput>export XORG_PREFIX="<replaceable>&lt;PREFIX&gt;</replaceable>"</userinput></screen>
128
129 <para>Throughout these instructions, you will use the following
130 <command>configure</command> switches for all of the packages. Create the
131 <envar>XORG_CONFIG</envar> variable to use for this parameter
132 substitution:</para>
133
134<screen><userinput>export XORG_CONFIG="--prefix=$XORG_PREFIX --sysconfdir=/etc \
135 --mandir=$XORG_PREFIX/share/man --localstatedir=/var"</userinput></screen>
136
137 <para>If you've decided to use an alternate prefix, be sure to add
138 <filename class="directory">
139 <replaceable>&lt;PREFIX&gt;</replaceable>/bin</filename> to your
140 <envar>PATH</envar> environment variable and <filename class="directory">
141 <replaceable>&lt;PREFIX&gt;</replaceable>/lib/pkgconfig</filename>
142 to your <envar>PKG_CONFIG_PATH</envar> variable. For detailed instructions,
143 see <xref linkend="postlfs-config-profile"/>. You should also add
144 <filename class="directory">
145 <replaceable>&lt;PREFIX&gt;</replaceable>/lib</filename> to the
146 <filename>/etc/ld.so.conf</filename> file and <filename class="directory">
147 <replaceable>&lt;PREFIX&gt;</replaceable>/share/man</filename> as
148 a MANDATORY_MANPATH in <filename>/etc/man_db.conf</filename>.</para>
149
150 </sect2>
151
152</sect1>
Note: See TracBrowser for help on using the repository browser.