[blfs-book] r11680 - in trunk/BOOK: archive general/genlib general/graphlib general/prog multimedia multimedia/audioutils multimedia/hwaccel multimedia/libdriv x/installing

bdubbs at higgs.linuxfromscratch.org bdubbs at higgs.linuxfromscratch.org
Fri Aug 23 13:56:44 PDT 2013


Author: bdubbs
Date: Fri Aug 23 13:56:44 2013
New Revision: 11680

Log:
Move Video HW acceleration into Xorg drivers section
LFS 7.4 tags

Added:
   trunk/BOOK/archive/qt4.xml
      - copied unchanged from r11677, trunk/BOOK/archive/qt.xml
   trunk/BOOK/x/installing/libva.xml
      - copied, changed from r11677, trunk/BOOK/multimedia/hwaccel/libva.xml
   trunk/BOOK/x/installing/libvdpau.xml
      - copied, changed from r11677, trunk/BOOK/multimedia/hwaccel/libvdpau.xml
Deleted:
   trunk/BOOK/archive/qt.xml
   trunk/BOOK/multimedia/hwaccel/
Modified:
   trunk/BOOK/general/genlib/libarchive.xml
   trunk/BOOK/general/genlib/lzo.xml
   trunk/BOOK/general/graphlib/lcms.xml
   trunk/BOOK/general/graphlib/libmng.xml
   trunk/BOOK/general/graphlib/openjpeg.xml
   trunk/BOOK/general/prog/cmake.xml
   trunk/BOOK/multimedia/audioutils/cdparanoia.xml
   trunk/BOOK/multimedia/audioutils/mpg123.xml
   trunk/BOOK/multimedia/libdriv/faac.xml
   trunk/BOOK/multimedia/libdriv/faad2.xml
   trunk/BOOK/multimedia/libdriv/gst10-plugins-base.xml
   trunk/BOOK/multimedia/libdriv/libmpeg2.xml
   trunk/BOOK/multimedia/libdriv/libtheora.xml
   trunk/BOOK/multimedia/libdriv/taglib.xml
   trunk/BOOK/multimedia/libdriv/xvid.xml
   trunk/BOOK/multimedia/multimedia.xml
   trunk/BOOK/x/installing/x7driver.xml

