Changeset 784ec394

Timestamp:

06/29/2012 11:08:20 PM (12 years ago)

Author:

Ken Moffat <ken@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

0b83a69

Parents:

69de635

Message:

gimp-help-2.8.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10377 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:

• introduction/welcome/changelog.xml (modified) (1 diff)
• xsoft/other/gimp.xml (modified) (6 diffs)

introduction/welcome/changelog.xml

@@ -53 +53 @@
           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>

xsoft/other/gimp.xml

@@ -9 +9 @@
   <!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-help-version  "2.6.0-html-en">
+  <!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.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">
 ]>
 
@@ -66 +66 @@
     <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>
@@ -75 +73 @@
       <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>
@@ -116 +125 @@
     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>
@@ -137 +152 @@
 <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
+    &quot;work in progress&quot;.</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>
-
-<screen role="root"><userinput>make install</userinput></screen>
+    it and change into the root of the newly created source tree. This release
+    fails to build for its first language, catalan (&quot;ca&quot;) but those
+    who wish to build the remaining languages can prepare for the build with the
+    following command:</para>
+<screen><userinput>ALL_LINGUAS=&quot;da de el en en_GB es fi fr hr it ja ko lt nl nn pl ru sl sv zh_CN&quot; \
+./configure --prefix=/usr &amp;&amp;</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 &amp;&amp;
+./autogen.sh --prefix=/usr &amp;&amp;</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 &quot;ca&quot;.</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 &amp;&amp;
+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=&quot;ca da de en en_GB ...&quot;</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
@@ -174 +216 @@
     <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"