source: x/installing/xorg.xml@ 0aeb696

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 0aeb696 was 0aeb696, checked in by Randy McMurchy <randy@…>, 18 years ago

Added a comment to each file that may need a mention of a test suite added to it, this allows closing of bug #1697

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

  • Property mode set to 100644
File size: 25.1 KB
RevLine 
[feeb99a]1<?xml version="1.0" encoding="ISO-8859-1"?>
[ff769b8c]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
[feeb99a]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[0aeb696]7 <!-- Inserted as a reminder to do this. The mention of a test suite
8 is usually right before the root user installation commands. Please
9 delete these 12 (including one blank) lines after you are done.-->
10
11 <!-- Use one of the two mentions below about a test suite,
12 delete the line that is not applicable. Of course, if the
13 test suite uses syntax other than "make check", revise the
14 line to reflect the actual syntax to run the test suite -->
15
16 <!-- <para>This package does not come with a test suite.</para> -->
17 <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
18
[3e7ee20]19 <!ENTITY xorg-download-http "http://xorg.freedesktop.org/releases/X11R&xorg-version;/src-single/X11R&xorg-version;-src.tar.bz2 ">
20 <!ENTITY xorg-download-ftp "ftp://expo.x.org/pub/X11R&xorg-version;/src-single/X11R&xorg-version;-src.tar.bz2">
21 <!ENTITY xorg-md5sum "52ad69832db5c36c7041f90625ed4598">
22 <!ENTITY xorg-size "45 MB">
23 <!ENTITY xorg-buildsize "864 MB">
24 <!ENTITY xorg-time "11.68 SBU">
[feeb99a]25]>
26
[e77976f]27<sect1 id="xorg" xreflabel="Xorg-&xorg-version;">
[36c3ba1]28 <?dbhtml filename="xorg.html"?>
29
30 <sect1info>
31 <othername>$LastChangedBy$</othername>
32 <date>$Date$</date>
[76a39aa]33 <keywordset>
34 <keyword role="package">X11R&xorg-version;-src.tar</keyword>
[3f5f915]35 <keyword role="ftpdir">Xorg</keyword>
[76a39aa]36 </keywordset>
[36c3ba1]37 </sect1info>
38
39 <title>Xorg-&xorg-version;</title>
40
41 <indexterm zone="xorg">
42 <primary sortas="a-xorg">Xorg</primary>
43 </indexterm>
44
45 <sect2 role="package">
46 <title>Introduction to Xorg</title>
47
[e77976f]48 <!-- <note>
[3e7ee20]49 <para>There are three packages in BLFS that implement the <application>X
[d9c80e1]50 Window System</application>: <application>Xorg</application>
51 (X11R6 and X11R7) and <application>XFree86</application>. These
52 packages are all quite similar. In fact, the base system of
53 <application>Xorg</application> is
[3e7ee20]54 <application>XFree86</application>-4.4.0RC2. Licensing was the original
55 reason for the split. <application>Xorg-&xorg7-version;</application>
56 introduces a completely autotooled build system, but is otherwise the
[d9c80e1]57 same codebase as <application>Xorg-&xorg-version;</application>.
[36c3ba1]58 Most large commercial distributions have decided to use the
[3e7ee20]59 <application>Xorg</application> package, but several still provide
[36c3ba1]60 <application>XFree86</application>.</para>
61
62 <para>A second reason for the forking of <application>X</application>
63 packages is the stated goals of the developers. Some developers were
64 unhappy with the administration and progress of
65 <application>XFree86</application>. X.org's future plans include
[d9c80e1]66 significant improvements to the internals of the system and more
[3e7ee20]67 frequent releases.</para>
[36c3ba1]68
69 <para><application>XFree86</application> continues to be a solid,
70 conservative application with excellent driver support.</para>
[e77976f]71 </note> -->
[36c3ba1]72
73 <para><application>Xorg</application> is a freely redistributable open-source
74 implementation of the <application>X</application> Window System. This
[3e7ee20]75 system provides a client/server interface between display hardware (the
[36c3ba1]76 mouse, keyboard, and video displays) and the desktop environment, while also
77 providing both the windowing infrastructure and a standardized application
78 interface (API).</para>
79
80 <bridgehead renderas="sect3">Package Information</bridgehead>
81 <itemizedlist spacing="compact">
82 <listitem>
83 <para>Download (HTTP): <ulink url="&xorg-download-http;"/></para>
84 </listitem>
85 <listitem>
86 <para>Download (FTP): <ulink url="&xorg-download-ftp;"/></para>
87 </listitem>
88 <listitem>
89 <para>Download MD5 sum: &xorg-md5sum;</para>
90 </listitem>
91 <listitem>
92 <para>Download size: &xorg-size;</para>
93 </listitem>
94 <listitem>
95 <para>Estimated disk space required: &xorg-buildsize;</para>
96 </listitem>
97 <listitem>
98 <para>Estimated build time: &xorg-time;</para>
99 </listitem>
100 </itemizedlist>
101
[10bffdc8]102 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
103 <itemizedlist spacing="compact">
104 <listitem>
105 <para>Required patch: <ulink
[babac3ec]106 url="&patch-root;/xorg-&xorg-version;-luit_race-1.patch"/></para>
[10bffdc8]107 </listitem>
108 </itemizedlist>
109
[7d7bb83]110 <bridgehead renderas="sect3">Xorg Dependencies</bridgehead>
[36c3ba1]111
112 <bridgehead renderas="sect4">Required</bridgehead>
[76a39aa]113 <para role="required"><xref linkend="libpng"/> and
[36c3ba1]114 <xref linkend="fontconfig"/></para>
115
116 <bridgehead renderas="sect4">Optional</bridgehead>
[76a39aa]117 <para role="optional"><xref linkend="linux-pam"/></para>
[36c3ba1]118
[1663c2b5]119 <para condition="html" role="usernotes">User Notes:
120 <ulink url='&blfs-wiki;/Xorg-&xorg-version;'/></para>
[18bcaf6]121
[36c3ba1]122 <bridgehead renderas="sect3">Download Instructions</bridgehead>
123
124 <para>As an alternative to downloading the entire source tree in a single
[d9c80e1]125 file, there are several, smaller files that can be fetched from the
[3e7ee20]126 download location (directory /pub/X11R&xorg-version;/src/):</para>
[36c3ba1]127
128 <itemizedlist spacing='compact'>
129 <listitem>
130 <para><filename>X11R&xorg-version;-src1.tar.gz</filename></para>
131 </listitem>
132 <listitem>
133 <para><filename>X11R&xorg-version;-src2.tar.gz</filename></para>
134 </listitem>
135 <listitem>
136 <para><filename>X11R&xorg-version;-src3.tar.gz</filename></para>
137 </listitem>
138 <listitem>
139 <para><filename>X11R&xorg-version;-src4.tar.gz</filename></para>
140 </listitem>
141 <listitem>
142 <para><filename>X11R&xorg-version;-src5.tar.gz</filename></para>
143 </listitem>
144 <listitem>
145 <para><filename>X11R&xorg-version;-src6.tar.gz</filename></para>
146 </listitem>
147 <listitem>
148 <para><filename>X11R&xorg-version;-src7.tar.gz</filename></para>
149 </listitem>
150 </itemizedlist>
151
152 <para>The first package contains the <application>Xorg</application>
153 libraries and support programs, the second contains standard
154 <application>X</application> programs, the third contains the
155 <application>X</application> server, the fourth and fifth are fonts,
156 the sixth is normal documentation, and the seventh is hardcopy
157 documentation.</para>
158
159 <para>To check your file for integrity, download the
160 <filename>md5sums</filename> file. Then:</para>
161
162<screen><userinput>md5sum -c md5sums</userinput></screen>
163
164 <para>The package (or all seven packages) should give an OK status.</para>
165
166 </sect2>
167
168 <sect2 role="kernel" id='xorg-kernel'>
169 <title>Kernel Configuration</title>
170
171 <indexterm zone="xorg xorg-kernel">
172 <primary sortas="d-Xorg">Xorg</primary>
173 </indexterm>
174
175 <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
176 recommended that you compile MTRR (Memory Type Range Registers) support
177 into the kernel. The kernel can map Cyrix and AMD CPUs to the MTRR
178 interface, so selecting this option is useful for those processors also.
179 This option is found in the "Processor type and features" menu. It can
180 increase performance of image write operations 2.5 times or more on PCI or
181 AGP video cards.</para>
182
[9ec95e7]183 <para>In the "Character Devices" section of the "Device Drivers" menu,
184 enable AGP Support and select the chipset support on your motherboard. If
185 you do not know the chipset, you may select all the chip types at the
186 expense of extra kernel size. You can usually determine your motherboard's
187 chipset by running the command <command>lspci</command>, a program from the
188 <xref linkend="pciutils"/> package.</para>
[36c3ba1]189
190 <para>In the "Character Devices" section, <emphasis>disable</emphasis>
191 Direct Rendering Manager unless you have a Direct Rendering Infrastructure
192 (DRI) supported video card. A complete list of DRI supported video cards
193 can be found at <ulink url="http://dri.sourceforge.net" /> in the "Status"
194 section. Currently, supported cards include those from 3dfx (Voodoo,
195 Banshee), 3Dlabs, ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel
196 (i810, i815), and Matrox (G200, G400, G450).</para>
197
198 <para>Additionally NVidia provides their own closed source binary drivers,
199 which do not make use of DRI. If you intend to use these drivers, do not
200 enable DRI.</para>
201
202 <para>If you made any changes to the kernel configuration, recompile and
203 install the new kernel.</para>
204
205 </sect2>
206
207 <sect2 role="installation">
208 <title>Installation of Xorg</title>
209
[10bffdc8]210 <sect3>
[3e7ee20]211 <title>Various build fixes</title>
[10bffdc8]212
213 <para>The <application>Xorg</application> sources must be patched in
[3e7ee20]214 order to avoid a race condition with the <application>luit</application>
[aebc72fa]215 program. Additionally, the server portion of
[504d0c05]216 <application>Xorg</application> contains a <ulink
217 url="http://wiki.x.org/wiki/SecurityPage">security vulnerability</ulink>.
218 Fix these issues with the following commands:</para>
[10bffdc8]219
[18bcaf6]220<screen><userinput>patch -Np1 -i ../xorg-&xorg-version;-luit_race-1.patch &amp;&amp;
[504d0c05]221sed -i 's/geteuid /geteuid() /' \
222 programs/Xserver/hw/xfree86/common/xf86Init.c</userinput></screen>
[3e7ee20]223
[aebc72fa]224
225<!-- To be removed if/when proposed glibc patch is added to LFS SVN
226 Leave in in for a couple of weeks with 'you may need' and a testcase
227 around it to save the support list silly questions. Should remove in
228 a couple of weeks -->
229 <para>Recent glibc may have a problem with it's installed sys/kd.h file.
230 This has recently been fixed in LFS svn. Execute the
231 following commands to work around a broken kd.h file. The commands will
232 only make the modification if needed:</para>
233
234<screen><userinput>grep "__undef_LINUX" \
235 /usr/include/sys/kd.h 2&gt;&amp;1 &gt; /dev/null || \
236 sed -i.bak '/CONFIG_H/i #include &lt;linux/types.h&gt;' \
237 programs/Xserver/hw/xfree86/os-support/linux/lnx_agp.c</userinput></screen>
238<!-- End remove -->
239
240
241
[d9c80e1]242 <para>Additionally, if you choose to install
243 <application>Xorg</application> to any prefix other than
[3e7ee20]244 <filename class="directory">/usr/X11R6</filename>, the luit package
[d9c80e1]245 needs another correction to fix a hard coded path. Execute the
[3e7ee20]246 following command:</para>
247
[c5c2654]248<screen><userinput>sed -i 's@/usr/X11R6@<replaceable>&lt;/usr&gt;</replaceable>@' programs/luit/parser.h</userinput></screen>
[10bffdc8]249
250 </sect3>
251
[36c3ba1]252 <sect3>
253 <title>Suppressing Xprint-related Modification to '/etc'</title>
254
255 <para><application>Xorg</application> insists on putting
256 its boot and profile scripts into the <filename
257 class="directory">/etc</filename> directory even if specifically told
258 not to compile anything Xprint server or client related (see
259 <filename>host.def</filename> below). The following command will
260 suppress any such modifications:</para>
261
262<screen><userinput>sed -i '/^SUBDIRS =/s/ etc$//' programs/Xserver/Xprint/Imakefile</userinput></screen>
263
264 </sect3>
265
266 <sect3>
267 <title>Setting Up a Shadow Directory</title>
268
269 <para>When building <application>Xorg</application>, you should create
270 a shadow directory of symbolic links for the compiled code. To do that,
271 first make <command>lndir</command>. Starting from the
272 <filename class='directory'>xc</filename> directory:</para>
273
274<screen><userinput>pushd config/util &amp;&amp;
[9a2fba9]275make -f Makefile.ini lndir
276popd</userinput></screen>
[36c3ba1]277
278 <para>Now create the shadow tree:</para>
279
280<screen><userinput>mkdir ../xcbuild &amp;&amp;
[feeb99a]281cd ../xcbuild &amp;&amp;
[9a2fba9]282../xc/config/util/lndir ../xc</userinput></screen>
[36c3ba1]283
284 </sect3>
285
286 <sect3>
287 <title>Creating 'host.def'</title>
288
289 <para>The next step is to create the
290 <filename>config/cf/host.def</filename> file. The documentation for
291 <application>Xorg</application> indicates that the application will
292 build without a <filename>host.def</filename> file, but the included
293 libraries for <application>Fontconfig</application> and
294 <application>FreeType2</application> do not build properly on a base
295 LFS system. Therefore, you must specify that these libraries, as well
296 as others, should be imported from the system.</para>
297
298 <note>
299 <para><filename>config/cf/host.def</filename> is a C file, not a
300 shell script. Ensure the comments delimited by /* ... */ are balanced
301 when modifying the file.</para>
302 </note>
303
304<screen><userinput>cat &gt; config/cf/host.def &lt;&lt; "EOF"
305<literal>/* Begin Xorg host.def file */
306
[feeb99a]307/* System Related Information. If you read and configure only one
[36c3ba1]308 * section then it should be this one. The Intel architecture defaults
309 * are set for a i686 and higher. Axp is for the Alpha architecture
310 * and Ppc is for the Power PC. AMD64 is for the Opteron processor.
311 * Note that there have been reports that the Ppc optimization line
312 * causes segmentation faults during build. If that happens, try
[47603ac1]313 * building without the DefaultGcc2PpcOpt line. ***********/
[36c3ba1]314
[a592e42]315/* #define DefaultGcc2i386Opt -O2 -fno-strength-reduce \
316 -fno-strict-aliasing -march=i686 */
317/* #define DefaultGcc2AMD64Opt -O2 -fno-strength-reduce \
318 -fno-strict-aliasing */
319/* #define DefaultGcc2AxpOpt -O2 -mcpu=ev6 */
320/* #define DefaultGcc2PpcOpt -O2 -mcpu=750 */
[feeb99a]321
[7461475]322#define HasFreetype2 YES
323#define HasFontconfig YES
324#define HasExpat YES
325#define HasLibpng YES
326#define HasZlib YES
[feeb99a]327
328/*
[36c3ba1]329 * Which drivers to build. When building a static server, each of
330 * these will be included in it. When building the loadable server
[47603ac1]331 * each of these modules will be built.
[feeb99a]332 *
333#define XF86CardDrivers mga glint nv tga s3virge sis rendition \
334 neomagic i740 tdfx savage \
335 cirrus vmware tseng trident chips apm \
336 GlideDriver fbdev i128 \
[5c8344d]337 ati DevelDrivers ark \
[47603ac1]338 cyrix siliconmotion vesa vga \
339 XF86OSCardDrivers XF86ExtraCardDrivers
[feeb99a]340*/
341
342/*
343 * Select the XInput devices you want by uncommenting this.
344 *
345#define XInputDrivers mouse keyboard acecad calcomp citron \
346 digitaledge dmc dynapro elographics \
[47603ac1]347 microtouch mutouch penmount spaceorb \
348 summa wacom void magictouch aiptek
[feeb99a]349 */
350
351/* Most installs will only need this */
352
353#define XInputDrivers mouse keyboard
354
[3e7ee20]355/* Xterm is no longer built by default */
356#define BuildXterm YES
357
[fb0480d5]358/* Disable building Xprint server and clients until we get them figured
359 * out but build Xprint libraries to allow precompiled binaries such as
360 * Acrobat Reader to run.
361 */
[7461475]362
[fb0480d5]363#define XprtServer NO
364#define BuildXprintClients NO
[feeb99a]365
[2ee51e6]366/* Uncomment the following define if you would prefer to install X into
367 * /usr or change it to any other location that you prefer.
[bccbdaea]368 * The GL related defines disable compatibility symlinks (the links
[310cc9a]369 * are not needed when X is installed in /usr).
[f84ff8d]370#define ProjectRoot /usr
371#define LinkGLToUsrInclude NO
372#define LinkGLToUsrLib NO
[2ee51e6]373 */
374
[36c3ba1]375/* End Xorg host.def file */</literal>
376EOF</userinput></screen>
[feeb99a]377
[36c3ba1]378 <para>There are several other options that you may want to consider.
379 A well documented example file is
380 <filename>config/cf/xorgsite.def</filename>.</para>
[2826127]381
[36c3ba1]382 </sect3>
[feeb99a]383
[36c3ba1]384 <sect3>
385 <title>Build Commands</title>
[2826127]386
[36c3ba1]387 <para>Install <application>Xorg</application> by running the
388 following commands:</para>
389
390<screen><userinput>sed -i -e "s@^#include &lt;linux/config.h&gt;@/* &amp; */@" \
[df3a050]391 `grep -lr linux/config.h *` &amp;&amp;
[36c3ba1]392( make World 2&gt;&amp;1 | tee xorg-compile.log &amp;&amp; exit $PIPESTATUS )</userinput></screen>
393
394 <para>Again as the <systemitem class="username">root</systemitem>
395 user:</para>
[2826127]396
[36c3ba1]397<screen role="root"><userinput>make install &amp;&amp;
[32077ed]398make install.man</userinput></screen>
399
400 <para>If you've installed <application>Xorg</application> in the default
[d9c80e1]401 prefix listed above, run the following commands as the
[32077ed]402 <systemitem class="username">root</systemitem> user:</para>
403
404<screen role="root"><userinput>ln -v -s ../X11R6/bin /usr/bin/X11 &amp;&amp;
[b2febe4e]405ln -v -s ../X11R6/lib/X11 /usr/lib/X11 &amp;&amp;
406ln -v -s ../X11R6/include/X11 /usr/include/X11</userinput></screen>
[36c3ba1]407
[18bcaf6]408 <para>The <application>Xorg</application> fonts have been installed
409 outside of <application>Fontconfig</application>'s default search path
410 of <filename class="directory">/usr/share/fonts</filename>. In order
411 for <application>Fontconfig</application> to find the installed TrueType
412 fonts, you should make symlinks to their directories. Assuming you've
413 installed <application>Xorg</application> in the default prefix, run the
414 following commands as the <systemitem class="username">root</systemitem>
415 user:</para>
416
[aebc72fa]417<screen role="root"><userinput>install -d -m755 /usr/share/fonts &amp;&amp;
418ln -svn /usr/X11R6/lib/X11/fonts/OTF /usr/share/fonts/X11-OTF &amp;&amp;
[18bcaf6]419ln -svn /usr/X11R6/lib/X11/fonts/TTF /usr/share/fonts/X11-TTF</userinput></screen>
420
[36c3ba1]421 </sect3>
422
423 </sect2>
424
425 <sect2 role="commands">
426 <title>Command Explanations</title>
427
428 <para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>:
[2826127]429 The <application>Linux-Libc-Headers</application> package installed in
[36c3ba1]430 LFS installs a <filename>/usr/include/linux/config.h</filename> file
431 which is not compatible with userspace applications. The recommended fix
432 for applications including this file is to remove it (see <ulink
[2826127]433 url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
434 linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
[bfb7882]435 <command>grep -lr</command> to replace all occurrences. If you desire, just
[2826127]436 remove (comment) the line in the appropriate video driver file if you
[36c3ba1]437 customized <filename>host.def</filename>.</para>
438
439 <para><command>( make World 2&gt;&amp;1 | tee xorg-compile.log
440 &amp;&amp; exit $PIPESTATUS )</command>: This command runs multiple
441 <filename>Makefile</filename>s to completely rebuild the system.
442 <parameter>2&gt;&amp;1</parameter> redirects error messages to the
443 same location as standard output. The <command>tee</command> command
444 allows viewing of the output while logging the results to a file. The
[bfb7882]445 parentheses around the command runs the entire command in a subshell
[36c3ba1]446 and finally the <command>exit $PIPESTATUS</command> ensures the result
447 of the <command>make</command> is returned as the result and not the
448 result of the <command>tee</command> command.</para>
449
450 <note>
451 <para>When rebuilding <application>Xorg</application>, a separate
452 command that may be used if only minor changes are made to the sources
453 is <command>make Everything</command>. This does not automatically
454 remove generated files and only rebuilds those files or programs that
455 are out of date.</para>
456 </note>
457
[b2febe4e]458 <para><command>ln -v -s ...</command>: These commands are present to
[36c3ba1]459 enable other (broken) packages to build against
460 <application>Xorg</application>, even though the Filesystem Hierarchy
461 Standard says: <quote>In general, software must not be installed or
462 managed via the above symbolic links. They are intended for utilization
463 by users only.</quote></para>
464
465 </sect2>
466
467 <sect2 role="configuration" id='xorg-config'>
468 <title>Configuring Xorg</title>
469
470 <para>Edit <filename>/etc/ld.so.conf</filename> and add
471 <filename class="directory">/usr/X11R6/lib</filename>. Run:</para>
472
473 <indexterm zone="xorg xorg-config">
474 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
475 </indexterm>
476
477<screen role="root"><userinput>ldconfig</userinput></screen>
478
479 <para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
480 and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
481 are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
482 environment variables, respectively. Instructions for doing this are
483 described in the section <xref linkend='postlfs-config-profile'/>.</para>
484
485 <para>Create the <filename>xorg.conf</filename> file with:</para>
486
[5ee44e37]487<screen><userinput>cd ~ &amp;&amp;
[36c3ba1]488Xorg -configure</userinput></screen>
489
490 <para>The screen will go black and you may hear some clicking of the monitor.
491 This command will create a file, <filename>xorg.conf.new</filename> in your
492 home directory.</para>
493
494 <indexterm zone="xorg xorg-config">
495 <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
496 </indexterm>
497
498 <para>Edit <filename>xorg.conf.new</filename> to suit your system. The
499 details of the file are located in the xorg.conf man page. Some things
500 you may want to do are:</para>
501
502 <itemizedlist>
503 <listitem>
504 <para>Section "Files". Change the order of the font paths searched.
505 You may want to put 100dpi fonts ahead of 75dpi fonts if your system
506 normally comes up closer to 100 dots per inch. You may want to remove
507 some font directories completely.</para>
508 </listitem>
509 <listitem>
510 <para>Section "Module". If you are going to install NVidia
511 drivers, remove the "dri" line.</para>
512 </listitem>
513 <listitem>
514 <para>Sections "InputDevice". You may want to change the
515 keyboard autorepeat rate by adding
516 <option>Option "Autorepeat" "250 30"</option>.</para>
517 </listitem>
518 <listitem>
519 <para>Section "Monitor". Specify the <option>VertRefresh</option>
520 and <option>HorizSync</option> values if the system does not
521 automatically detect the monitor and its values.</para>
522 </listitem>
523 <listitem>
524 <para>Section "Device". You may want to set some of the options
525 available for your selected video driver. A description of the driver
526 parameters is in the man page for your driver.</para>
527 </listitem>
528 <listitem><para>Section "Screen". Add a DefaultDepth statement such as:
529 <option>DefaultDepth 24</option>. In the SubSection for your
530 default depth, add a modes line such as:
531 <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The first
532 mode listed will normally be the starting resolution.</para>
533 </listitem>
534 </itemizedlist>
535
536 <para>Test the system with:</para>
537
538<screen><userinput>X -config ~/xorg.conf.new</userinput></screen>
539
540 <para>You will only get a gray background with an X-shaped mouse cursor,
541 but it confirms the system is working. Exit with
542 <keycap>Control+Alt+Backspace</keycap>. If the system does not work, take
543 a look at <filename>/var/log/Xorg.0.log</filename> to see what went
544 wrong.</para>
545
546 <para>Move the configuration file to its final location:</para>
547
548<screen role="root"><userinput>mv ~/xorg.conf.new /etc/X11/xorg.conf</userinput></screen>
549
550 <para>Create <filename>.xinitrc</filename>:</para>
551
552<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
553<literal># Begin .xinitrc file
[feeb99a]554xterm -g 80x40+0+0 &amp;
555xclock -g 100x100-0+0 &amp;
[36c3ba1]556twm</literal>
557EOF</userinput></screen>
558
559 <para>This provides an initial screen with an xterm and a clock that is
560 managed by a simple window manager, Tab Window Manager. For details of
561 <command>twm</command>, see the man page.</para>
562
563 <indexterm zone="xorg xorg-config">
564 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
565 </indexterm>
566
567 <note>
568 <para>When needed, <application>Xorg</application> creates the directory
569 <filename>/tmp/.ICE-unix</filename> if it does not exist. If this
570 directory is not owned by <systemitem class="username">root</systemitem>,
571 <application>Xorg</application> delays startup by a few seconds and also
572 appends a warning to the logfile. This also affects startup of other
573 applications. To improve performance, it is advisable to manually create
574 the directory before <application>Xorg</application> uses it. Add the
575 file creation to <filename>/etc/sysconfig/createfiles</filename> that is
576 sourced by the <filename>/etc/rc.d/init.d/cleanfs</filename> startup
577 script.</para>
578
579<screen role="root"><userinput>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
580<literal>/tmp/.ICE-unix dir 1777 root root</literal>
581EOF</userinput></screen>
582
583 </note>
584
585 <indexterm zone="xorg xorg-config">
586 <primary
587 sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
588 </indexterm>
589
590 <para>Start <application>X</application> with:</para>
591
592<screen><userinput>startx</userinput></screen>
593
594 <para>to get a basic functional <application>X Window
595 System</application>.</para>
596
597 <para>At this point, you should check out <xref linkend='x-setup'/> for
598 the necessary configuration to make <application>X</application> fully
599 functional. Additionally, you can have a look at <xref linkend='x-config'/>
600 for information on fine tuning your <application>X</application>
601 configuration.</para>
602
603 <para>For a list of the package contents and a description of the commands,
604 see the sections in the <xref linkend='xfree86-contents'/>.</para>
605
606 </sect2>
[d5d9ceb]607
[feeb99a]608</sect1>
Note: See TracBrowser for help on using the repository browser.