Copied: trunk/BOOK/archive/qt4.xml (from r11677, trunk/BOOK/archive/qt.xml)
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ trunk/BOOK/archive/qt4.xml	Fri Aug 23 13:56:44 2013	(r11680, copy of r11677, trunk/BOOK/archive/qt.xml)
@@ -0,0 +1,563 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY qt-download-http "&trinity-repo-http;/qt3-3.3.8.d.tar.gz">
+  <!ENTITY qt-download-ftp  "&trinity-repo-ftp;/qt3-3.3.8.d.tar.gz ">
+  <!ENTITY qt-md5sum        "78dc675e84aed595375449818cbb589a">
+  <!ENTITY qt-size          "16.8 MB">
+  <!ENTITY qt-buildsize     "801 MB">
+  <!ENTITY qt-time          "8.6 SBU">
+]>
+
+<sect1 id="qt" xreflabel="Qt-&qt-version;">
+  <?dbhtml filename="qt.html" ?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Qt-&qt-version;</title>
+
+  <indexterm zone="qt">
+    <primary sortas="a-qt">Qt</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to Qt</title>
+
+    <para>The <application>Qt</application> package contains a
+    <application>C++</application> GUI library. This is useful for creating
+    graphical applications or executing graphical applications that are
+    dynamically linked to the <application>Qt</application> library. Two of
+    the major users of <application>Qt</application> are
+    <application>KDE</application> and its follow on project,
+    <application>Trinity</application>.</para>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&qt-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&qt-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &qt-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &qt-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &qt-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &qt-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para>Required Patch: <ulink
+          url="&patch-root;/qt-3.3.8.d-libpng15-1.patch"/>
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Qt Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required"><xref linkend="x-window-system"/></para>
+
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended">
+      <xref linkend="libjpeg"/> and
+      <xref linkend="libmng"/>
+    </para>
+
+    <para>Note: if for whatever reason you do not have the recommended
+    libraries installed on your system, you must remove the corresponding
+    <parameter>-system-<replaceable><library></replaceable></parameter> and
+    <parameter>-plugin-imgfmt-<replaceable><library></replaceable></parameter>
+    parameters from the <command>configure</command> commands shown in the
+    instructions below.</para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="cups"/>,
+      <xref linkend="mysql"/>,
+      <xref linkend="postgresql"/>,
+      <xref linkend="unixodbc"/>,
+      <xref linkend="sqlite"/>, and
+      <ulink url="http://firebird.sourceforge.net/">Firebird</ulink>
+    </para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/qt"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of Qt</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+    href="../../xincludes/X11R6_symlink.xml"/>
+
+    <para>There are several ways to install a complicated package such as
+    <application>Qt</application>. The files are not completely position
+    independent. Installation procedures execute the program
+    <command>pkg-config</command> to determine the location of package
+    executables, libraries, headers, and other files. For
+    <application>Qt</application>, <command>pkg-config</command> will look
+    for the file <filename>lib/pkgconfig/qt-mt.pc</filename> which must be
+    modified if relocating the package. This file is set up correctly by
+    the build process.</para>
+
+    <para>The default installation places the files in
+    <filename class='directory'>/usr/local/qt/</filename>. Many commercial
+    distributions place the files in the system's
+    <filename class='directory'>/usr</filename> hierarchy. The package can
+    also be installed in an arbitrary directory.</para>
+
+    <para>This section will demonstrate two different methods.</para>
+
+    <warning>
+      <para>Building <application>Qt</application> in a
+      <command>chroot</command> environment may fail.</para>
+    </warning>
+
+    <note>
+      <para>The build time for <application>Qt</application> is quite long. If
+      you want to save some time and don't want the tutorials and examples,
+      change the first <command>make</command> command to:</para>
+
+<screen><userinput>make sub-tools</userinput></screen>
+
+    </note>
+
+    <sect3>
+      <title>Method 1 - Installing in the '/usr' Hierarchy</title>
+
+      <para>The advantage of this method is that no updates to the
+      <filename>/etc/ld.so.conf</filename> or
+      <filename>/etc/man_db.conf</filename> files are required. The package
+      files are distributed within several subdirectories of the
+      <filename class='directory'>/usr</filename> hierarchy.
+      This is the method that most commercial distributions use.</para>
+
+      <note>
+        <para>If <application>Qt</application> is being reinstalled, run the
+        following commands from a console or non-Qt based window manager.
+        It overwrites <application>Qt</application> libraries that should not
+        be in use during the install process.</para>
+      </note>
+
+<screen><userinput>sed -i '/QMAKE_RPATH/d' mkspecs/linux*/qmake.conf &&
+
+bash
+export PATH=$PWD/bin:$PATH                       &&
+export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH &&
+
+patch -Np1 -i ../qt-3.3.8.d-libpng15-1.patch    &&
+
+./configure -prefix     /usr                \
+            -docdir     /usr/share/doc/qt   \
+            -headerdir  /usr/include/qt     \
+            -plugindir  /usr/lib/qt/plugins \
+            -datadir    /usr/share/qt       \
+            -sysconfdir /etc/qt             \
+            -translationdir /usr/share/qt/translations \
+            -qt-gif                         \
+            -system-zlib                    \
+            -system-libpng                  \
+            -system-libjpeg                 \
+            -system-libmng                  \
+            -plugin-imgfmt-png              \
+            -plugin-imgfmt-jpeg             \
+            -plugin-imgfmt-mng              \
+            -no-exceptions                  \
+            -thread                         \
+            -tablet &&
+
+make &&
+exit</userinput></screen>
+
+      <para>This package does not come with a test suite.</para>
+
+      <para>Now, as the <systemitem class="username">root</systemitem>
+      user:</para>
+
+<screen role="root"><userinput>make install &&
+ln -v -sf libqt-mt.so /usr/lib/libqt.so &&
+ln -v -snf ../../bin /usr/share/qt/bin &&
+ln -v -snf ../../include/qt /usr/share/qt/include &&
+ln -v -snf ../../lib /usr/share/qt/lib &&
+cp -v -r doc/man /usr/share &&
+cp -v -r examples /usr/share/doc/qt</userinput></screen>
+
+    </sect3>
+
+    <sect3>
+      <title>Method 2 - Installing in '/opt'</title>
+
+      <para>This is the method recommended by the <application>Qt</application>
+      developers. It has the advantage of keeping all the package files
+      consolidated in a dedicated directory hierarchy. By using this method,
+      an update can be made without overwriting a previous installation and
+      users can easily revert to a previous version by changing one symbolic
+      link.</para>
+
+      <para>The <application>Qt</application> developers use a default location
+      of <filename class='directory'>/usr/local/qt/</filename>, however this
+      procedure puts the files in <filename
+      class='directory'>/opt/qt-&qt-version;/</filename>
+      and then creates a symbolic link to <filename>/opt/qt/</filename>.</para>
+
+<screen><userinput>bash
+export QTDIR=$PWD                                &&
+export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH &&
+export PATH=$PWD/bin:$PATH                       &&
+
+patch -Np1 -i ../qt-3.3.8.d-libpng15-1.patch    &&
+
+./configure -prefix /opt/qt-&qt-version; \
+            -sysconfdir /etc/qt   \
+            -qt-gif               \
+            -system-zlib          \
+            -system-libpng        \
+            -system-libjpeg       \
+            -system-libmng        \
+            -plugin-imgfmt-png    \
+            -plugin-imgfmt-jpeg   \
+            -plugin-imgfmt-mng    \
+            -no-exceptions        \
+            -thread               \
+            -tablet &&
+
+make &&
+exit</userinput></screen>
+
+      <para>This package does not come with a test suite.</para>
+
+      <para>Now, as the <systemitem class="username">root</systemitem>
+      user:</para>
+
+<screen role="root"><userinput>make install &&
+ln -v -sfn qt-&qt-version; /opt/qt &&
+ln -v -s libqt-mt.so /opt/qt/lib/libqt.so &&
+cp -v -r doc/man examples /opt/qt/doc</userinput></screen>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><command>sed -i '/QMAKE_RPATH/d' mkspecs/linux*/qmake.conf</command>:
+    In Method 1, <application>Qt</application> is being installed into
+    the standard system directories. The runtime library search path does not
+    need to be set in this case.</para>
+
+    <para><command>bash</command>: This command enters a sub-shell to isolate
+    environment changes.</para>
+
+    <para><command>export QTDIR=$PWD</command>: This command defines where
+    the root of the <application>Qt</application> directory is located.</para>
+
+    <para><command>export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH</command>:
+    This command allows the not yet installed <application>Qt</application>
+    libraries to be used by the not yet installed <application>Qt</application>
+    programs.</para>
+
+    <para><command>export PATH=$PWD/bin:$PATH</command>: This command
+    allows the build process to find supporting executables.</para>
+
+    <para><parameter>-qt-gif</parameter>: This switch adds support for
+    <filename>gif</filename> files to the libraries.</para>
+
+    <para><parameter>-system-zlib -system-libpng -system-libjpeg
+    -system-mng</parameter>: These switches force the build instructions to use
+    the shared libraries that are on your system instead of creating a custom
+    set of support libraries for these functions.</para>
+
+    <para><parameter>-plugin-imgfmt-png -plugin-imgfmt-jpeg
+    -plugin-imgfmt-mng</parameter>: These switches enable run-time linking of
+    the referenced libraries.</para>
+
+    <para>If you pass the
+    <option>-plugin-sql-<replaceable><driver></replaceable></option> or
+    <option>-qt-sql-<replaceable><driver></replaceable></option> switch
+    to the <command>configure</command> command, you must also pass
+    <option>-I<replaceable></path/to/sql/headers></replaceable></option>
+    so <command>make</command> can find the appropriate header files.  For
+    instance, building in <application>MySQL</application> support (as opposed
+    to building the plugin) will need to use <option>-I/usr/include/mysql
+    -qt-sql-mysql</option>.</para>
+
+    <note>
+      <para>To check if <application>mysql</application> is autotetected
+      properly, examine the output of <command>./configure -I/usr/include/mysql
+      -help</command>. Other database support will require similar
+      <command>configure</command> parameters.</para>
+    </note>
+
+    <para><parameter>-no-exceptions</parameter>: This switch disables
+    the exceptions coding generated by the <application>C++</application>
+    compiler.</para>
+
+    <para><parameter>-thread</parameter>: This switch adds
+    support for multi-threading.</para>
+
+    <para><command>ln -v -sf libqt-mt.so /usr/lib/libqt.so</command>: This
+    command allows <command>configure</command> scripts to find a working
+    <application>Qt</application> installation.</para>
+
+    <para><command>ln -v -snf ../../bin /usr/share/qt/bin</command>: This
+    command and the following two allow the
+    <filename class="directory">/usr</filename> style installation to mimic
+    the <filename class="directory">/opt</filename> style installation by
+    making all binaries, headers and libraries available from a single
+    directory, <filename class="directory">/usr/share/qt</filename>.</para>
+
+    <para><command>cp -v -r doc/man examples /usr/share (or
+    /opt/qt/doc)</command>:
+    This command installs the man pages and examples which are missed by
+    <command>make install</command>.</para>
+
+    <para><command>exit</command>: This command returns to the parent shell
+    and eliminates the environment variables set earlier.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring Qt</title>
+
+    <sect3 id='qt-config'>
+      <title>Configuration Information</title>
+
+      <para>The <envar>QTDIR</envar> environment variable needs to be set when
+      building packages that depend on <application>Qt</application>. Add the
+      following to the <filename>.bash_profile</filename> initialization script
+      for each user that builds packages using the <application>Qt</application>
+      libraries. Alternatively, the variable can be set in the system wide
+      <filename>/etc/profile</filename> file.</para>
+
+      <para>For Method 1 (This is optional, only set this if an application is
+      unable to find the installed libraries or headers):</para>
+
+<screen><literal>export QTDIR=/usr/share/qt</literal></screen>
+
+      <para>or for Method 2:</para>
+
+<screen><literal>export QTDIR=/opt/qt</literal></screen>
+
+      <para>If you installed <application>Qt</application> using Method 2,
+      you also need to update the following configuration files so that
+      <application>Qt</application> is correctly found by other packages
+      and system processes.</para>
+
+      <para>Update the <filename>/etc/ld.so.conf</filename> and
+      <filename>/etc/man_db.conf</filename> files:</para>
+
+<screen role="root"><userinput>cat >> /etc/ld.so.conf << "EOF" &&
+<literal># Begin qt addition to /etc/ld.so.conf
+
+/opt/qt/lib
+
+# End qt addition</literal>
+EOF
+ldconfig &&
+cat >> /etc/man_db.conf << "EOF"
+<literal># Begin qt addition to man_db.conf
+
+MANDATORY_MANPATH /opt/qt/doc/man
+MANPATH_MAP       /opt/qt/bin         /opt/qt/doc/man
+MANDB_MAP         /opt/qt/doc/man     /var/cache/man/qt
+
+# End qt addition to man_db.conf</literal>
+EOF</userinput></screen>
+
+      <indexterm zone="qt qt-config">
+        <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
+      </indexterm>
+
+      <indexterm zone="qt qt-config">
+        <primary sortas="e-etc-man_db.conf">/etc/man_db.conf</primary>
+      </indexterm>
+
+      <indexterm zone="qt qt-config">
+        <primary sortas="e-etc-profile">/etc/profile</primary>
+      </indexterm>
+
+      <indexterm zone="qt qt-config">
+        <primary sortas="e-AA.bash_profile">~/.bash_profile</primary>
+      </indexterm>
+
+      <para>Update the <envar>PKG_CONFIG_PATH</envar> environment variable
+      in your <filename>~/.bash_profile</filename> or
+      <filename>/etc/profile</filename> with the following:</para>
+
+<screen><literal>PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/qt/lib/pkgconfig</literal></screen>
+
+      <para>If you want the <application>Qt</application> executables in your
+      shell search path, update the <envar>PATH</envar> environment variable
+      in your <filename>~/.bash_profile</filename> or
+      <filename>/etc/profile</filename> to include
+      <filename class='directory'>/opt/qt/bin</filename>.</para>
+
+      <tip><para>The PATH, MANPATH, and PKG_CONFIG_PATH can be updated in
+      the extrapaths.sh (or other script) in the /etc/profile.d directory
+      if you set up the startup files as recommended in
+      <xref linkend='postlfs-config-profile'/>.</para></tip>
+
+      <para>As with most libraries, there is no explicit configuration to do.
+      After updating <filename>/etc/ld.so.conf</filename> as explained above,
+      run <command>/sbin/ldconfig</command> so that <command>ldd</command>
+      can find the shared libraries.</para>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>assistant, designer, linguist, lrelease, lupdate, moc,
+        qm2ts, qmake, qtconfig, and uic</seg>
+        <seg>libqt-mt.so, libqt.so libqui.so, libdesignercore.a,
+        libeditor.a, and libqassistantclient.a</seg>
+        <seg>/opt/qt-&qt-version; or /usr/lib/qt, /usr/share/qt,
+        /usr/share/doc/qt, /usr/include/qt, and /etc/qt</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="assistant">
+        <term><command>assistant</command></term>
+        <listitem>
+          <para>is a tool for presenting on-line documentation.</para>
+          <indexterm zone="qt assistant">
+            <primary sortas="b-assistant">assistant</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="designer">
+        <term><command>designer</command></term>
+        <listitem>
+          <para>is a full-fledged GUI builder. It includes
+          powerful features such as preview mode, automatic widget
+          layout, support for custom widgets, and an advanced
+          property editor.</para>
+          <indexterm zone="qt designer">
+            <primary sortas="b-designer">designer</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="linguist">
+        <term><command>linguist</command></term>
+        <listitem>
+          <para>provides support for translating applications into
+          local languages. </para>
+          <indexterm zone="qt linguist">
+            <primary sortas="b-linguist">linguist</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="lrelease">
+        <term><command>lrelease</command></term>
+        <listitem>
+          <para>is a simple command line tool. It reads a Qt project
+          file and produces message files used by the application.</para>
+          <indexterm zone="qt lrelease">
+            <primary sortas="b-lrelease">lrelease</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="lupdate">
+        <term><command>lupdate</command></term>
+        <listitem>
+          <para>reads a Qt project file, finds the translatable
+          strings in the specified source, header and Qt Designer
+          interface files, and produces or updates the translation
+          files listed in the project file.</para>
+          <indexterm zone="qt lupdate">
+            <primary sortas="b-lupdate">lupdate</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="moc">
+        <term><command>moc</command></term>
+        <listitem>
+          <para>generates Qt meta object support code.</para>
+          <indexterm zone="qt moc">
+            <primary sortas="b-moc">moc</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="qm2ts">
+        <term><command>qm2ts</command></term>
+        <listitem>
+          <para>is a tool for converting Qt message file formats.</para>
+          <indexterm zone="qt qm2ts">
+            <primary sortas="b-qm2ts">qm2ts</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="qmake">
+        <term><command>qmake</command></term>
+        <listitem>
+          <para>qmake uses information stored in project files to
+          determine what should go in the makefiles it generates.</para>
+          <indexterm zone="qt qmake">
+            <primary sortas="b-qmake">qmake</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="qtconfig">
+        <term><command>qtconfig</command></term>
+        <listitem>
+          <para>is used to customize the appearance of Qt applications.</para>
+          <indexterm zone="qt qtconfig">
+            <primary sortas="b-qtconfig">qtconfig</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="uic">
+        <term><command>uic</command></term>
+        <listitem>
+          <para>is a Qt user interface compiler.</para>
+          <indexterm zone="qt uic">
+            <primary sortas="b-uic">uic</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>

