Author: andy
Date: 2012-05-01 11:27:02 -0600 (Tue, 01 May 2012)
New Revision: 10048

Modified:
   trunk/BOOK/x/lib/gdk-pixbuf.xml
Log:
Made Xorg Libs a recommended dep of Gdk-Pixbuf

Modified: trunk/BOOK/x/lib/gdk-pixbuf.xml
===================================================================
--- trunk/BOOK/x/lib/gdk-pixbuf.xml     2012-05-01 17:10:16 UTC (rev 10047)
+++ trunk/BOOK/x/lib/gdk-pixbuf.xml     2012-05-01 17:27:02 UTC (rev 10048)
@@ -4,8 +4,10 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-  <!ENTITY gdk-pixbuf-download-http 
"&gnome-download-http;/gdk-pixbuf/2.26/gdk-pixbuf-&gdk-pixbuf-version;.tar.xz">
-  <!ENTITY gdk-pixbuf-download-ftp  
"&gnome-download-ftp;/gdk-pixbuf/2.26/gdk-pixbuf-&gdk-pixbuf-version;.tar.xz">
+  <!ENTITY gdk-pixbuf-download-http 
+    
"&gnome-download-http;/gdk-pixbuf/2.26/gdk-pixbuf-&gdk-pixbuf-version;.tar.xz">
+  <!ENTITY gdk-pixbuf-download-ftp  
+    
"&gnome-download-ftp;/gdk-pixbuf/2.26/gdk-pixbuf-&gdk-pixbuf-version;.tar.xz">
   <!ENTITY gdk-pixbuf-md5sum        "82197921c651a81ae28178aa9adfc0e6">
   <!ENTITY gdk-pixbuf-size          "1.2 MB">
   <!ENTITY gdk-pixbuf-buildsize     "25 MB">
@@ -27,50 +29,70 @@
   </indexterm>
 
   <sect2 role="package">
-    <title>Introduction to gdk-pixbuf</title>
+    <title>Introduction to Gdk-Pixbuf</title>
 
-    <para>The <application>gdk-pixbuf</application> library is a toolkit for
-    image loading and pixel buffer manipulation. It is used by gtk+-2 and
-    gtk+-3 to load and manipulate images. In the past it was distributed as
-    part of gtk+-2 but it was split off into a separate package in preparation
-    for the change to gtk+-3.</para>
+    <para>
+      The <application>Gdk-Pixbuf</application> library is a toolkit for image
+      loading and pixel buffer manipulation. It is used by
+      <application>Gtk 2</application> and <application>Gtk 3</application> to
+      load and manipulate images. In the past it was distributed as part of
+      <application>Gtk 2</application> but it was split off into a separate
+      package in preparation for the change to <application>Gtk 
3</application>.
+    </para>
 
     &lfs71_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&gdk-pixbuf-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&gdk-pixbuf-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&gdk-pixbuf-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&gdk-pixbuf-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &gdk-pixbuf-md5sum;</para>
+        <para>
+          Download MD5 sum: &gdk-pixbuf-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &gdk-pixbuf-size;</para>
+        <para>
+          Download size: &gdk-pixbuf-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &gdk-pixbuf-buildsize;</para>
+        <para>
+          Estimated disk space required: &gdk-pixbuf-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &gdk-pixbuf-time;</para>
+        <para>
+          Estimated build time: &gdk-pixbuf-time;
+        </para>
       </listitem>
     </itemizedlist>
 
-    <bridgehead renderas="sect3">gdk-pixbuf Dependencies</bridgehead>
+    <bridgehead renderas="sect3">Gdk-Pixbuf Dependencies</bridgehead>
 
-    <!-- Whole package is useless without jpeg, png and tiff loaders. -->
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
       <xref linkend="libjpeg"/>,
       <xref linkend="libpng"/>,
-      <xref linkend="libtiff"/>,
-      <xref linkend="pkgconfig"/> and
-      <xref linkend="xorg7-lib"/>
+      <xref linkend="libtiff"/> and
+      <xref linkend="pkgconfig"/>.
     </para>
 
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended">
+      <xref linkend="xorg7-lib"/>. <emphasis>Many</emphasis>
+      <application>Gtk</application> applications <emphasis>require</emphasis>
+      gdk-pixbuf-xlib.
+    </para>
+
     <bridgehead renderas="sect4">Optional (Required if building 
GNOME)</bridgehead>
     <para role="optional">
       <xref linkend="gobject-introspection"/>
@@ -82,42 +104,51 @@
       <xref linkend="gtk-doc"/>
     </para>
 
-    <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gdk-pixbuf"/></para>
-
+    <para condition="html" role="usernotes">
+      User Notes: <ulink url="&blfs-wiki;/gdk-pixbuf"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
-    <title>Installation of gdk-pixbuf</title>
+    <title>Installation of Gdk-Pixbuf</title>
 
