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>
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