Modified: trunk/BOOK/general/genlib/libarchive.xml
==============================================================================
--- trunk/BOOK/general/genlib/libarchive.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/general/genlib/libarchive.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -34,7 +34,7 @@
       interface for reading/writing various compression formats.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/general/genlib/lzo.xml
==============================================================================
--- trunk/BOOK/general/genlib/lzo.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/general/genlib/lzo.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -35,7 +35,7 @@
       real-time. This means it favors speed over compression ratio.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/general/graphlib/lcms.xml
==============================================================================
--- trunk/BOOK/general/graphlib/lcms.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/general/graphlib/lcms.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -32,7 +32,7 @@
     <para>The <application>Little CMS</application> library is used by other
     programs to provide color management facilities.</para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/general/graphlib/libmng.xml
==============================================================================
--- trunk/BOOK/general/graphlib/libmng.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/general/graphlib/libmng.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -33,7 +33,7 @@
     programs wanting to read and write Multiple-image Network Graphics
     (MNG) files which are the animation equivalents to PNG files.</para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/general/graphlib/openjpeg.xml
==============================================================================
--- trunk/BOOK/general/graphlib/openjpeg.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/general/graphlib/openjpeg.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -33,7 +33,7 @@
     of the JPEG-2000 standard. OpenJPEG fully respects the JPEG-2000 specifications
     and can compress/decompress lossless 16-bit images.</para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/general/prog/cmake.xml
