Author: randy
Date: 2007-08-11 17:32:14 -0600 (Sat, 11 Aug 2007)
New Revision: 7044
Added:
trunk/BOOK/xincludes/X11R6_symlink.xml
Modified:
trunk/BOOK/general.ent
trunk/BOOK/introduction/welcome/changelog.xml
trunk/BOOK/multimedia/videoutils/mplayer.xml
trunk/BOOK/x/installing/x-setup.xml
Log:
First cut at adding instructions to create an /usr/X11R6 compatibility symlink
Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent 2007-08-11 21:21:32 UTC (rev 7043)
+++ trunk/BOOK/general.ent 2007-08-11 23:32:14 UTC (rev 7044)
@@ -3,7 +3,7 @@
$Date$
-->
-<!ENTITY day "11"> <!-- Always 2 digits -->
+<!ENTITY day "12"> <!-- Always 2 digits -->
<!ENTITY month "08"> <!-- Always 2 digits -->
<!ENTITY year "2007">
<!ENTITY version "svn-&year;&month;&day;">
Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml 2007-08-11 21:21:32 UTC
(rev 7043)
+++ trunk/BOOK/introduction/welcome/changelog.xml 2007-08-11 23:32:14 UTC
(rev 7044)
@@ -42,6 +42,16 @@
-->
<listitem>
+ <para>August 12th, 2007</para>
+ <itemizedlist>
+ <listitem>
+ <para>[randy] - Added instructions to create an X11R6 symlink to the
+ X Windows Components page.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>August 11th, 2007</para>
<itemizedlist>
<listitem>
Modified: trunk/BOOK/multimedia/videoutils/mplayer.xml
===================================================================
--- trunk/BOOK/multimedia/videoutils/mplayer.xml 2007-08-11 21:21:32 UTC
(rev 7043)
+++ trunk/BOOK/multimedia/videoutils/mplayer.xml 2007-08-11 23:32:14 UTC
(rev 7044)
@@ -343,6 +343,9 @@
optimizations.</para>
</note>
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
+ href="../../xincludes/X11R6_symlink.xml"/>
+
<para><application>MPlayer</application> can build a shared
post-processing library from the internal
<application>FFmpeg</application> package which
Modified: trunk/BOOK/x/installing/x-setup.xml
===================================================================
--- trunk/BOOK/x/installing/x-setup.xml 2007-08-11 21:21:32 UTC (rev 7043)
+++ trunk/BOOK/x/installing/x-setup.xml 2007-08-11 23:32:14 UTC (rev 7044)
@@ -15,28 +15,67 @@
<title>X Window System Components</title>
- <sect2 role="configuration" id='xconfig'>
+ <para condition="html" role="usernotes">User Notes:
+ <ulink url='&blfs-wiki;/XWindowSystemComponents'/></para>
+
+ <sect2 role="configuration" id='X11R6-compat-symlink'
+ xreflabel="Creating an X11R6 Compatibility Symlink">
+
+ <title>Creating an X11R6 Compatibility Symlink</title>
+
+ <para>Until recently (relatively speaking) almost every
+ <application>X Window</application> installation you performed or came
+ across was installed in the
+ <filename class='directory'>/usr/X11R6</filename> directory. That was the
+ standard for years. Developers picked up on this and wrote their package
+ installation scripts looking for <application>X</application> in the
+ standard location. Things have changed and the trend is to now install
+ <application>X</application> in
+ <filename class='directory'>/usr</filename>. Some people want to install
+ it in a custom location.</para>
+
+ <para>Many package developers have not caught up to the change and their
+ packages are still trying to find <application>X</application> in
+ <filename class='directory'>/usr/X11R6</filename> and subsequently fail
+ when you try to build the package. Though for most packages it is not
+ difficult to 'hack' the installation script to fix the problem, that is not
+ the long term solution to the problem. Upstream developers need to
modernize
+ their installation scripts and eliminate the problem altogether.</para>
+
+ <para>Until then, you can create a symbolic link to satisfy the
+ <filename class='directory'>/usr/X11R6</filename> requirement so that you
+ won't be inconvenienced with a package build failure due to this known
+ issue. If you wish to create the symlink, issue the following command as
+ the <systemitem class="username">root</systemitem> user (ensure you modify
+ <replaceable><$XORG_PREFIX></replaceable> appropriately):</para>
+
+<screen role="root"><userinput>ln -vsf
<replaceable><$XORG_PREFIX></replaceable> /usr/X11R6</userinput></screen>
+
+ </sect2>
+
+ <sect2 role="configuration" id='xconfig'>
<title>Configuring The X Window System</title>
- <para condition="html" role="usernotes">User Notes:
- <ulink url='&blfs-wiki;/XWindowSystemComponents'/></para>
+ <para>If you've installed the X Window System in any prefix other than
+ <filename>/usr</filename>, become the <systemitem
+ class="username">root</systemitem> user and update the library linker's
+ cache by adding <filename class='directory'>/usr/X11R6/lib</filename>
+ to <filename>/etc/ld.so.conf</filename> and running
+ <command>ldconfig</command>.</para>
- <para>If you've installed the X Window System in any prefix other
- than <filename>/usr</filename>, as the
- <systemitem class="username">root</systemitem> user, add
- <filename class="directory">
- <replaceable></usr/X11R6></replaceable>/lib</filename> to
- the <filename>/etc/ld.so.conf</filename> file and run
- <command>ldconfig</command>. Additionally, while still the
- <systemitem class="username">root</systemitem> user, ensure
- <filename class="directory">
- <replaceable></usr/X11R6></replaceable>/bin</filename>
- and <filename class="directory">
- <replaceable></usr/X11R6></replaceable>/lib/pkgconfig</filename>
- are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
+ <para>Additionally, while still the <systemitem
+ class="username">root</systemitem> user, ensure
+ <filename class="directory">/usr/X11R6/bin</filename> and
+ <filename class="directory">/usr/X11R6/lib/pkgconfig</filename> are added
+ to the <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>Ensure you replace
+ <filename class="directory">/usr/X11R6</filename> with
+ <envar>$XORG_PREFIX</envar> in the previous two paragraphs if you did not
+ create the compatibility symlink in the previous step.</para>
+
<para>As the <systemitem class="username">root</systemitem> user
create a basic X Window System configuration file with the following
commands:</para>
Added: trunk/BOOK/xincludes/X11R6_symlink.xml
===================================================================
--- trunk/BOOK/xincludes/X11R6_symlink.xml (rev 0)
+++ trunk/BOOK/xincludes/X11R6_symlink.xml 2007-08-11 23:32:14 UTC (rev
7044)
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; >
+
+ <!-- $LastChangedBy$ -->
+ <!-- $Date$ -->
+
+ <para>This package (unfortunately) expects the <application>X
+ Window</application> system to be installed in the
+ <filename class='directory'>/usr/X11R6</filename> directory. If you're
+ using a recent version of <application>Xorg</application> and it is
+ installed in any other location, ensure you have
+ followed the instructions in the <xref linkend="X11R6-compat-symlink"/>
+ section.</para>
Property changes on: trunk/BOOK/xincludes/X11R6_symlink.xml
___________________________________________________________________
Name: svn:keywords
+ LastChangedBy Date
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
