[blfs-book] r10377 - in trunk/BOOK: introduction/welcome xsoft/other

ken at linuxfromscratch.org ken at linuxfromscratch.org
Fri Jun 29 16:08:24 PDT 2012


Author: ken
Date: 2012-06-29 17:08:20 -0600 (Fri, 29 Jun 2012)
New Revision: 10377

Modified:
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/xsoft/other/gimp.xml
Log:
gimp-help-2.8.0

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2012-06-29 19:40:09 UTC (rev 10376)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2012-06-29 23:08:20 UTC (rev 10377)
@@ -52,6 +52,10 @@
           <para>[rthomsen] - Upgrade to UPower 0.9.17.
           Fixes <ulink url="&blfs-ticket-root;3437">#3437</ulink>.</para>
         </listitem>
+        <listitem>
+          <para>[ken] - Updated gimp-help to 2.8.0. Fixes <ulink
+          url="&blfs-ticket-root;3443">#3443</ulink>.</para>
+        </listitem>
       </itemizedlist>
     </listitem>
 

Modified: trunk/BOOK/xsoft/other/gimp.xml
===================================================================
--- trunk/BOOK/xsoft/other/gimp.xml	2012-06-29 19:40:09 UTC (rev 10376)
+++ trunk/BOOK/xsoft/other/gimp.xml	2012-06-29 23:08:20 UTC (rev 10377)
@@ -8,13 +8,13 @@
   <!ENTITY gimp-download-ftp  "ftp://ftp.gimp.org/pub/gimp/v2.8/gimp-&gimp-version;.tar.bz2">
   <!ENTITY gimp-md5sum        "28997d14055f15db063eb92e1c8a7ebb">
   <!ENTITY gimp-size          "20 MB">
-  <!ENTITY gimp-buildsize     "607 MB (additonal 579 MB to run the test suite, additional 78 MB to install help files)">
-  <!ENTITY gimp-time          "4.9 SBU (additional 0.9 SBU to run the test suite)">
+  <!ENTITY gimp-buildsize     "607 MB (additonal 579 MB to run the test suite, the help files add from 267 MB (en only) to 1.3 GB (all), typically increasing by 60 MB per translation)">
+  <!ENTITY gimp-time          "4.9 SBU (additional 0.9 SBU to run the test suite, for the help files from 0.7 SBU (en only) to 29 SBU (all) - typically 1.5 SBU per translation)">
 
-  <!ENTITY gimp-help-version  "2.6.0-html-en">
+  <!ENTITY gimp-help-version  "2.8.0">
   <!ENTITY gimp-help-download "ftp://gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">
-  <!ENTITY gimp-help-md5sum   "81da262343316835ebdd3354ce8eab4f">
-  <!ENTITY gimp-help-size     "28 MB">
+  <!ENTITY gimp-help-md5sum   "d6e07a569fe4b3bb11aaf5630da2693b">
+  <!ENTITY gimp-help-size     "127 MB">
 ]>
 
 <sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
@@ -65,9 +65,7 @@
     <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Optional help files: <ulink url="&gimp-help-download;"/> or one
-        of the other available languages - see <ulink
-        url="http://www.gimp.org/docs">gimp.org</ulink> for details.</para>
+        <para>Optional help files: <ulink url="&gimp-help-download;"/></para>
       </listitem>
       <listitem>
         <para>Download MD5 sum: &gimp-help-md5sum;</para>
@@ -75,6 +73,17 @@
       <listitem>
         <para>Download size: &gimp-help-size;</para>
       </listitem>
+      <listitem>
+        <para>Optional compressed patch for the help files: <ulink
+        url="&patch-root;/gimp-help-&gimp-help-version;-build_fixes-1.patch"/>
+        (to build the catalan translations)</para>
+      </listitem>
+      <listitem>
+        <para>Compressed Patch MD5 sum: 5312793a67132131a6e3360e76f392e4</para>
+      </listitem>
+      <listitem>
+        <para>Compressed Patch size: 486 KB</para>
+      </listitem>
     </itemizedlist>
 
     <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