==============================================================================
--- trunk/BOOK/general/prog/cmake.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/general/prog/cmake.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -38,7 +38,7 @@
       since version 4.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/audioutils/cdparanoia.xml
==============================================================================
--- trunk/BOOK/multimedia/audioutils/cdparanoia.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/audioutils/cdparanoia.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -36,7 +36,7 @@
       Practically all drives supported by Linux can be used.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/audioutils/mpg123.xml
==============================================================================
--- trunk/BOOK/multimedia/audioutils/mpg123.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/audioutils/mpg123.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -34,7 +34,7 @@
       player. It claims to be the fastest MP3 decoder for Unix.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/libdriv/faac.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/faac.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/libdriv/faac.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -35,7 +35,7 @@
     producing files that can be played back on iPod. Moreover, iPod does not
     understand other sound compression schemes in video files.</para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/libdriv/faad2.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/faad2.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/libdriv/faad2.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -33,7 +33,7 @@
     compression scheme specified in MPEG-2 Part 7 and MPEG-4 Part 3 standards
     and known as Advanced Audio Coding (AAC).</para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/libdriv/gst10-plugins-base.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/gst10-plugins-base.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/libdriv/gst10-plugins-base.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -39,7 +39,7 @@
       applications to function properly.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     &gst-compat;
 

