Author: manuel
Date: 2005-05-19 13:16:56 -0600 (Thu, 19 May 2005)
New Revision: 4370
Modified:
trunk/BOOK/x/installing/xorg.xml
Log:
Tagged xorg.xml
Modified: trunk/BOOK/x/installing/xorg.xml
===================================================================
--- trunk/BOOK/x/installing/xorg.xml 2005-05-19 18:32:05 UTC (rev 4369)
+++ trunk/BOOK/x/installing/xorg.xml 2005-05-19 19:16:56 UTC (rev 4370)
@@ -13,229 +13,247 @@
]>
<sect1 id="xorg" xreflabel="X.org-&xorg-version;">
-<sect1info>
- <othername>$LastChangedBy$</othername>
- <date>$Date$</date>
-</sect1info>
+ <?dbhtml filename="xorg.html"?>
-<?dbhtml filename="xorg.html"?>
-<title>Xorg-&xorg-version;</title>
+ <sect1info>
+ <othername>$LastChangedBy$</othername>
+ <date>$Date$</date>
+ </sect1info>
-<indexterm zone="xorg">
- <primary sortas="a-xorg">Xorg</primary>
-</indexterm>
+ <title>Xorg-&xorg-version;</title>
-<sect2>
-<title>Introduction to <application>Xorg</application></title>
+ <indexterm zone="xorg">
+ <primary sortas="a-xorg">Xorg</primary>
+ </indexterm>
-<note><para>There are two packages in <acronym>BLFS</acronym> that implement
-the <application>X</application> Window System:
<application>Xorg</application>
-and <application>XFree86</application>. These packages are quite similar. In
-fact, the base system of <application>Xorg</application> is
-<application>XFree86</application>-4.4.0RC2. The primary difference as of this
-writing is the license provisions of the packages. For someone building a
-package for their own use, these issues are not significant. Most large
-commercial distributions have decided to use the
-<application>Xorg</application> package, but several still use
-<application>XFree86</application>.</para>
+ <sect2 role="package">
+ <title>Introduction to Xorg</title>
-<para>A second reason for the forking of <application>X</application> packages
-is the stated goals of the developers. Some developers were unhappy with the
-administration and progress of <application>XFree86</application>. X.org's
-future plans include significant improvements to the internals of the system
-and more frequent releases.</para>
+ <note>
+ <para>There are two packages in BLFS that implement the <application>X
+ Window System</application>: <application>Xorg</application> and
+ <application>XFree86</application>. These packages are quite similar.
+ In fact, the base system of <application>Xorg</application> is
+ <application>XFree86</application>-4.4.0RC2. The primary difference as
+ of this writing is the license provisions of the packages. For someone
+ building a package for their own use, these issues are not significant.
+ Most large commercial distributions have decided to use the
+ <application>Xorg</application> package, but several still use
+ <application>XFree86</application>.</para>
-<para><application>XFree86</application> continues to be a solid, conservative
-application with excellent driver support.</para>
+ <para>A second reason for the forking of <application>X</application>
+ packages is the stated goals of the developers. Some developers were
+ unhappy with the administration and progress of
+ <application>XFree86</application>. X.org's future plans include
+ significant improvements to the internals of the system and more frequent
+ releases.</para>
-<para>Both <application>Xorg</application> and
-<application>XFree86</application> can be installed in the same way, but this
-section will provide a slightly different and more current variation for
-installation.</para>
-</note>
+ <para><application>XFree86</application> continues to be a solid,
+ conservative application with excellent driver support.</para>
-<para><application>Xorg</application> is a freely redistributable open-source
-implementation of the <application>X</application> Window System. This
-application provides a client/server interface between display hardware (the
-mouse, keyboard, and video displays) and the desktop environment, while also
-providing both the windowing infrastructure and a standardized application
-interface (<acronym>API</acronym>).</para>
-
-<sect3><title>Package information</title>
- <itemizedlist spacing='compact'>
- <listitem><para>Download (HTTP): <ulink
url="&xorg-download-http;"/></para></listitem>
- <listitem><para>Download (FTP): <ulink
url="&xorg-download-ftp;"/></para></listitem>
- <listitem><para>Download MD5 sum: &xorg-md5sum;</para></listitem>
- <listitem><para>Download size: &xorg-size;</para></listitem>
- <listitem><para>Estimated disk space required:
&xorg-buildsize;</para></listitem>
- <listitem><para>Estimated build time: &xorg-time;</para></listitem>
- </itemizedlist>
-</sect3>
-
-<sect3>
- <title><application>Xorg</application> Dependencies</title>
-
-<sect4>
- <title>Required</title>
- <para><xref linkend="libpng"/> and
- <xref linkend="fontconfig"/></para>
-</sect4>
+ <para>Both <application>Xorg</application> and
+ <application>XFree86</application> can be installed in the same way,
+ but this section will provide a slightly different and more current
+ variation for installation.</para>
+ </note>
-<sect4>
- <title>Optional</title>
- <para><xref linkend="Linux_PAM"/></para>
-</sect4>
+ <para><application>Xorg</application> is a freely redistributable
open-source
+ implementation of the <application>X</application> Window System. This
+ application provides a client/server interface between display hardware
(the
+ mouse, keyboard, and video displays) and the desktop environment, while
also
+ providing both the windowing infrastructure and a standardized application
+ interface (API).</para>
-</sect3>
-
-<sect3><title>Download Instructions</title>
-
-<para>As an alternative to downloading the entire source tree in a single
-file, there are several files that need to be fetched from the download
-location (directory /pub/x.org/pub/X11R&xorg-version;/src/):</para>
+ <bridgehead renderas="sect3">Package Information</bridgehead>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Download (HTTP): <ulink url="&xorg-download-http;"/></para>
+ </listitem>
+ <listitem>
+ <para>Download (FTP): <ulink url="&xorg-download-ftp;"/></para>
+ </listitem>
+ <listitem>
+ <para>Download MD5 sum: &xorg-md5sum;</para>
+ </listitem>
+ <listitem>
+ <para>Download size: &xorg-size;</para>
+ </listitem>
+ <listitem>
+ <para>Estimated disk space required: &xorg-buildsize;</para>
+ </listitem>
+ <listitem>
+ <para>Estimated build time: &xorg-time;</para>
+ </listitem>
+ </itemizedlist>
-<itemizedlist spacing='compact'>
-
<listitem><para><filename>X11R&xorg-version;-src1.tar.gz</filename></para></listitem>
-
<listitem><para><filename>X11R&xorg-version;-src2.tar.gz</filename></para></listitem>
-
<listitem><para><filename>X11R&xorg-version;-src3.tar.gz</filename></para></listitem>
-
<listitem><para><filename>X11R&xorg-version;-src4.tar.gz</filename></para></listitem>
-
<listitem><para><filename>X11R&xorg-version;-src5.tar.gz</filename></para></listitem>
-
<listitem><para><filename>X11R&xorg-version;-src6.tar.gz</filename></para></listitem>
-
<listitem><para><filename>X11R&xorg-version;-src7.tar.gz</filename></para></listitem>
-</itemizedlist>
+ <bridgehead renderas="sect3">TEMPLATE Dependencies</bridgehead>
-<para>The first package contains the <application>Xorg</application> libraries
-and support programs, the second contains standard
<application>X</application>
-programs, the third contains the <application>X</application> server, the
-fourth and fifth are fonts, the sixth is normal documentation, and the seventh
-is hardcopy documentation.</para>
-
-<para>To check your file for integrity, download the
-<filename>md5sums</filename> file. Then:</para>
-
-<screen><userinput><command>md5sum -c md5sums</command></userinput></screen>
-
-<para>The package (or all seven packages) should give an OK status.</para>
-</sect3>
-</sect2>
+ <bridgehead renderas="sect4">Required</bridgehead>
+ <para><xref linkend="libpng"/> and
+ <xref linkend="fontconfig"/></para>
-<sect2>
- <title>Installation of <application>Xorg</application></title>
+ <bridgehead renderas="sect4">Optional</bridgehead>
+ <para><xref linkend="Linux_PAM"/></para>
-<sect3 id='xorg-kernel'>
- <title>Kernel Compilation Settings</title>
+ <bridgehead renderas="sect3">Download Instructions</bridgehead>
- <indexterm zone="xorg xorg-kernel">
- <primary sortas="d-Xorg">Xorg</primary></indexterm>
+ <para>As an alternative to downloading the entire source tree in a single
+ file, there are several files that need to be fetched from the download
+ location (directory /pub/x.org/pub/X11R&xorg-version;/src/):</para>
- <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
- recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
- Registers) support into the kernel. The kernel can map Cyrix and AMD
- <acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so
selecting
- this option is useful for those processors also. This option is found in
the
- "Processor type and features" menu. It can increase performance of
- image write operations 2.5 times or more on <acronym>PCI</acronym> or
- <acronym>AGP</acronym> video cards.
- </para>
-
- <para>In the "Character Devices" section, enable <acronym>AGP</acronym>
Support
- and select the chipset support on your motherboard. If you do not know the
- chipset, you may select all the chip types at the expense of extra kernel
size.
+ <itemizedlist spacing='compact'>
+ <listitem>
+ <para><filename>X11R&xorg-version;-src1.tar.gz</filename></para>
+ </listitem>
+ <listitem>
+ <para><filename>X11R&xorg-version;-src2.tar.gz</filename></para>
+ </listitem>
+ <listitem>
+ <para><filename>X11R&xorg-version;-src3.tar.gz</filename></para>
+ </listitem>
+ <listitem>
+ <para><filename>X11R&xorg-version;-src4.tar.gz</filename></para>
+ </listitem>
+ <listitem>
+ <para><filename>X11R&xorg-version;-src5.tar.gz</filename></para>
+ </listitem>
+ <listitem>
+ <para><filename>X11R&xorg-version;-src6.tar.gz</filename></para>
+ </listitem>
+ <listitem>
+ <para><filename>X11R&xorg-version;-src7.tar.gz</filename></para>
+ </listitem>
+ </itemizedlist>
+
+ <para>The first package contains the <application>Xorg</application>
+ libraries and support programs, the second contains standard
+ <application>X</application> programs, the third contains the
+ <application>X</application> server, the fourth and fifth are fonts,
+ the sixth is normal documentation, and the seventh is hardcopy
+ documentation.</para>
+
+ <para>To check your file for integrity, download the
+ <filename>md5sums</filename> file. Then:</para>
+
+<screen><userinput>md5sum -c md5sums</userinput></screen>
+
+ <para>The package (or all seven packages) should give an OK status.</para>
+
+ </sect2>
+
+ <sect2 role="kernel" id='xorg-kernel'>
+ <title>Kernel Configuration</title>
+
+ <indexterm zone="xorg xorg-kernel">
+ <primary sortas="d-Xorg">Xorg</primary>
+ </indexterm>
+
+ <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
+ recommended that you compile MTRR (Memory Type Range Registers) support
+ into the kernel. The kernel can map Cyrix and AMD CPUs to the MTRR
+ interface, so selecting this option is useful for those processors also.
+ This option is found in the "Processor type and features" menu. It can
+ increase performance of image write operations 2.5 times or more on PCI or
+ AGP video cards.</para>
+
+ <para>In the "Character Devices" section, enable AGP Support and select
+ the chipset support on your motherboard. If you do not know the chipset,
+ you may select all the chip types at the expense of extra kernel size.
You can usually determine your motherboard's chipset by running the command
- <command>lspci</command>, a program from the <xref linkend="pciutils"/>
- package.
- </para>
-
- <para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
- Rendering Manager unless you have a Direct Rendering Infrastructure
- (<acronym>DRI</acronym>) supported video card. A complete list of
- <acronym>DRI</acronym> supported video cards can be found at
- <ulink url="http://dri.sourceforge.net"; /> in the "Status" section.
- Currently, supported cards include those from 3dfx (Voodoo, Banshee),
3Dlabs,
- ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and
- Matrox (G200, G400, G450).
- </para>
-
- <para>Additionally NVidia provides their own closed source binary drivers,
- which do not make use of <acronym>DRI</acronym>. If you intend to use
these
- drivers, do not enable <acronym>DRI</acronym>.
- </para>
-
- <para>If you made any changes to the kernel configuration, recompile and
- install the new kernel.
- </para>
-
-</sect3>
+ <command>lspci</command>, a program from the <xref linkend="pciutils"/>
+ package.</para>
-<sect3>
- <title>Suppressing Xprint-related modification to <filename
class="directory">/etc</filename></title>
+ <para>In the "Character Devices" section, <emphasis>disable</emphasis>
+ Direct Rendering Manager unless you have a Direct Rendering Infrastructure
+ (DRI) supported video card. A complete list of DRI supported video cards
+ can be found at <ulink url="http://dri.sourceforge.net"; /> in the "Status"
+ section. Currently, supported cards include those from 3dfx (Voodoo,
+ Banshee), 3Dlabs, ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel
+ (i810, i815), and Matrox (G200, G400, G450).</para>
- <para><application>Xorg</application> insists on putting
- its boot and profile scripts into the <filename
- class="directory">/etc</filename> directory even if specifically told
- not to compile anything Xprint server or client related (see
- <filename>host.def</filename> below). The following command will
- suppress any such modifications:
- </para>
+ <para>Additionally NVidia provides their own closed source binary drivers,
+ which do not make use of DRI. If you intend to use these drivers, do not
+ enable DRI.</para>
-<screen><userinput><command>sed -i '/^SUBDIRS =/s/ etc$//'
programs/Xserver/Xprint/Imakefile</command></userinput></screen>
+ <para>If you made any changes to the kernel configuration, recompile and
+ install the new kernel.</para>
-</sect3>
+ </sect2>
-<sect3>
- <title>Setting Up a Shadow Directory</title>
+ <sect2 role="installation">
+ <title>Installation of Xorg</title>
- <para>When building <application>Xorg</application>, you should create a
shadow
- directory of symbolic links for the compiled code. To do that, first make
- <command>lndir</command>. Starting from the
- <filename class='directory'>xc</filename> directory:
- </para>
+ <sect3>
+ <title>Suppressing Xprint-related Modification to '/etc'</title>
-<screen><userinput><command>pushd config/util &&
-make -f Makefile.ini lndir</command></userinput></screen>
+ <para><application>Xorg</application> insists on putting
+ its boot and profile scripts into the <filename
+ class="directory">/etc</filename> directory even if specifically told
+ not to compile anything Xprint server or client related (see
+ <filename>host.def</filename> below). The following command will
+ suppress any such modifications:</para>
-<para>Now, as the root user:</para>
-
-<screen><userinput role='root'><command>cp lndir
/usr/bin/</command></userinput></screen>
+<screen><userinput>sed -i '/^SUBDIRS =/s/ etc$//'
programs/Xserver/Xprint/Imakefile</userinput></screen>
-<para>And back as a regular user:</para>
-<screen><userinput><command>popd</command></userinput></screen>
+ </sect3>
-<para>Now create the shadow tree:</para>
+ <sect3>
+ <title>Setting Up a Shadow Directory</title>
-<screen><userinput><command>mkdir ../xcbuild &&
+ <para>When building <application>Xorg</application>, you should create
+ a shadow directory of symbolic links for the compiled code. To do that,
+ first make <command>lndir</command>. Starting from the
+ <filename class='directory'>xc</filename> directory:</para>
+
+<screen><userinput>pushd config/util &&
+make -f Makefile.ini lndir</userinput></screen>
+
+ <para>Now, as the <systemitem class="username">root</systemitem>
+ user:</para>
+
+<screen role="root"><userinput>cp -v lndir /usr/bin/</userinput></screen>
+
+ <para>And back as a regular user:</para>
+
+<screen><userinput>popd</userinput></screen>
+
+ <para>Now create the shadow tree:</para>
+
+<screen><userinput>mkdir ../xcbuild &&
cd ../xcbuild &&
-lndir ../xc</command></userinput></screen>
-</sect3>
+lndir ../xc</userinput></screen>
-<sect3>
- <title>Creating <filename>host.def</filename></title>
+ </sect3>
- <para>The next step is to create the <filename>config/cf/host.def</filename>
- file. The documentation for <application>Xorg</application> indicates that
the
- application will build without a <filename>host.def</filename> file, but
- the included libraries for <application>Fontconfig</application> and
- <application>FreeType2</application> do not build properly on a base
- <acronym>LFS</acronym> system. Therefore, you must specify that these
- libraries, as well as others, should be imported from the system.
- </para>
+ <sect3>
+ <title>Creating 'host.def'</title>
- <note><para><filename>config/cf/host.def</filename> is a C file, not a shell
- script. Ensure the comments delimited by <userinput>/*</userinput> ...
- <userinput>*/</userinput> are balanced when modifying the file.</para>
- </note>
+ <para>The next step is to create the
+ <filename>config/cf/host.def</filename> file. The documentation for
+ <application>Xorg</application> indicates that the application will
+ build without a <filename>host.def</filename> file, but the included
+ libraries for <application>Fontconfig</application> and
+ <application>FreeType2</application> do not build properly on a base
+ LFS system. Therefore, you must specify that these libraries, as well
+ as others, should be imported from the system.</para>
-<screen><userinput><command>cat > config/cf/host.def <<
"EOF"</command>
-/* Begin Xorg host.def file */
-
+ <note>
+ <para><filename>config/cf/host.def</filename> is a C file, not a
+ shell script. Ensure the comments delimited by /* ... */ are balanced
+ when modifying the file.</para>
+ </note>
+
+<screen><userinput>cat > config/cf/host.def << "EOF"
+<literal>/* Begin Xorg host.def file */
+
/* System Related Information. If you read and configure only one
- * section then it should be this one. The Intel architecture defaults
- * are set for a i686 and higher. Axp is for the Alpha architecture
- * and Ppc is for the Power PC. AMD64 is for the Opteron processor.
- * Note that there have been reports that the Ppc optimization line
- * causes segmentation faults during build. If that happens, try
+ * section then it should be this one. The Intel architecture defaults
+ * are set for a i686 and higher. Axp is for the Alpha architecture
+ * and Ppc is for the Power PC. AMD64 is for the Opteron processor.
+ * Note that there have been reports that the Ppc optimization line
+ * causes segmentation faults during build. If that happens, try
* building without the DefaultGcc2PpcOpt line. ***********/
-
+
/* #define DefaultGcc2i386Opt -O2 -fno-strength-reduce \
-fno-strict-aliasing -march=i686 */
/* #define DefaultGccAMD64Opt -O2 -fno-strength-reduce \
@@ -250,8 +268,8 @@
#define HasZlib YES
/*
- * Which drivers to build. When building a static server, each of
- * these will be included in it. When building the loadable server
+ * Which drivers to build. When building a static server, each of
+ * these will be included in it. When building the loadable server
* each of these modules will be built.
*
#define XF86CardDrivers mga glint nv tga s3virge sis rendition \
@@ -284,201 +302,219 @@
#define XprtServer NO
#define BuildXprintClients NO
-/* End Xorg host.def file */
-<command>EOF</command></userinput></screen>
+/* End Xorg host.def file */</literal>
+EOF</userinput></screen>
- <para>There are several other options that you may want to consider. A well
- documented example file is <filename>config/cf/xorgsite.def</filename>.
- </para>
+ <para>There are several other options that you may want to consider.
+ A well documented example file is
+ <filename>config/cf/xorgsite.def</filename>.</para>
-</sect3>
+ </sect3>
-<sect3>
- <title>Build Commands</title>
+ <sect3>
+ <title>Build Commands</title>
- <para>Install <application>Xorg</application> by running the following
commands:</para>
-
-<screen><userinput><command>sed -i -e "[EMAIL PROTECTED]
<linux/config.h>@/* & */@" \
+ <para>Install <application>Xorg</application> by running the
+ following commands:</para>
+
+<screen><userinput>sed -i -e "[EMAIL PROTECTED] <linux/config.h>@/*
& */@" \
`grep -lr linux/config.h *` &&
-( make World 2>&1 | tee xorg-compile.log && exit $PIPESTATUS
)</command></userinput></screen>
+( make World 2>&1 | tee xorg-compile.log && exit $PIPESTATUS
)</userinput></screen>
-<para>Again as the root user:</para>
-
-<screen><userinput role='root'><command>make install &&
+ <para>Again as the <systemitem class="username">root</systemitem>
+ user:</para>
+
+<screen role="root"><userinput>make install &&
make install.man &&
-ln -sf ../X11R6/bin /usr/bin/X11 &&
-ln -sf ../X11R6/lib/X11 /usr/lib/X11 &&
-ln -sf ../X11R6/include/X11 /usr/include/X11</command></userinput></screen>
-
-</sect3>
-</sect2>
+ln -v -sf ../X11R6/bin /usr/bin/X11 &&
+ln -v -sf ../X11R6/lib/X11 /usr/lib/X11 &&
+ln -v -sf ../X11R6/include/X11 /usr/include/X11</userinput></screen>
-<sect2>
-<title>Command explanations</title>
-
- <para><command>sed -i -e "[EMAIL PROTECTED]
<linux/config.h>@...</command>:
+ </sect3>
+
+ </sect2>
+
+ <sect2 role="commands">
+ <title>Command Explanations</title>
+
+ <para><command>sed -i -e "[EMAIL PROTECTED]
<linux/config.h>@...</command>:
The <application>Linux-Libc-Headers</application> package installed in
- <acronym>LFS</acronym> installs a
- <filename>/usr/include/linux/config.h</filename> file which is not
compatible
- with userspace applications. The recommended fix for applications including
- this file is to remove it (see <ulink
+ LFS installs a <filename>/usr/include/linux/config.h</filename> file
+ which is not compatible with userspace applications. The recommended fix
+ for applications including this file is to remove it (see <ulink
url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ";>
linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
<command>grep -lr</command> to replace all occurences. If you desire, just
remove (comment) the line in the appropriate video driver file if you
- customized <filename>host.def</filename>.
-</para>
+ customized <filename>host.def</filename>.</para>
- <para><command>( make World 2>&1 | tee xorg-compile.log
- && exit $PIPESTATUS )</command>:
- This command runs multiple <filename>Makefile</filename>s to completely
rebuild
- the system. <parameter>2>&1</parameter> redirects error messages
- to the same location as standard output. The <command>tee</command> command
- allows viewing of the output while logging the results to a file. The
- parentheses around the command runs the entire comand in a subshell and
finally
- the <command>exit $PIPESTATUS</command> ensures the result of the
- <command>make</command> is returned as the result and not the result of
the
- <command>tee</command> command.
- </para>
-
- <note><para>When rebuilding <application>Xorg</application>, a separate
command
- that may be used if only minor changes are made to the sources is
- <command>make Everything</command>. This does not automatically remove
generated
- files and only rebuilds those files or programs that are out of
date.</para>
- </note>
-
-<para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11
-ln -sf ../X11R6/lib/X11 /usr/lib/X11
-ln -sf ../X11R6/include/X11 /usr/include/X11</command></screen>
-These commands are present to enable other (broken) packages to build against
-<application>Xorg</application>, even though the Filesystem Hierarchy Standard
-says: "In general, software must not be installed or managed via the above
-symbolic links. They are intended for utilization by users only."</para>
-
-</sect2>
+ <para><command>( make World 2>&1 | tee xorg-compile.log
+ && exit $PIPESTATUS )</command>: This command runs multiple
+ <filename>Makefile</filename>s to completely rebuild the system.
+ <parameter>2>&1</parameter> redirects error messages to the
+ same location as standard output. The <command>tee</command> command
+ allows viewing of the output while logging the results to a file. The
+ parentheses around the command runs the entire comand in a subshell
+ and finally the <command>exit $PIPESTATUS</command> ensures the result
+ of the <command>make</command> is returned as the result and not the
+ result of the <command>tee</command> command.</para>
-<sect2 id='xorg-config'>
-<title>Configuring Xorg</title>
+ <note>
+ <para>When rebuilding <application>Xorg</application>, a separate
+ command that may be used if only minor changes are made to the sources
+ is <command>make Everything</command>. This does not automatically
+ remove generated files and only rebuilds those files or programs that
+ are out of date.</para>
+ </note>
-<para>Edit <filename>/etc/ld.so.conf</filename> and add
- <filename class="directory">/usr/X11R6/lib</filename>. Run:
-</para>
+ <para><command>ln -v -sf ...</command>: These commands are present to
+ enable other (broken) packages to build against
+ <application>Xorg</application>, even though the Filesystem Hierarchy
+ Standard says: <quote>In general, software must not be installed or
+ managed via the above symbolic links. They are intended for utilization
+ by users only.</quote></para>
-<indexterm zone="xorg xorg-config">
- <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
-</indexterm>
-
-<screen><userinput><command>ldconfig</command></userinput></screen>
-
-<para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
-and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
-are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
-environment variables, respectively. Instructions for doing this are
-described in the section "<xref linkend='postlfs-config-profile'/>."</para>
-
-<para>Create the <filename>xorg.conf</filename> file with:
-<screen><userinput><command>cd ~
-Xorg -configure</command></userinput></screen>
-The screen will go black and you may hear some clicking of the monitor. This
-command will create a file, <filename>xorg.conf.new</filename> in your home
-directory.</para>
+ </sect2>
-<indexterm zone="xorg xorg-config">
- <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
-</indexterm>
-
-<para>Edit <filename>xorg.conf.new</filename> to suit your system. The
details
-of the file are located in the xorg.conf man page. Some
-things you may want to do are:</para>
-
-<itemizedlist>
+ <sect2 role="configuration" id='xorg-config'>
+ <title>Configuring Xorg</title>
-<listitem><para>Section "Files". Change the order of the font paths searched.
-You may want to put 100dpi fonts ahead of 75dpi fonts if your system normally
-comes up closer to 100 dots per inch. You may want to remove some font
-directories completely.</para></listitem>
+ <para>Edit <filename>/etc/ld.so.conf</filename> and add
+ <filename class="directory">/usr/X11R6/lib</filename>. Run:</para>
-<listitem><para>Section "Module". If you are going to install NVidia
-drivers, remove the "dri" line.</para></listitem>
-
-<listitem><para>Sections "InputDevice". You may want to change the
-keyboard autorepeat rate by adding
-<parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem>
-
-<listitem><para>Section "Monitor". Specify the
-<parameter>VertRefresh</parameter> and <parameter>HorizSync</parameter> values
-if the system does not automatically detect the monitor and its values.</para>
-</listitem>
-
-<listitem><para>Section "Device". You may want to set some of the options
-available for your selected video driver. A description of the driver
-parameters is in the man page for your driver.</para></listitem>
-
-<listitem><para>Section "Screen". Add a DefaultDepth statement such as:
-<parameter>DefaultDepth 24</parameter>. In the SubSection for your default
-depth, add a modes line such as:
-<parameter>Modes "1600x1200" "1280x1024" "1024x768"</parameter>. The first
mode listed
-will normally be the starting resolution.</para></listitem>
-
-</itemizedlist>
+ <indexterm zone="xorg xorg-config">
+ <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
+ </indexterm>
-<para>Test the system with:
-<screen><userinput><command>X -config
~/xorg.conf.new</command></userinput></screen>
-You will only get a gray background with an X-shaped mouse cursor, but it
-confirms the system is working. Exit with Control-Alt-Backspace. If the
-system does not work, take a look at <filename>/var/log/Xorg.0.log</filename>
-to see what went wrong.</para>
-
-<para>Move the configuration file to its final location:</para>
-<screen><userinput><command>mv ~/xorg.conf.new
/etc/X11/xorg.conf</command></userinput></screen>
-
-<para>Create <filename>.xinitrc</filename>:
-<screen><userinput><command>cat > ~/.xinitrc << "EOF"</command>
-# Begin .xinitrc file
+<screen role="root"><userinput>ldconfig</userinput></screen>
+
+ <para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
+ and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
+ are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
+ environment variables, respectively. Instructions for doing this are
+ described in the section <xref linkend='postlfs-config-profile'/>.</para>
+
+ <para>Create the <filename>xorg.conf</filename> file with:</para>
+
+<screen><userinput>cd ~r &&
+Xorg -configure</userinput></screen>
+
+ <para>The screen will go black and you may hear some clicking of the
monitor.
+ This command will create a file, <filename>xorg.conf.new</filename> in your
+ home directory.</para>
+
+ <indexterm zone="xorg xorg-config">
+ <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
+ </indexterm>
+
+ <para>Edit <filename>xorg.conf.new</filename> to suit your system. The
+ details of the file are located in the xorg.conf man page. Some things
+ you may want to do are:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Section "Files". Change the order of the font paths searched.
+ You may want to put 100dpi fonts ahead of 75dpi fonts if your system
+ normally comes up closer to 100 dots per inch. You may want to remove
+ some font directories completely.</para>
+ </listitem>
+ <listitem>
+ <para>Section "Module". If you are going to install NVidia
+ drivers, remove the "dri" line.</para>
+ </listitem>
+ <listitem>
+ <para>Sections "InputDevice". You may want to change the
+ keyboard autorepeat rate by adding
+ <option>Option "Autorepeat" "250 30"</option>.</para>
+ </listitem>
+ <listitem>
+ <para>Section "Monitor". Specify the <option>VertRefresh</option>
+ and <option>HorizSync</option> values if the system does not
+ automatically detect the monitor and its values.</para>
+ </listitem>
+ <listitem>
+ <para>Section "Device". You may want to set some of the options
+ available for your selected video driver. A description of the driver
+ parameters is in the man page for your driver.</para>
+ </listitem>
+ <listitem><para>Section "Screen". Add a DefaultDepth statement such as:
+ <option>DefaultDepth 24</option>. In the SubSection for your
+ default depth, add a modes line such as:
+ <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The first
+ mode listed will normally be the starting resolution.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Test the system with:</para>
+
+<screen><userinput>X -config ~/xorg.conf.new</userinput></screen>
+
+ <para>You will only get a gray background with an X-shaped mouse cursor,
+ but it confirms the system is working. Exit with
+ <keycap>Control+Alt+Backspace</keycap>. If the system does not work, take
+ a look at <filename>/var/log/Xorg.0.log</filename> to see what went
+ wrong.</para>
+
+ <para>Move the configuration file to its final location:</para>
+
+<screen role="root"><userinput>mv ~/xorg.conf.new
/etc/X11/xorg.conf</userinput></screen>
+
+ <para>Create <filename>.xinitrc</filename>:</para>
+
+<screen><userinput>cat > ~/.xinitrc << "EOF"
+<literal># Begin .xinitrc file
xterm -g 80x40+0+0 &
xclock -g 100x100-0+0 &
-twm
-<command>EOF</command></userinput></screen>
-This provides an initial screen with an xterm and a clock that is managed by a
-simple window manager, Tab Window Manager. For details of
-<command>twm</command>, see the man page.</para>
+twm</literal>
+EOF</userinput></screen>
-<indexterm zone="xorg xorg-config">
- <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
-</indexterm>
-
-<note>
-<para>When needed, <application>Xorg</application> creates the directory
-<filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is
-not owned by root, <application>Xorg</application> delays startup by a few
-seconds and also appends a warning to the logfile. This also affects startup
of
-other applications. To improve performance, it is advisable to manually create
-the directory before <application>Xorg</application> uses it. Add the file
-creation to <filename>/etc/sysconfig/createfiles</filename> that is sourced by
-the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
-
-<screen><userinput role='root'><command>cat >>
/etc/sysconfig/createfiles << "EOF"</command>
-/tmp/.ICE-unix dir 1777 root root
-<command>EOF</command></userinput></screen>
-</note>
+ <para>This provides an initial screen with an xterm and a clock that is
+ managed by a simple window manager, Tab Window Manager. For details of
+ <command>twm</command>, see the man page.</para>
-<indexterm zone="xorg xorg-config">
- <primary
sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
-</indexterm>
+ <indexterm zone="xorg xorg-config">
+ <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
+ </indexterm>
-<para>Start <application>X</application> with:
-<screen><userinput><command>startx</command></userinput></screen>
-to get a basic functional <application>X</application> Window System.</para>
+ <note>
+ <para>When needed, <application>Xorg</application> creates the directory
+ <filename>/tmp/.ICE-unix</filename> if it does not exist. If this
+ directory is not owned by <systemitem class="username">root</systemitem>,
+ <application>Xorg</application> delays startup by a few seconds and also
+ appends a warning to the logfile. This also affects startup of other
+ applications. To improve performance, it is advisable to manually create
+ the directory before <application>Xorg</application> uses it. Add the
+ file creation to <filename>/etc/sysconfig/createfiles</filename> that is
+ sourced by the <filename>/etc/rc.d/init.d/cleanfs</filename> startup
+ script.</para>
-<para>At this point, you should check out <xref linkend='x-setup'/> for the
-necessary configuration to make <application>X</application> fully functional.
-Additionally, you can have a look at <xref linkend='x-config'/> for
-information on fine tuning your <application>X</application>
-configuration.</para>
+<screen role="root"><userinput>cat >> /etc/sysconfig/createfiles
<< "EOF"
+<literal>/tmp/.ICE-unix dir 1777 root root</literal>
+EOF</userinput></screen>
-<para>For a list of the package contents and a description of the commands,
-see the sections in the <xref linkend='xfree86-contents'/>.</para>
+ </note>
-</sect2>
+ <indexterm zone="xorg xorg-config">
+ <primary
+ sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
+ </indexterm>
+ <para>Start <application>X</application> with:</para>
+
+<screen><userinput>startx</userinput></screen>
+
+ <para>to get a basic functional <application>X Window
+ System</application>.</para>
+
+ <para>At this point, you should check out <xref linkend='x-setup'/> for
+ the necessary configuration to make <application>X</application> fully
+ functional. Additionally, you can have a look at <xref linkend='x-config'/>
+ for information on fine tuning your <application>X</application>
+ configuration.</para>
+
+ <para>For a list of the package contents and a description of the commands,
+ see the sections in the <xref linkend='xfree86-contents'/>.</para>
+
+ </sect2>
+
</sect1>
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
