source: x/installing/xfree86.xml@ 84da85a

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 84da85a 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: 34.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
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
19 <!ENTITY xfree86-download-http "http://gnu.kookel.org/ftp/XFree86/&xfree86-version;/source/">
20 <!ENTITY xfree86-download-ftp "ftp://ftp.xfree86.org/pub/XFree86/&xfree86-version;/source/">
21 <!ENTITY xfree86-md5sum "ftp://ftp.xfree86.org/pub/XFree86/&xfree86-version;/source/SUMS.md5sum">
22 <!ENTITY xfree86-size "51 MB">
23 <!ENTITY xfree86-buildsize "775 MB">
24 <!ENTITY xfree86-time "12 SBU">
25]>
26
27<sect1 id="xfree86" xreflabel="XFree86-&xfree86-version;">
28 <?dbhtml filename="xfree86.html" ?>
29
30 <sect1info>
31 <othername>$LastChangedBy$</othername>
32 <date>$Date$</date>
33 <keywordset>
34 <keyword role="package">XFree86-&xfree86-version;-src-1.tar</keyword>
35 <keyword role="ftpdir">XFree86</keyword>
36 </keywordset>
37 </sect1info>
38
39 <title>XFree86-&xfree86-version;</title>
40
41 <indexterm zone="xfree86">
42 <primary sortas="a-xfree86">XFree86</primary>
43 </indexterm>
44
45 <sect2 role="package">
46 <title>Introduction to XFree86</title>
47
48 <para><application>XFree86</application> is a freely redistributable
49 open-source implementation of the <application>X Window
50 System</application>. <application>XFree86</application> provides a
51 client/server interface between display hardware (the mouse, keyboard,
52 and video displays) and the desktop environment, while also providing
53 both the windowing infrastructure and a standardized application
54 interface (API).</para>
55
56 <bridgehead renderas="sect3">Package Information</bridgehead>
57 <itemizedlist spacing="compact">
58 <listitem>
59 <para>Download (HTTP): <ulink url="&xfree86-download-http;"/></para>
60 </listitem>
61 <listitem>
62 <para>Download (FTP): <ulink url="&xfree86-download-ftp;"/></para>
63 </listitem>
64 <listitem>
65 <para>Download MD5 sum: &xfree86-md5sum;</para>
66 </listitem>
67 <listitem>
68 <para>Download size: &xfree86-size;</para>
69 </listitem>
70 <listitem>
71 <para>Estimated disk space required: &xfree86-buildsize;</para>
72 </listitem>
73 <listitem>
74 <para>Estimated build time: &xfree86-time;</para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing='compact'>
80 <listitem>
81 <para>Required patch: <ulink
82 url="&patch-root;/XFree86-&xfree86-version;-kernel_headers-1.patch"/>
83 </para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">XFree86 Dependencies</bridgehead>
88
89 <bridgehead renderas="sect4">Required</bridgehead>
90 <para role="required"><xref linkend="libpng"/></para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional"><xref linkend="linux-pam"/>; the
94 following packages are included in the <application>XFree86</application>
95 package, however they are updated more often than the
96 <application>XFree86</application> package and are highly recommended:
97 <xref linkend="expat"/>, <xref linkend="freetype2"/>,
98 <xref linkend="fontconfig"/>.</para>
99
100 <note>
101 <para>If you choose not to install <application>expat</application>,
102 <application>FreeType2</application>, and
103 <application>Fontconfig</application>, the
104 <filename>host.def</filename> file below will have to be modified to
105 instruct <application>XFree86</application> to build them.</para>
106 </note>
107
108 <para condition="html" role="usernotes">User Notes:
109 <ulink url='&blfs-wiki;/XFree86-&xfree86-version;'/></para>
110
111 <bridgehead renderas="sect3">Download Instructions</bridgehead>
112
113 <para>There are several files that need to be fetched from the download
114 location:</para>
115
116 <itemizedlist spacing='compact'>
117 <listitem>
118 <para><filename>XFree86-&xfree86-version;-src-1.tgz</filename></para>
119 </listitem>
120 <listitem>
121 <para><filename>XFree86-&xfree86-version;-src-2.tgz</filename></para>
122 </listitem>
123 <listitem>
124 <para><filename>XFree86-&xfree86-version;-src-3.tgz</filename></para>
125 </listitem>
126 <listitem>
127 <para><filename>XFree86-&xfree86-version;-src-4.tgz</filename></para>
128 </listitem>
129 <listitem>
130 <para><filename>XFree86-&xfree86-version;-src-5.tgz</filename></para>
131 </listitem>
132 <listitem>
133 <para><filename>XFree86-&xfree86-version;-src-6.tgz</filename></para>
134 </listitem>
135 <listitem>
136 <para><filename>XFree86-&xfree86-version;-src-7.tgz</filename></para>
137 </listitem>
138 </itemizedlist>
139
140 <para>The first three packages are the <application>XFree86</application>
141 programs, the fourth and fifth are fonts, the sixth is normal documentation,
142 and the seventh is hardcopy documentation. There are also two packages
143 <filename>doctools-1.3.x.tgz</filename>, which contain programs to
144 regenerate hardcopy documentation, and <filename>utils-1.1.x.tgz</filename>,
145 which contain <application>GNU TAR</application> and
146 <application>zlib</application> which are already installed on an
147 LFS system.</para>
148
149 <para>To check your downloads for integrity, download the
150 <filename>SUMS.md5sum</filename> file. Then:</para>
151
152<screen><userinput>md5sum -c SUMS.md5sum</userinput></screen>
153
154 <para>The only errors you should see are for <filename>README</filename>,
155 <filename>doctools-1.3.x.tgz</filename>, <filename>utils-1.1.x.tgz</filename>
156 and <filename>XFree86-xtest-4.0.x.tar.bz2</filename> files if you did not
157 download them.</para>
158
159<!--
160<para>The fixes subdirectory also has a <filename>SUMS.md5sum</filename>. Note that
161this is the same filename as the sums for the main sources, so you need to rename the
162file if you download it. Otherwise, you can just look at it and use it to
163check against the patch files:</para>
164<screen><userinput><command>md5sum 4.3.0-4.3.0.1.diff.gz</command></userinput>
165<userinput><command>md5sum fontfile.diff</command></userinput></screen>
166
167<para>After unpacking the <filename>X430src-?.tgz</filename> files and uncompressing the
168diff file, change to the <filename class="directory">xc</filename> directory and run:</para>
169
170<screen><userinput><command>patch -Np1 -i ../4.3.0-4.3.0.1.diff</command></userinput>
171<userinput><command>pushd lib/font/fontfile/</command></userinput>
172<userinput><command>patch -N -i ../../../../fontfile.diff</command></userinput>
173<userinput><command>popd</command></userinput></screen>
174-->
175
176 </sect2>
177
178 <sect2 role="kernel" id='xfree86-kernel'>
179 <title>Kernel Configuration</title>
180
181 <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
182 recommended that you compile MTRR (Memory Type Range Registers) support
183 into the kernel. The kernel can map Cyrix and AMD CPUs to the MTRR
184 interface, so selecting this option is useful for those processors also.
185 This option is found in the "Processor type and features" menu. It can
186 increase performance of image write operations 2.5 times or more on PCI
187 or AGP video cards.</para>
188
189 <indexterm zone="xfree86 xfree86-kernel">
190 <primary sortas="d-xfree86">XFree86</primary>
191 </indexterm>
192
193 <para>In the "Character Devices" section, enable AGP Support and select
194 the chipset support on your motherboard. If you do not know the chipset,
195 you may select all the chip types at the expense of extra kernel size.
196 You can usually determine your motherboard's chipset by running the
197 command <command>lspci</command>, a program from the
198 <xref linkend="pciutils"/> package.</para>
199
200 <para>In the "Character Devices" section, <emphasis>disable</emphasis>
201 Direct Rendering Manager unless you have a Direct Rendering Infrastructure
202 (DRI) supported video card. A complete list of DRI supported video cards
203 can be found at <ulink url="http://dri.sourceforge.net" /> in the Status
204 section. Currently, supported cards include those from 3dfx (Voodoo,
205 Banshee), 3Dlabs, ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel
206 (i810, i815), and Matrox (G200, G400, G450).</para>
207
208 <para>Additionally NVidia provides their own closed source binary drivers,
209 which do not make use of DRI. If you intend to use these drivers, do not
210 enable DRI.</para>
211
212 <para>If you made any changes to the kernel configuration, recompile and
213 install the new kernel.</para>
214
215 </sect2>
216
217 <sect2 role="installation">
218 <title>Installation of XFree86</title>
219
220 <sect3>
221 <title>Setting Up a Shadow Directory</title>
222
223 <para>When building <application>XFree86</application>, you should create
224 a shadow directory of symbolic links for the compiled code. To do that,
225 first make <command>lndir</command>. Starting from the
226 <filename class='directory'>xc</filename> directory:</para>
227
228<screen><userinput>pushd config/util &amp;&amp;
229make -f Makefile.ini lndir
230popd</userinput></screen>
231
232 <para>Now create the shadow tree:</para>
233
234<screen><userinput>mkdir ../xcbuild &amp;&amp;
235cd ../xcbuild &amp;&amp;
236../xc/config/util/lndir ../xc</userinput></screen>
237
238 </sect3>
239
240 <sect3>
241 <title>Creating 'host.def'</title>
242
243 <para>Although <application>XFree86</application> will compile without
244 a <filename>host.def</filename> file, the following file is recommended
245 for customizing the installation. Start from the
246 <filename class="directory">xcbuild</filename> directory.</para>
247
248 <note>
249 <para>The <filename>host.def</filename> file is a
250 <application>C</application> file, not the usual configuration file.
251 If you make any changes, be sure the comment characters (/* and */)
252 are balanced. Most of the entries in the file below are commented
253 out with the default settings shown.</para>
254 </note>
255
256<screen><userinput>cat &gt; config/cf/host.def &lt;&lt; "EOF"
257<literal>/* Begin XFree86 host.def file */
258
259/* System Related Information. If you read and configure only one
260 * section then it should be this one. The Intel architecture defaults
261 * are set for a i686 and higher. Axp is for the Alpha architecture
262 * and Ppc is for the Power PC. Note that there have been reports that
263 * the Ppc optimization line causes segmentation faults during build.
264 * If that happens, try building without the DefaultGcc2PpcOpt line. */
265
266/* #define DefaultGcc2i386Opt -O2 -fomit-frame-pointer -march=i686 */
267/* #define DefaultGcc2AxpOpt -O2 -mcpu=ev6 */
268/* #define DefaultGcc2PpcOpt -O2 -mcpu=750 */
269
270/* The following definitions are normally set properly by XFree86's
271 * scripts. You can uncomment them if you want to make sure. *********/
272
273/* #define HasMTRRSupport YES */ /* Enabled in kernel; */
274 /* see kernel docs */
275/* #define HasMMXSupport NO */ /* Any i586 or above */
276/* #define HasKatmaiSupport NO */ /* PIII SSE instructions */
277/* #define Has3DNowSupport NO */ /* AMD instructions */
278
279
280/* This setting reduces compile time a little by omitting rarely used
281 * input devices. You can find the complete list in
282 * config/cf/xfree86.cf *********************************************/
283
284#define XInputDrivers mouse void
285
286/* VIDEO DRIVERS ****************************************************/
287
288/* If you are sure you only want the drivers for one or a few video
289 * cards, you can delete the drivers you do not want. ***************/
290
291
292#define XF86CardDrivers mga glint nv tga s3 s3virge sis rendition \
293 neomagic i740 tdfx savage \
294 cirrus vmware tseng trident chips apm \
295 GlideDriver fbdev i128 nsc \
296 ati i810 DevelDrivers ark \
297 cyrix siliconmotion \
298 vesa vga \
299 dummy XF86OSCardDrivers XF86ExtraCardDrivers
300
301
302/* USER AND SYSTEM DEFAULT PATHS *************************************/
303
304/* These settings set the PATH variables used by xdm. See README for */
305/* detailed description and modify the following as per your need. ***/
306
307/* #define DefaultSystemPath \
308 /usr/bin:/bin:/usr/sbin:/sbin:/usr/X11R6/bin */
309/* #define DefaultUserPath /usr/bin:/bin:/usr/X11R6/bin */
310
311/* FONT SERVER AND LIBRARY SETTINGS **********************************/
312
313/* These settings are the defaults **********************************/
314
315/* #define BuildFontServer YES */ /*For Ghostscript Print Server*/
316/* #define SharedLibFont YES */
317/* #define CompressAllFonts YES */
318/* #define GzipFontCompression YES */
319
320/* These settings ensure we use our libraries ************************/
321#define HasFreetype2 YES
322#define HasFontconfig YES
323#define HasExpat YES
324#define HasLibpng YES
325#define HasZlib YES
326
327/* INTERNATIONAL FONTS. Change to YES if you need any of them. These
328 * are the defaults. **************************************************/
329
330/* #define BuildCyrillicFonts NO */
331/* #define BuildArabicFonts NO */
332/* #define BuildISO8859_6Fonts NO */
333/* #define BuildGreekFonts NO */
334/* #define BuildISO8859_7Fonts NO */
335/* #define BuildHebrewFonts NO */
336/* #define BuildISO8859_8Fonts NO */
337/* #define BuildKOI8_RFonts NO */
338/* #define BuildJapaneseFonts NO */
339/* #define BuildJISX0201Fonts NO */
340/* #define BuildKoreanFonts NO */
341/* #define BuildChineseFonts NO */
342
343/* DOCUMENTATION SETTINGS ********************************************/
344
345/* These setting are the defaults. ***********************************/
346
347/* #define BuildLinuxDocHtml NO */ /* X Docs in Html format */
348/* #define BuildLinuxDocPS NO */ /* PostScript format */
349/* #define BuildAllSpecsDocs NO */ /* Various docs */
350/* #define BuildHtmlManPages NO */
351
352/* GENERAL SETTINGS: You generally want to leave these alone when
353 * building X on an LFS system ***************************************/
354
355#define GccWarningOptions -pipe /* Speed up compiles */
356#define TermcapLibrary -lncurses
357#define XprtServer YES /* Needed by realplayer */
358#define XnestServer YES
359#define XAppLoadDir EtcX11Directory/app-defaults
360#define VarLibDir /var/lib
361#define XFree86Devel NO
362#define FSUseSyslog YES
363#define ThreadedX YES
364#define HasPam NO
365#define SystemManDirectory /usr/share/man /*Instead of /usr/man*/
366#define HasLibCrypt YES
367#define InstallXinitConfig YES
368#define InstallXdmConfig YES
369#define ForceNormalLib YES
370#define BuildSpecsDocs NO
371
372/* End XFree86 host.def file */</literal>
373EOF</userinput></screen>
374
375 <para>Edit the file for your hardware and desires.</para>
376
377 </sect3>
378
379 <sect3>
380 <title>Build Commands</title>
381
382 <para>Install <application>XFree86</application> by running the
383 following commands:</para>
384
385<screen><userinput>patch -Np1 -i ../XFree86-&xfree86-version;-kernel_headers-1.patch &amp;&amp;
386sed -i -e "s@^#include &lt;linux/config.h&gt;@/* &amp; */@" \
387 `grep -lr linux/config.h *` &amp;&amp;
388( make WORLDOPTS="" World 2&gt;&amp;1 | \
389 tee xfree-compile.log &amp;&amp; exit $PIPESTATUS )</userinput></screen>
390
391 <para>Now, as the <systemitem class="username">root</systemitem>
392 user:</para>
393
394<screen role="root"><userinput>make install &amp;&amp;
395make install.man &amp;&amp;
396ln -v -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
397ln -v -sf ../X11R6/lib/X11 /usr/lib/X11 &amp;&amp;
398ln -v -sf ../X11R6/include/X11 /usr/include/X11</userinput></screen>
399
400 <para>The <application>XFree86</application> fonts have been installed
401 outside of <application>Fontconfig</application>'s default search path
402 of <filename class="directory">/usr/share/fonts</filename>. In order
403 for <application>Fontconfig</application> to find the installed TrueType
404 fonts, you should make symlinks to their directories. Assuming you've
405 installed <application>XFree86</application> in the default prefix, run the
406 following commands as the <systemitem class="username">root</systemitem>
407 user:</para>
408
409<screen role="root"><userinput>install -d -m755 /usr/share/fonts &amp;&amp;
410ln -svn /usr/X11R6/lib/X11/fonts/OTF /usr/share/fonts/X11-OTF &amp;&amp;
411ln -svn /usr/X11R6/lib/X11/fonts/TTF /usr/share/fonts/X11-TTF</userinput></screen>
412
413 <para><application>XFree86</application> installs the
414 <application>XRender</application> and
415 <application>XExtensions</application> extension libraries but does not
416 install the corresponding <application>pkg-config</application> files.
417 Create the files by issuing the following commands as the
418 <systemitem class="username">root</systemitem> user:</para>
419
420<screen role="root"><userinput>cat &gt; /usr/X11R6/lib/pkgconfig/xrender.pc &lt;&lt; "EOF"
421<literal>prefix=/usr/X11R6
422exec_prefix=${prefix}
423libdir=${exec_prefix}/lib
424includedir=${prefix}/include
425
426Name: Xrender
427Description: X Render Library
428Version: 0.8.3
429Cflags: -I${includedir} -I/usr/X11R6/include
430Libs: -L${libdir} -lXrender -L/usr/X11R6/lib -lX11</literal>
431
432EOF
433
434cat &gt; /usr/X11R6/lib/pkgconfig/xextensions.pc &lt;&lt; "EOF"
435<literal>prefix=/usr/X11R6
436exec_prefix=${prefix}
437libdir=${exec_prefix}/lib
438includedir=${prefix}/include
439
440Name: XExtensions
441Description: Sundry X extension headers
442Version: 1.0.1
443Cflags: -I${includedir}</literal>
444
445EOF</userinput></screen>
446
447 </sect3>
448
449 </sect2>
450
451 <sect2 role="commands">
452 <title>Command Explanations</title>
453
454 <para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>:
455 The <application>Linux-Libc-Headers</application> package installed in
456 LFS installs a <filename>/usr/include/linux/config.h</filename> file which
457 is not compatible with userspace applications. The recommended fix for
458 applications including this file is to remove it (see <ulink
459 url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
460 linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
461 <command>grep -lr</command> to replace all occurrences. If you desire, just
462 remove (comment) the line in the appropriate video driver file if you
463 customized <filename>host.def</filename>.</para>
464
465 <para><command>( make WORLDOPTS="" World 2&gt;&amp;1 | tee xfree-compile.log
466 &amp;&amp; exit $PIPESTATUS )</command>:
467 This command runs multiple <filename>Makefile</filename>s to completely
468 rebuild the system. <envar>WORLDOPTS</envar>="" disables the default setting
469 to continue after encountering an error. <option>2&gt;&amp;1</option>
470 redirects error messages to the same location as standard output. The
471 <command>tee</command> command allows viewing of the output while logging
472 the results to a file. The parentheses around the command runs the entire
473 command in a subshell and finally the <command>exit $PIPESTATUS</command>
474 ensures the result of the <command>make</command> is returned as the result
475 and not the result of the <command>tee</command> command.</para>
476
477 <note>
478 <para>When rebuilding <application>XFree86</application>, a separate
479 command that may be used if only minor changes are made to the sources
480 is <command>make Everything</command>. This does not automatically
481 remove generated files and only rebuilds those files or programs that
482 are out of date.</para>
483 </note>
484
485 <para><command>ln -v -sf ...</command>: These commands are present to
486 enable other (broken) packages to build against
487 <application>XFree86</application>, even though the Filesystem Hierarchy
488 Standard says: <quote>In general, software must not be installed or managed
489 via the above symbolic links. They are intended for utilization by
490 users only.</quote></para>
491
492 </sect2>
493
494 <sect2 role="configuration" id="xfree86-config">
495 <title>Configuring XFree86</title>
496
497 <para>As the <systemitem class="username">root</systemitem> user: Edit
498 <filename>/etc/ld.so.conf</filename> and add
499 <filename class="directory">/usr/X11R6/lib</filename>, then run:</para>
500
501<screen role="root"><userinput>ldconfig</userinput></screen>
502
503 <indexterm zone="xfree86 xfree86-config">
504 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
505 </indexterm>
506
507 <para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
508 and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
509 are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
510 environment variables, respectively. Instructions for doing this are
511 described in the section <xref linkend='postlfs-config-profile'/>.</para>
512
513 <indexterm zone="xfree86 xfree86-config">
514 <primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
515 </indexterm>
516
517 <para>Create the <filename>XF86Config</filename> file with:</para>
518
519<screen><userinput>cd ~ &amp;&amp;
520XFree86 -configure</userinput></screen>
521
522 <para>The screen will go black and you may hear some clicking of the monitor.
523 This command will create a file, <filename>XF86Config.new</filename> in your
524 home directory.</para>
525
526 <para>Edit <filename>XF86Config.new</filename> to suit your system.
527 The details of the file are located in the man page <command>man
528 XF86Config</command>. Some things you may want to do are:</para>
529
530 <itemizedlist>
531 <listitem>
532 <para>Section "Files". Change the order of the font paths searched.
533 You may want to put 100dpi fonts ahead of 75dpi fonts if your system
534 normally comes up closer to 100 dots per inch. You may want to remove
535 some font directories completely.</para>
536 </listitem>
537 <listitem>
538 <para>Section "Module". If you are going to install NVidia
539 drivers, remove the "dri" line.</para>
540 </listitem>
541 <listitem>
542 <para>Sections "InputDevice". You may want to change the
543 keyboard autorepeat rate by adding
544 <option>Option "Autorepeat" "250 30"</option>.</para>
545 </listitem>
546 <listitem>
547 <para>Section "Monitor". Specify the <option>VertRefresh</option>
548 and <option>HorizSync</option> values if the system does not
549 automatically detect the monitor and its values.</para>
550 </listitem>
551 <listitem>
552 <para>Section "Device". You may want to set some of the options
553 available for your selected video driver. A description of the
554 driver parameters is in the man page for your driver.</para>
555 </listitem>
556 <listitem>
557 <para>Section "Screen". Add a DefaultDepth statement such as:
558 <option>DefaultDepth 24</option>. In the SubSection for your
559 default depth, add a modes line such as:
560 <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The
561 first mode listed will normally be the starting resolution.</para>
562 </listitem>
563 </itemizedlist>
564
565 <para>Test the system with:</para>
566
567<screen><userinput>XFree86 -xf86config ~/XF86Config.new</userinput></screen>
568
569 <para>You will only get a gray background with an X-shaped mouse cursor,
570 but it confirms the system is working. Exit with
571 <keycap>Control+Alt+Backspace</keycap>. If the system does not work,
572 examine <filename>/var/log/XFree86.0.log</filename> to see what went
573 wrong.</para>
574
575 <para>As the <systemitem class="username">root</systemitem> user:
576 move the configuration file to its final location:</para>
577
578<screen role="root"><userinput>mv ~/XF86Config.new /etc/X11/XF86Config</userinput></screen>
579
580 <para>Create <filename>.xinitrc</filename>:</para>
581
582<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
583<literal># Begin .xinitrc file
584xterm -g 80x40+0+0 &amp;
585xclock -g 100x100-0+0 &amp;
586twm</literal>
587EOF</userinput></screen>
588
589 <para>This provides an initial screen with an xterm and a clock that is
590 managed by a simple window manager, Tab Window Manager. For details of
591 <command>twm</command>, see the man page.</para>
592
593 <indexterm zone="xfree86 xfree86-config">
594 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
595 </indexterm>
596
597 <note>
598 <para>When needed, <application>XFree86</application> creates the
599 directory <filename>/tmp/.ICE-unix</filename> if it does not exist.
600 If this directory is not owned by <systemitem
601 class="username">root</systemitem>, <application>XFree86</application>
602 delays startup by a few seconds and also appends a warning to the
603 logfile. This also affects startup of other applications. To improve
604 performance, it is advisable to manually create the directory before
605 <application>XFree86</application> uses it. Add the file creation to
606 <filename>/etc/sysconfig/createfiles</filename> that is sourced by
607 the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
608
609<screen role="root"><userinput>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
610<literal>/tmp/.ICE-unix dir 1777 root root</literal>
611EOF</userinput></screen>
612
613 </note>
614
615 <indexterm zone="xfree86 xfree86-config">
616 <primary
617 sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
618 </indexterm>
619
620 <para>Start <application>X</application> with:</para>
621
622<screen><userinput>startx</userinput></screen>
623
624 <para>to get a basic functional <application>X Window
625 System</application>.</para>
626
627 <para>At this point, you should check out <xref linkend='x-setup'/>
628 for the necessary configuration to make <application>X</application>
629 fully functional. Additionally, you can have a look at <xref
630 linkend='x-config'/> for information on fine tuning your
631 <application>X</application> configuration.</para>
632
633 </sect2>
634
635 <sect2 id="xfree86-contents" role="content"
636 xreflabel="XFree86 Contents and Descriptions">
637 <title>Contents</title>
638
639 <para>The <application>XFree86</application> package contains the
640 <application>X Window System</application> for Linux (and other operating
641 systems). It includes the <application>X</application> server, fonts,
642 <command>xterm</command>, a simple window manager (<command>twm</command>),
643 various utilities, video output drivers, and various input drivers
644 including the mouse and keyboard.</para>
645
646 <para><application>XFree86</application> also contains libraries and header
647 files for development of the <application>X Window System</application>
648 programs.</para>
649
650 <note>
651 <para>The following lists are not comprehensive. The full list of
652 programs is in <filename class="directory">/usr/X11R6/bin</filename>.
653 For additional information about these programs, see the respective
654 man page.</para>
655 </note>
656
657 <segmentedlist>
658 <segtitle>Installed Programs</segtitle>
659 <segtitle>Installed Libraries</segtitle>
660 <segtitle>Installed Directories</segtitle>
661
662 <seglistitem>
663 <seg>XFree86, xf86config, xf86cfg, startx, xinit, twm, xterm,
664 xwininfo, x11perf, xlsfonts, xvidtune, xload, xcalc, xclock,
665 oclock, and xmodmap</seg>
666 <seg>libGL.so, libGLU.so, libSM.so, libXi.so, libXrender.so,
667 libXt.so, and libXfont.so</seg>
668 <seg>/usr/X11R6/ and /etc/X11/</seg>
669 </seglistitem>
670 </segmentedlist>
671
672 <variablelist>
673 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
674 <?dbfo list-presentation="list"?>
675 <?dbhtml list-presentation="table"?>
676
677 <varlistentry id="XFree86">
678 <term><command>XFree86</command></term>
679 <listitem>
680 <para>is the X11R6 implementation of the <application>X Window
681 System</application> server.</para>
682 <indexterm zone="xfree86 XFree86">
683 <primary sortas="b-XFree86">XFree86</primary>
684 </indexterm>
685 </listitem>
686 </varlistentry>
687
688 <varlistentry id="xf86config">
689 <term><command>xf86config</command></term>
690 <listitem>
691 <para>is an interactive program for generating an
692 <filename>XF86Config</filename> file for use with
693 <application>XFree86</application> <application>X</application>
694 servers.</para>
695 <indexterm zone="xfree86 xf86config">
696 <primary sortas="b-xf86config">xf86config</primary>
697 </indexterm>
698 </listitem>
699 </varlistentry>
700
701 <varlistentry id="xf86cfg">
702 <term><command>xf86cfg</command></term>
703 <listitem>
704 <para>is a tool to configure <application>XFree86</application>
705 that can be used to either write the initial configuration file
706 or make customizations to the current configuration.</para>
707 <indexterm zone="xfree86 xf86cfg">
708 <primary sortas="b-xf86cfg">xf86cfg</primary>
709 </indexterm>
710 </listitem>
711 </varlistentry>
712
713 <varlistentry id="startx">
714 <term><command>startx</command></term>
715 <listitem>
716 <para>is a script to initialize the <application>X</application>
717 session. It runs <command>xinit</command>.</para>
718 <indexterm zone="xfree86 startx">
719 <primary sortas="b-startx">startx</primary>
720 </indexterm>
721 </listitem>
722 </varlistentry>
723
724 <varlistentry id="xinit">
725 <term><command>xinit</command></term>
726 <listitem>
727 <para>is used to start the <application>X Window
728 System</application> server.</para>
729 <indexterm zone="xfree86 xinit">
730 <primary sortas="b-xinit">xinit</primary>
731 </indexterm>
732 </listitem>
733 </varlistentry>
734
735 <varlistentry id="twm">
736 <term><command>twm</command></term>
737 <listitem>
738 <para>(Tab Window Manager) is a window manager included with the
739 <application>X Window System</application>.</para>
740 <indexterm zone="xfree86 twm">
741 <primary sortas="b-twm">twm</primary>
742 </indexterm>
743 </listitem>
744 </varlistentry>
745
746 <varlistentry id="xterm">
747 <term><command>xterm</command></term>
748 <listitem>
749 <para>is a terminal emulator for <application>X</application>.</para>
750 <indexterm zone="xfree86 xterm">
751 <primary sortas="b-xterm">xterm</primary>
752 </indexterm>
753 </listitem>
754 </varlistentry>
755
756 <varlistentry id="xwininfo">
757 <term><command>xwininfo</command></term>
758 <listitem>
759 <para>is a window information utility for
760 <application>X</application>.</para>
761 <indexterm zone="xfree86 xwininfo">
762 <primary sortas="b-xwininfo">xwininfo</primary>
763 </indexterm>
764 </listitem>
765 </varlistentry>
766
767 <varlistentry id="x11perf">
768 <term><command>x11perf</command></term>
769 <listitem>
770 <para>is an <application>X</application>11 server performance
771 test program.</para>
772 <indexterm zone="xfree86 x11perf">
773 <primary sortas="b-x11perf">x11perf</primary>
774 </indexterm>
775 </listitem>
776 </varlistentry>
777
778 <varlistentry id="xlsfonts">
779 <term><command>xlsfonts</command></term>
780 <listitem>
781 <para>is a program to list fonts available to the
782 <application>X</application> server.</para>
783 <indexterm zone="xfree86 xlsfonts">
784 <primary sortas="b-xlsfonts">xlsfonts</primary>
785 </indexterm>
786 </listitem>
787 </varlistentry>
788
789 <varlistentry id="xvidtune">
790 <term><command>xvidtune</command></term>
791 <listitem>
792 <para>is a video mode tuner for
793 <application>XFree86</application>.</para>
794 <indexterm zone="xfree86 xvidtune">
795 <primary sortas="b-xvidtune">xvidtune</primary>
796 </indexterm>
797 </listitem>
798 </varlistentry>
799
800 <varlistentry id="xload">
801 <term><command>xload</command></term>
802 <listitem>
803 <para> is a system load average display for
804 <application>X</application>.</para>
805 <indexterm zone="xfree86 xload">
806 <primary sortas="b-xload">xload</primary>
807 </indexterm>
808 </listitem>
809 </varlistentry>
810
811 <varlistentry id="xcalc">
812 <term><command>xcalc</command></term>
813 <listitem>
814 <para>is a scientific calculator for
815 <application>X</application>.</para>
816 <indexterm zone="xfree86 xcalc">
817 <primary sortas="b-xcalc">xcalc</primary>
818 </indexterm>
819 </listitem>
820 </varlistentry>
821
822 <varlistentry id="xclock">
823 <term><command>xclock</command></term>
824 <listitem>
825 <para>is a clock programs for <application>X</application>.</para>
826 <indexterm zone="xfree86 xclock">
827 <primary sortas="b-xclock">xclock</primary>
828 </indexterm>
829 </listitem>
830 </varlistentry>
831
832 <varlistentry id="oclock">
833 <term><command>oclock</command></term>
834 <listitem>
835 <para>is a clock programs for <application>X</application>.</para>
836 <indexterm zone="xfree86 oclock">
837 <primary sortas="b-oclock">oclock</primary>
838 </indexterm>
839 </listitem>
840 </varlistentry>
841
842 <varlistentry id="xmodmap">
843 <term><command>xmodmap</command></term>
844 <listitem>
845 <para>is a utility for modifying keymaps and pointer button
846 mappings in <application>X</application>.</para>
847 <indexterm zone="xfree86 xmodmap">
848 <primary sortas="b-xmodmap">xmodmap</primary>
849 </indexterm>
850 </listitem>
851 </varlistentry>
852
853 </variablelist>
854
855 </sect2>
856
857</sect1>
Note: See TracBrowser for help on using the repository browser.