Changeset 68c8cba

Timestamp:

08/11/2007 11:32:14 PM (17 years ago)

Author:

Randy McMurchy <randy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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

Children:

71cd2a5a

Parents:

95cc4e4

Message:

First cut at adding instructions to create an /usr/X11R6 compatibility symlink

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

Files:

• general.ent (modified) (1 diff)
• introduction/welcome/changelog.xml (modified) (1 diff)
• multimedia/videoutils/mplayer.xml (modified) (1 diff)
• x/installing/x-setup.xml (modified) (1 diff)
• xincludes/X11R6_symlink.xml (added)

general.ent

@@ -4 +4 @@
 -->
 
-<!ENTITY day          "11">                   <!-- Always 2 digits -->
+<!ENTITY day          "12">                   <!-- Always 2 digits -->
 <!ENTITY month        "08">                   <!-- Always 2 digits -->
 <!ENTITY year         "2007">

introduction/welcome/changelog.xml

@@ -41 +41 @@
 
 -->
+
+    <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>

multimedia/videoutils/mplayer.xml

@@ -344 +344 @@
       </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

x/installing/x-setup.xml

@@ -16 +16 @@
   <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>&lt;$XORG_PREFIX&gt;</replaceable> appropriately):</para>
+
+<screen role="root"><userinput>ln -vsf <replaceable>&lt;$XORG_PREFIX&gt;</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>, as the
-    <systemitem class="username">root</systemitem> user, add
-    <filename class="directory">
-    <replaceable>&lt;/usr/X11R6&gt;</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>&lt;/usr/X11R6&gt;</replaceable>/bin</filename>
-    and <filename class="directory">
-    <replaceable>&lt;/usr/X11R6&gt;</replaceable>/lib/pkgconfig</filename>
-    are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
+    <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>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