Modified: trunk/BOOK/multimedia/libdriv/libmpeg2.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/libmpeg2.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/libdriv/libmpeg2.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -36,7 +36,7 @@
     This is useful for programs and applications needing to decode MPEG-2 and
     MPEG-1 video streams.</para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/libdriv/libtheora.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/libtheora.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/libdriv/libtheora.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -94,12 +94,14 @@
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-    <para>If you built the examples and wish to install them (so that you can hack on
-    <literal>theora</literal>):</para>
+    <para>If you wish to install the examples (so that you can hack on
+    <literal>theora</literal>), install them as the <systemitem
+    class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>cd examples/.libs &&
 for E in *; do
-install -v -m755 $E /usr/bin/theora_${E}; done</userinput></screen>
+  install -v -m755 $E /usr/bin/theora_${E}
+done</userinput></screen>
 
   </sect2>
 

Modified: trunk/BOOK/multimedia/libdriv/taglib.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/taglib.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/libdriv/taglib.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -36,7 +36,7 @@
       <application>VLC</application>.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/libdriv/xvid.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/xvid.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/libdriv/xvid.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -32,7 +32,7 @@
     <para><application>XviD</application> is an MPEG-4
     compliant video CODEC.</para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/multimedia.xml
==============================================================================
--- trunk/BOOK/multimedia/multimedia.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/multimedia/multimedia.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -16,7 +16,6 @@
   <title>Multimedia</title>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libdriv/libdriv.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="hwaccel/hwaccel.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="audioutils/audioutils.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="videoutils/videoutils.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cdwriteutils/cdwriteutils.xml"/>