-    <para>Install <application>gdk-pixbuf</application> by running the
-    following commands:</para>
+    <para>
+      Install <application>Gdk-Pixbuf</application> by running the following
+      commands:
+    </para>
 
 <screen><userinput>./configure --prefix=/usr --with-x11 &amp;&amp;
 make</userinput></screen>
 
-    <para>To test the results, issue: <command>make check</command>.</para>
+    <para>
+      To test the results, issue: <command>make check</command>.
+    </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>
-
   </sect2>
 
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><option>--with-x11</option>: This switch enables building of
-    gdk-pixbuf x11 library which is needed for some packages.</para>
+    <para>
+      <option>--with-x11</option>: This switch enables building of the
+      <application>Gdk-Pixbuf</application> <application>X11</application>
+      library which is needed for <emphasis>many</emphasis> packages.
+    </para>
 
-    <para><option>--with-libjasper</option>: If you've installed
-    <xref linkend="jasper"/> and you want gdk-pixbuf to use it to compile a
-    JPEG2000 image loader, pass this option to configure.</para>
+    <para>
+      <option>--with-libjasper</option>: If you've installed
+      <xref linkend="jasper"/> and you want
+      <application>Gdk-Pixbuf</application> to use it to compile a JPEG2000
+      image loader, pass this option to configure.
+    </para>
 
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="../../xincludes/gtk-doc-rebuild.xml"/>
-
   </sect2>
 
   <sect2 role="content">
@@ -130,14 +161,18 @@
 
       <seglistitem>
         <seg>
-          gdk-pixbuf-csource, gdk-pixbuf-pixdata and gdk-pixbuf-query-loaders
+          gdk-pixbuf-csource,
+          gdk-pixbuf-pixdata and
+          gdk-pixbuf-query-loaders.
         </seg>
         <seg>
-          libgdk_pixbuf-2.0.so and libgdk_pixbuf_xlib-2.0.so
+          libgdk_pixbuf-2.0.so and
+          libgdk_pixbuf_xlib-2.0.so.
         </seg>
         <seg>
-          /usr/include/gdk-pixbuf-2.0, /usr/lib/gdk-pixbuf-2.0 and
-          /usr/share/gtk-doc/html/gdk-pixbuf
+          /usr/include/gdk-pixbuf-2.0,
+          /usr/lib/gdk-pixbuf-2.0 and
+          /usr/share/gtk-doc/html/gdk-pixbuf.
         </seg>
       </seglistitem>
     </segmentedlist>
@@ -150,8 +185,10 @@
       <varlistentry id="gdk-pixbuf-csource">
         <term><command>gdk-pixbuf-csource</command></term>
         <listitem>
-          <para>is a small utility that generates C code containing images,
-          used for compiling images directly into programs.</para>
+          <para>
+            is a small utility that generates C code containing images, used
+            for compiling images directly into programs.
+          </para>
           <indexterm zone="gdk-pixbuf gdk-pixbuf-csource">
             <primary sortas="b-gdk-pixbuf-csource">gdk-pixbuf-csource</primary>
           </indexterm>
@@ -161,8 +198,10 @@
       <varlistentry id="gdk-pixbuf-query-loaders">
         <term><command>gdk-pixbuf-query-loaders</command></term>
         <listitem>
-          <para>collects information about loadable modules for gdk-pixbuf and
-          writes it to the default cache file location, or to stdout.</para>
+          <para>
+            collects information about loadable modules for gdk-pixbuf and
+            writes it to the default cache file location, or to stdout.
+          </para>
           <indexterm zone="gdk-pixbuf gdk-pixbuf-query-loaders">
             <primary 
sortas="b-gdk-pixbuf-query-loaders">gdk-pixbuf-query-loaders</primary>
           </indexterm>
@@ -172,7 +211,9 @@
       <varlistentry id="libgdk_pixbuf-2.0">
         <term><filename 
class='libraryfile'>libgdk_pixbuf-2.0.so</filename></term>
         <listitem>
-          <para>contains functions that load and render images.</para>
+          <para>
+            contains functions that load and render images.
+          </para>
           <indexterm zone="gdk-pixbuf libgdk_pixbuf-2.0">
             <primary 
sortas="c-libgdk_pixbuf-2.0">libgdk_pixbuf-2.0.so</primary>
           </indexterm>
@@ -182,16 +223,15 @@
       <varlistentry id="libgdk_pixbuf_xlib-2.0">
         <term><filename 
class='libraryfile'>libgdk_pixbuf_xlib-2.0.so</filename></term>
         <listitem>
-          <para>contains functions that manipulate images and interfaces with
-          xlib.</para>
+          <para>
+            contains functions that manipulate images and interfaces with
+            <application>Xlib</application>.
+          </para>
           <indexterm zone="gdk-pixbuf libgdk_pixbuf_xlib-2.0">
             <primary 
sortas="c-libgdk_pixbuf_xlib-2.0">libgdk_pixbuf_xlib-2.0.so</primary>
           </indexterm>
         </listitem>
       </varlistentry>
-
     </variablelist>
-
   </sect2>
-
 </sect1>

-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to