Additions and corrections to Mesa and libdrm

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

x/lib/libdrm.xml

@@ -64,16 +64,11 @@
   <sect2 role="installation">
     <title>Installation of libdrm</title>
 
-    <para><application>libdrm</application> should be installed with the same
-    installation prefix as your X Window System.  Replace
-    '<replaceable>[prefix]</replaceable>' in the instructions below with the
-    chosen installation prefix of your X Window System.</para>
-
     <para>Install <application>libdrm</application> by running the following
     commands:</para>
 
 <screen><userinput>autoreconf &amp;&amp;
-./configure --prefix=<replaceable>[prefix]</replaceable> &amp;&amp;
+./configure --prefix=/usr &amp;&amp;
 make</userinput></screen>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
@@ -108,7 +103,7 @@ make</userinput></screen>
       <varlistentry id="libdrm-lib">
         <term><filename class='libraryfile'>libdrm.[so,a]</filename></term>
         <listitem>
-          <para>contains the Direct Rendering Manager library functions.</para>
+          <para>contains the Direct Rendering Module library functions.</para>
           <indexterm zone="libdrm libdrm-lib">
             <primary sortas="c-libdrm">libdrm.[so,a]</primary>
           </indexterm>

x/lib/mesalib.xml

@@ -76,7 +76,8 @@
 
     <para><ulink
     url="http://prdownloads.sourceforge.net/mesa3d/MesaDemos-&mesalib-version;.tar.bz2"/>
-    provides demos and a test program to verify that DRI is working as expected.</para>
+    provides a demo and a diagnostic program to verify that GL is working 
+    properly.</para>
 
     <note>
       <para>You should extract all three tarballs from the same toplevel
@@ -91,12 +92,11 @@
     <title>Installation of MesaLib</title>
 
     <para>If you've installed the X Window System into any prefix other than
-    <filename class="directory">/usr/X11R6</filename>, then execute the
+    <filename class="directory">/usr</filename>, then you'll need to adjust the
-    following commands to correct several hard coded directory assumptions in
+    commands below for your system.  Correct several hard coded directories 
-    the source files.  Be sure to replace '<replaceable>[prefix]</replaceable>'
+    in the source files with the following command:</para>
-    with the installation prefix of your installed X Window System:</para>
 
-<screen><userinput>find . -type f -exec sed -i 's@/usr/X11R6@<replaceable>[prefix]</replaceable>@g' {} \;</userinput></screen>
+<screen><userinput>find . -type f -exec sed -i 's@/usr/X11R6@/usr@g' {} \;</userinput></screen>
 
     <para>Install <application>MesaLib</application> 
     by running the following command:</para>
@@ -107,9 +107,9 @@
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
-<screen role="root"><userinput>bin/installmesa <replaceable>[prefix]</replaceable> &amp;&amp;
+<screen role="root"><userinput>bin/installmesa /usr &amp;&amp;
-mkdir -v -p <replaceable>[prefix]</replaceable>/lib/modules/dri &amp;&amp;
+mkdir -v -p /usr/lib/modules/dri &amp;&amp;
-install -v -o root -m 0755 lib/*dri* <replaceable>[prefix]</replaceable>/lib/modules/dri</userinput></screen>
+install -v -m755 lib/*dri* /usr/lib/modules/dri</userinput></screen>
 
     <para>If you've extracted the GLUT and Demos packages as well, then 
     build the test programs with the following commands:</para>
@@ -120,7 +120,7 @@ make PROGS='glxinfo glxgears'</userinput></screen>
     <para>Install the demos as the
     <systemitem class="username">root</systemitem> user:</para>
 
-<screen role="root"><userinput>install -v -o root -m 0755 glxinfo glxgears <replaceable>[prefix]</replaceable>/bin</userinput></screen>
+<screen role="root"><userinput>install -v -m755 glxinfo glxgears /usr/bin</userinput></screen>
 
     <note>
       <para>If building Xorg-7.0<!--<xref linkend="xorg7"/>-->, do not 
@@ -146,6 +146,34 @@ make PROGS='glxinfo glxgears'</userinput></screen>
       </seglistitem>
     </segmentedlist>
 
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="glxgears">
+        <term><filename>glxgears</filename></term>
+        <listitem>
+          <para>a GL demo useful for troubleshooting graphics problems.</para>
+          <indexterm zone="MesaLib glxgears">
+            <primary sortas="b-glxgears">glxgears</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="glxinfo">
+        <term><filename>glxinfo</filename></term>
+        <listitem>
+          <para>a diagnostic program that displays information about the 
+          graphics hardware and installed GL libraries.</para>
+          <indexterm zone="MesaLib glxinfo">
+            <primary sortas="b-glxinfo">glxinfo</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
 </sect1>