Copied and modified: trunk/BOOK/x/installing/libva.xml (from r11677, trunk/BOOK/multimedia/hwaccel/libva.xml)
==============================================================================
--- trunk/BOOK/multimedia/hwaccel/libva.xml	Fri Aug 23 04:37:46 2013	(r11677, copy source)
+++ trunk/BOOK/x/installing/libva.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -21,13 +21,12 @@
   <!ENTITY libva-intel-driver-time          "0.1 SBU">
 ]>
 
-<sect1 id="libva" xreflabel="libva-&libva-version;">
-  <?dbhtml filename="libva.html"?>
+<sect2 id="libva" xreflabel="libva-&libva-version;">
 
-  <sect1info>
+  <sect2info>
     <othername>$LastChangedBy$</othername>
     <date>$Date$</date>
-  </sect1info>
+  </sect2info>
 
   <title>libva-&libva-version;</title>
 
@@ -35,19 +34,25 @@
     <primary sortas="a-libva">libva</primary>
   </indexterm>
 
-  <sect2 role="package">
+  <sect3 role="package">
     <title>Introduction to libva</title>
 
-    <para>
-      The <application>libva</application> package contains a library which
-      provides access to hardware accelerated video processing, using hardware
-      to accelerate video processing in order to offload the central processing
-      unit (CPU) to decode and encode compressed digital video.
+    <para> 
+       The <application>libva</application> package contains a library which
+       provides access to hardware accelerated video processing, using hardware
+       to accelerate video processing in order to offload the central
+       processing unit (CPU) to decode and encode compressed digital video.  VA
+       API video decode/encode interface is platform and window system
+       independent targeted at Direct Rendering Infrastructure (DRI) in the X
+       Window System however it can potentially also be used with direct
+       framebuffer and graphics sub-systems for video output. Accelerated
+       processing includes support for video decoding, video encoding,
+       subpicture blending, and rendering.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
-    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <bridgehead renderas="sect4">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
         <para>