@@ -115,6 +124,12 @@
     <application>Gimp</application> to use it to create its help browser)
     and <xref linkend="gtk-doc"/></para>
 
+    <bridgehead renderas="sect4">Optional, for the help files</bridgehead>
+    <para role="optional">
+    <ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
+    <ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
+    </para>
+
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/gimp"/></para>
   </sect2>
@@ -136,24 +151,51 @@
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-    <para>The <filename>gimp-help</filename> tarball contains preformatted HTML
-    for use with external web browsers, the internal
-    <application>Gimp</application> help browser, and HTML renderers. Some of
-    the details have changed in <application>gimp-2.8</application>, but much of
-    this is still relevant. Please also consult
-    <ulink url="http://www.gimp.org/release-notes/gimp-2.8.html"/>.</para>
+    <para>The <filename>gimp-help</filename> tarball contains images and English
+    text help for help files, together with translations. It is
+    "work in progress".</para>
 
     <para>If you downloaded the <filename>gimp-help</filename> tarball, unpack
-    it and change into the root of the newly created source tree. Issue the
-    following commands as the <systemitem class="username">root</systemitem>
-    user to install the help files:</para>
+    it and change into the root of the newly created source tree. This release
+    fails to build for its first language, catalan ("ca") but those
+    who wish to build the remaining languages can prepare for the build with the
+    following command:</para>
+<screen><userinput>ALL_LINGUAS="da de el en en_GB es fi fr hr it ja ko lt nl nn pl ru sl sv zh_CN" \
+./configure --prefix=/usr &&</userinput></screen>
 
-<screen role="root"><userinput>make install</userinput></screen>
+    <para>Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
+    you do not wish to install.</para>
+
+    <para>Alternatively, if you wish to build languages including catalan,
+    apply the patch:</para>
+
+<screen role="nodump"><userinput>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz \
+ | patch -p1 &&
+./autogen.sh --prefix=/usr &&</userinput></screen>
+
+    <para>Again, you can specify a subset of languages by specifying
+    <envar>ALL_LINGUAS</envar> in front of <command>./autogen.sh</command>, but
+    this time including "ca".</para>
+
+    <para>Now build the help files:</para>
+<screen><userinput>make</userinput></screen>
+
+    <para> Issue the following commands as the
+    <systemitem class="username">root</systemitem> user to install the help
+    files:</para>
+
+<screen role="root"><userinput>make install &&
+chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
+
   </sect2>
 
   <sect2 role="commands" id="gimp-cmd-explanations">
     <title>Command Explanations</title>
 
+    <para><command>LINGUAS="ca da de en en_GB ..."</command>: by
+    default, the help files will be rendered in all the available languages.
+    Remove the codes of any languages you do not wish to build.</para>
+
     <para><parameter>--without-gvfs</parameter>: the choice of the backend to
     handle URI information, e.g. when dragging images from a browser into the
     <application>gimp</application>, is made at compile time.  This parameter will
@@ -174,6 +216,17 @@
     <para><option>--disable-python</option>: This option is necessary if
     you have not installed <application>pygtk</application>.</para>
 
+    <para><option>./autogen.sh --prefix=/usr</option>: in this case, using
+    <command>autoreconf</command> to regenerate <filename>configure</filename>
+    does not work, because of how the gimp-help developers chose to address
+    problems with the autotools.</para>
+
+    <para><option>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz</option>:
+    this patch is large, so it has been compressed with
+    <application>xz</application>.  You are encouraged to be suspicious of
+    all patches until you have looked at them. You use <command>view</command>
+    to read the compressed patch before you apply it.</para>
+
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     href="../../xincludes/gtk-doc-rebuild.xml"/>
   </sect2>




More information about the blfs-book mailing list