[blfs-book] r10396 - in trunk/BOOK: general/genlib general/sysutils postlfs/security

krejzi at linuxfromscratch.org krejzi at linuxfromscratch.org
Fri Jul 6 03:22:21 PDT 2012


Author: krejzi
Date: 2012-07-06 04:22:12 -0600 (Fri, 06 Jul 2012)
New Revision: 10396

Modified:
   trunk/BOOK/general/genlib/libdrm.xml
   trunk/BOOK/general/sysutils/dbus.xml
   trunk/BOOK/general/sysutils/obexd.xml
   trunk/BOOK/general/sysutils/upower.xml
   trunk/BOOK/postlfs/security/polkit.xml
Log:
Improved some instructions. Spelling and typo fixes welcome.

Modified: trunk/BOOK/general/genlib/libdrm.xml
===================================================================
--- trunk/BOOK/general/genlib/libdrm.xml	2012-07-05 13:05:31 UTC (rev 10395)
+++ trunk/BOOK/general/genlib/libdrm.xml	2012-07-06 10:22:12 UTC (rev 10396)
@@ -29,31 +29,45 @@
   <sect2 role="package">
     <title>Introduction to libdrm</title>
 
-    <para><application>libdrm</application> provides core library routines
-    for the X Window System to directly interface with video hardware using
-    the Linux kernel's Direct Rendering Modules (DRM).</para>
+    <para>
+      <application>libdrm</application> provides core library routines
+      for the X Window System to directly interface with video hardware using
+      the Linux kernel's Direct Rendering Manager (DRM).
+    </para>
 
     &lfs71_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&libdrm-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&libdrm-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&libdrm-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&libdrm-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &libdrm-md5sum;</para>
+        <para>
+          Download MD5 sum: &libdrm-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &libdrm-size;</para>
+        <para>
+          Download size: &libdrm-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &libdrm-buildsize;</para>
+        <para>
+          Estimated disk space required: &libdrm-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &libdrm-time;</para>
+        <para>
+          Estimated build time: &libdrm-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -61,46 +75,52 @@
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-    <xref linkend="xorg7-lib"/>
+      <xref linkend="xorg7-lib"/>
     </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-    <ulink url="http://www.valgrind.org/">Valgrind</ulink>
+      <ulink url="http://www.valgrind.org/">Valgrind</ulink>
     </para>
 
-    <!-- Although configure checks for Cairo and the makefiles set CAIRO_CFLAGS
-    and CAIRO_LIBS, it doesn't seem to use cairo at all. There is code in
-    tests/modetest/modetest.c which suggests that they will use Cairo for
-    testing in the future, but at the moment it seems that code isn't used
-    Andy 2012-05-01
-
-    <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><xref linkend="cairo"/></para>
-    -->
-
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/libdrm"/></para>
-
+      <ulink url="&blfs-wiki;/libdrm"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of libdrm</title>
 
-    <para>Install <application>libdrm</application> by running the following
-    commands:</para>
+    <warning>
+      <para>
+        You may notice that there are several newer version of
+        <application>libdrm</application> available upstream.
+        However, we do not recommend using any later version than
+        this one if you are going to build
+        <xref linkend="mesalib"/> using BLFS instructions.
+      </para>
+    </warning>
 
+    <para>
+      Install <application>libdrm</application> by running the following
+      commands:
+    </para>
+
 <screen><userinput>./configure --prefix=$XORG_PREFIX            \
             --enable-udev                    \
             --enable-vmwgfx-experimental-api \
             --enable-nouveau-experimental-api &&
 make</userinput></screen>
 
-    <para>To check the results, issue <command>make check</command>. Note that
-    some tests may fail depending on the video hardware installed in the
-    machine.</para>
+    <para>
+      To check the results, issue <command>make check</command>. Note that
+      some tests may fail depending on the video hardware installed in the
+      machine.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
@@ -109,28 +129,41 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><option>--enable-vmwgfx-experimental-api</option>: This parameter
-    enables use of vmwgfx's experimental kernel API.</para>
+    <para>
+      <option>--enable-nouveau-experimental-api</option>: This parameter
+      enables building of Nouveau (Open Source NVidia drivers) DRM interface
+      library as well as corresponding headers.
+    </para>
 
-    <para><option>--enable-omap-experimental-api</option>: This option
-    enables use of OMAP's experimental kernel API. OMAP is a series of
-    system-on-chips (SoCs) developed by Texas Instruments.</para>
+    <para>
+      <option>--enable-vmwgfx-experimental-api</option>: This parameter
+      enables use of vmwgfx experimental kernel API used by the
+      VMware 3D Gallium driver.
+    </para>
 
+    <para>
+      <option>--enable-omap-experimental-api</option>: This option
+      enables use of OMAP's experimental kernel API. OMAP is a series of
+      system-on-chips (SoCs) developed by Texas Instruments.
+    </para>
+
   </sect2>
 
   <sect2 role="content">
     <title>Contents</title>
 
     <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
       <segtitle>Installed Libraries</segtitle>
       <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>None</seg>