@@ -81,7 +86,7 @@
       </listitem>
     </itemizedlist>
 
-    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <bridgehead renderas="sect4">Additional Downloads</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
         <para>
@@ -115,14 +120,14 @@
       </listitem>
     </itemizedlist>
 
-    <bridgehead renderas="sect3">libva Dependencies</bridgehead>
+    <bridgehead renderas="sect4">libva Dependencies</bridgehead>
 
-    <bridgehead renderas="sect4">Required</bridgehead>
+    <bridgehead renderas="sect5">Required</bridgehead>
     <para role="required">
       <xref linkend="mesalib"/>
     </para>
 
-    <bridgehead renderas="sect4">Optional</bridgehead>
+    <bridgehead renderas="sect5">Optional</bridgehead>
     <para role="optional">
       <xref linkend="doxygen"/> and
       <ulink url="http://wayland.freedesktop.org/">Wayland</ulink>
@@ -131,9 +136,9 @@
     <para condition="html" role="usernotes">
       User Notes: <ulink url="&blfs-wiki;/libva"/>
     </para>
-  </sect2>
+  </sect3>
 
-  <sect2 role="installation">
+  <sect3 role="installation">
     <title>Installation of libva</title>
 
     <para>
@@ -141,7 +146,7 @@
       commands:
     </para>
 
-<screen><userinput>./configure --prefix=/usr &&
+<screen><userinput>./configure $XORG_CONFIG &&
 make</userinput></screen>
 
     <para>
@@ -154,17 +159,18 @@
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-  </sect2>
+  </sect3>
 
-  <sect2 role="installation">
+  <sect3 role="installation">
     <title>Installation of libva-intel-driver</title>
 
     <para>
-      Install <application>libva-intel-driver</application> by running the
-      following commands:
+      The <application>libva-intel-driver</application> is designed 
+      specifically for video cards based on an Intel GPU.  
+      Install the driver by running the following commands:
     </para>
 
-<screen><userinput>./configure --prefix=/usr &&
+<screen><userinput>./configure $XORG_CONFIG &&
 make</userinput></screen>
 
     <para>
@@ -177,9 +183,9 @@
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-  </sect2>
+  </sect3>
 
-  <sect2 role="content">
+  <sect3 role="content">
     <title>Contents</title>
 
     <segmentedlist>
@@ -226,6 +232,6 @@
 
     </variablelist>
 
-  </sect2>
+  </sect3>
 
-</sect1>
+</sect2>

Copied and modified: trunk/BOOK/x/installing/libvdpau.xml (from r11677, trunk/BOOK/multimedia/hwaccel/libvdpau.xml)
==============================================================================
--- trunk/BOOK/multimedia/hwaccel/libvdpau.xml	Fri Aug 23 04:37:46 2013	(r11677, copy source)
+++ trunk/BOOK/x/installing/libvdpau.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -12,13 +12,12 @@
   <!ENTITY libvdpau-time          "0.1 SBU">
 ]>
 
-<sect1 id="libvdpau" xreflabel="libvdpau-&libvdpau-version;">
-  <?dbhtml filename="libvdpau.html"?>
+<sect2 id="libvdpau" xreflabel="libvdpau-&libvdpau-version;">
 
-  <sect1info>
+  <sect2info>
     <othername>$LastChangedBy$</othername>
     <date>$Date$</date>
-  </sect1info>
+  </sect2info>
 
   <title>libvdpau-&libvdpau-version;</title>
 
@@ -26,18 +25,38 @@
     <primary sortas="a-libvdpau">libvdpau</primary>
   </indexterm>
 
-  <sect2 role="package">
+  <sect3 role="package">
     <title>Introduction to libvdpau</title>
 
     <para>
       The <application>libvdpau</application> package contains a library which
