r7044 - in trunk/BOOK: . introduction/welcome multimedia/videoutils x/installing xincludes

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sat Aug 11 16:32:14 PDT 2007


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




More information about the blfs-book mailing list