-        <seg>libdrm.so, libdrm_intel.so, libdrm_nouveau.so,
-        libdrm_radeon.so and libkms.so</seg>
-        <seg><envar>$XORG_PREFIX</envar>/include/{libdrm,libkms}</seg>
+        <seg>
+          libdrm.so, libdrm_intel.so, libdrm_nouveau.so, libdrm_omap.so
+          libdrm_radeon.so and libkms.so
+        </seg>
+        <seg>
+          <envar>$XORG_PREFIX</envar>/include/{libdrm,libkms,nouveau,omap}
+        </seg>
       </seglistitem>
     </segmentedlist>
 
@@ -140,20 +173,25 @@
       <?dbhtml list-presentation="table"?>
 
       <varlistentry id="libdrm-lib">
-        <term><filename class='libraryfile'>libdrm{_intel,_nouveau,_radeon}.so</filename></term>
+        <term><filename class='libraryfile'>libdrm{,_intel,_nouveau,_omap,_radeon}.so</filename></term>
         <listitem>
-          <para>contains the Direct Rendering Module library functions, and
-          additional vendor specific functions for Intel, nVidia and Radeon
-          devices.</para>
+          <para>
+            contains the Direct Rendering Manager library functions, and
+            additional vendor specific functions for Intel, nVidia, Omap
+            and Radeon devices.
+          </para>
           <indexterm zone="libdrm libdrm-lib">
-            <primary sortas="c-libdrm">libdrm{_intel,_nouveau,_radeon}.so</primary>
+            <primary sortas="c-libdrm">libdrm{,_intel,_nouveau,_omap,_radeon}.so</primary>
           </indexterm>
         </listitem>
       </varlistentry>
+
       <varlistentry id="libkms-lib">
         <term><filename class='libraryfile'>libkms.so</filename></term>
         <listitem>
-          <para>contains functions necessary for kernel modesetting.</para>
+          <para>
+            contains functions necessary for kernel modesetting.
+          </para>
           <indexterm zone="libdrm libkms-lib">
             <primary sortas="c-libkms">libkms.so</primary>
           </indexterm>

Modified: trunk/BOOK/general/sysutils/dbus.xml
===================================================================
--- trunk/BOOK/general/sysutils/dbus.xml	2012-07-05 13:05:31 UTC (rev 10395)
+++ trunk/BOOK/general/sysutils/dbus.xml	2012-07-06 10:22:12 UTC (rev 10396)
@@ -150,6 +150,17 @@
 mv -v /usr/share/doc/dbus /usr/share/doc/dbus-&dbus-version;</userinput></screen>
 
     <para>
+      If you are still building your system in chroot or you did not start the
+      daemon yet, but you want to compile some packages that require
+      <application>D-Bus</application>, generate
+      <application>D-Bus</application> UUID to avoid warnings when compiling
+      some packages with the following command as the
+      <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>dbus-uuidgen --ensure</userinput></screen>
+
+    <para>
       The dbus tests cannot be run until after <xref linkend="dbus-glib"/>
       has been installed. The tests require passing additional parameters to
       <command>configure</command> and exposing additional functionality in the

Modified: trunk/BOOK/general/sysutils/obexd.xml
===================================================================
--- trunk/BOOK/general/sysutils/obexd.xml	2012-07-05 13:05:31 UTC (rev 10395)
+++ trunk/BOOK/general/sysutils/obexd.xml	2012-07-06 10:22:12 UTC (rev 10396)
@@ -31,7 +31,8 @@
 
     <para>
       The <application>Obexd</application> package contains D-Bus services providing
-      OBEX client and server functionality.
+      OBEX client and server functionality. OBEX is a communications protocol that
+      facilitates the exchange of binary objects between devices.
     </para>
 
     &lfs71_checked;

Modified: trunk/BOOK/general/sysutils/upower.xml
===================================================================
--- trunk/BOOK/general/sysutils/upower.xml	2012-07-05 13:05:31 UTC (rev 10395)
+++ trunk/BOOK/general/sysutils/upower.xml	2012-07-06 10:22:12 UTC (rev 10396)
@@ -89,7 +89,8 @@
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend="gtk-doc"/>
+      <xref linkend="gtk-doc"/> and
+      <xref linkend="python3"/> (used only in the testsuite).
     </para>
 
     <para condition="html" role="usernotes">User Notes:

Modified: trunk/BOOK/postlfs/security/polkit.xml
===================================================================
--- trunk/BOOK/postlfs/security/polkit.xml	2012-07-05 13:05:31 UTC (rev 10395)
+++ trunk/BOOK/postlfs/security/polkit.xml	2012-07-06 10:22:12 UTC (rev 10396)
@@ -98,7 +98,10 @@
     <note>
       <para>
         If <xref linkend="libxslt"/> is installed then <xref linkend="DocBook"/> 
-        and <xref linkend="docbook-xsl"/> are required.
+        and <xref linkend="docbook-xsl"/> are required. If you have installed
+        <xref linkend="libxslt"/>, but you do not want to install any of the
+        DocBook packages mentioned, you will need to use
+        <option>--disable-man-pages</option> in the instructions below.
       </para>
     </note>
 
@@ -136,6 +139,10 @@
 
     <para>
       To test the results, issue: <command>make check</command>.
+      Note that system <application>D-Bus</application> daemon
+      must be running for the testsuite to complete. There is
+      also a warning about <application>ConsoleKit</application>
+      database not present, but that one can be safely ignored.
     </para>
 
     <para>




More information about the blfs-book mailing list