-      allows video programs to offload portions of the video decoding process
-      and video post-processing to the GPU video-hardware.
+      implements the VDPAU library.
+    </para>
+      
+    <para>
+      VDPAU (Video Decode and Presentation API for Unix) is an open source
+      library (libvdpau) and API originally designed by Nvidia for its GeForce
+      8 series and later GPU hardware,[1][2] targeted at the X Window System
+      This VDPAU API allows video programs to offload portions of the video
+      decoding process and video post-processing to the GPU video-hardware.
+   </para>
+
+   <para>
+      Currently, the portions capable of being offloaded by VDPAU onto the GPU
+      are motion compensation (mo comp), inverse discrete cosine transform
+      (iDCT), VLD (variable-length decoding) and deblocking for MPEG-1, MPEG-2,
+      MPEG-4 ASP (MPEG-4 Part 2), H.264/MPEG-4 AVC and VC-1, WMV3/WMV9 encoded
+      videos.  Which specific codecs of these that can be offloaded to the
+      GPU depends on the version of the GPU hardware; specifically,
+      to also decode MPEG-4 ASP (MPEG-4 Part 2), Xvid/OpenDivX (DivX 4), and
+      DivX 5 formats, a GeForce 200M (2xxM) Series (the eleventh generation of
+      Nvidia's GeForce graphics processing units) or newer GPU hardware is
+      required.
     </para>
 
-    &lfs73_checked;
+    &lfs74_checked;
 
-    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <bridgehead renderas="sect4">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
         <para>
@@ -71,21 +90,21 @@
       </listitem>
     </itemizedlist>
 
-    <bridgehead renderas="sect3">libvdpau Dependencies</bridgehead>
+    <bridgehead renderas="sect4">libvdpau Dependencies</bridgehead>
 
-    <bridgehead renderas="sect4">Required</bridgehead>
+    <bridgehead renderas="sect5">Required</bridgehead>
     <para role="required">
       <xref linkend="xorg7-lib"/>
     </para>
 
-    <bridgehead renderas="sect4">Optional</bridgehead>
+    <bridgehead renderas="sect5">Optional</bridgehead>
     <para role="optional">
       <xref linkend="doxygen"/>,
       <xref linkend="graphviz"/> and
       <xref linkend="texlive"/>
     </para>
 
-    <bridgehead renderas="sect4">Runtime Dependency</bridgehead>
+    <bridgehead renderas="sect5">Runtime Dependency</bridgehead>
     <para role="optional">
       <xref linkend="mesalib"/>
     </para>
@@ -93,9 +112,9 @@
     <para condition="html" role="usernotes">
       User Notes: <ulink url="&blfs-wiki;/libvdpau"/>
     </para>
-  </sect2>
+  </sect3>
 
-  <sect2 role="installation">
+  <sect3 role="installation">
     <title>Installation of libvdpau</title>
 
     <para>
@@ -103,7 +122,7 @@
       commands:
     </para>
 
-<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &&
+<screen><userinput>./configure $XORG_CONFIG &&
 make</userinput></screen>
 
     <para>
@@ -116,9 +135,9 @@
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-  </sect2>
+  </sect3>
 
-  <sect2 role="content">
+  <sect3 role="content">
     <title>Contents</title>
 
     <segmentedlist>
@@ -160,6 +179,6 @@
 
     </variablelist>
 
-  </sect2>
+  </sect3>
 
-</sect1>
+</sect2>

Modified: trunk/BOOK/x/installing/x7driver.xml
==============================================================================
--- trunk/BOOK/x/installing/x7driver.xml	Fri Aug 23 13:05:56 2013	(r11679)
+++ trunk/BOOK/x/installing/x7driver.xml	Fri Aug 23 13:56:44 2013	(r11680)
@@ -160,6 +160,24 @@
 
     </sect3>
 
+    <sect3 id="hw-video-acceleration">
+      <title>Hardware Video Acceleration</title>
+
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            <xref linkend="libva"/>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            <xref linkend="libvdpau"/>
+          </para>
+        </listitem> 
+      </itemizedlist>
+
+    </sect3>
+
   </sect2>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
@@ -219,4 +237,10 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     href="x7driver-vmware.xml"/>
 
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+    href="libva.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+    href="libvdpau.xml"/>
+
 </sect1>



More information about the blfs-book mailing list