Changeset 9c105eb

Timestamp:

08/22/2018 08:54:35 PM (6 years ago)

Author:

Ken Moffat <ken@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

0299ce4

Parents:

3ffdac24

Message:

New gimp-help snapshot, but note that building it lost links to some images between BLFS-8.1 and BLFS-8.2, so prefer the online help.

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

Files:

• general/prog/perl-modules.xml (modified) (3 diffs)
• introduction/welcome/changelog.xml (modified) (1 diff)
• xsoft/other/gimp.xml (modified) (7 diffs)

general/prog/perl-modules.xml

@@ -157 +157 @@
 
  Also, for external modules where we link to CPAN without a current version,
- prefer to use http://search.cpan.org/dist/Module-Name if that works, rather
- than pointing to a maintainers home directory : the maintainer for a package
- sometimes changes.  Also,  use '-' rather than '::'  because '-' will go
- directly to the page instead of providing a list of possible matches.
+ prefer to go to https://metacpan.org/, find the module and link to it.
 
  Where a dependency is used by multiple other modules on this page, but not by
@@ -215 +212 @@
       using the CPAN automated install you should check when the current version
       was released. If it is recent you should review its 'Changes' and
-      'Dependencies' links at http://search.cpan.org in case the dependencies
-      have altered.</para>
+      'Dependencies' links at http://metacpan.org in case the dependencies
+      have altered. The BLFS editors cannot keep the details of these 'external'
+      modules up to date, some change frequently. But the links below go to
+      specific versions which are known to build with BLFS-8.3</para>
     </note>
 
@@ -245 +244 @@
 MD5 sum: &Archive-Zip-md5sum;</literallayout>
         <itemizedlist>
-          <listitem><literallayout><ulink url="http://search.cpan.org/dist/Test-MockModule/">Test::MockModule</ulink> - This uses the <xref linkend="perl-build-install"/>
-(http://search.cpan.org/dist/Test-MockModule/)</literallayout>
+          <listitem><literallayout><ulink url="https://cpan.metacpan.org/authors/id/G/GF/GFRANKS/Test-MockModule-0.15.tar.gz">Test::MockModule</ulink> - This uses the <xref linkend="perl-build-install"/>
+(https://cpan.metacpan.org/authors/id/G/GF/GFRANKS/Test-MockModule-0.15.tar.gz)</literallayout>
             <itemizedlist>
               <listitem> <literallayout><ulink url="http://search.cpan.org/dist/SUPER/">SUPER</ulink>

introduction/welcome/changelog.xml

@@ -45 +45 @@
       <para>August 22nd, 2018</para>
       <itemizedlist>
+        <listitem>
+          <para>[ken] - gimp-help: recommend gvfs to access online help,
+          use new snapshot for local help but explain the issues. Addresses
+          <ulink url="&blfs-ticket-root;11007">#11007</ulink>.</para>
+        </listitem>
         <listitem>
           <para>[bdubbs] - Update to plasma-5.13.4. Fixes

xsoft/other/gimp.xml

@@ -14 +14 @@
   <!-- pro-tem, a pull of gimp-help, https://gitlab.gnome.org/GNOME/gimp-help.git
   git archive \-\-format=tar \-\-prefix=${DIRNAME}/ HEAD | xz >../${DIRNAME}.tar.xz -->
-  <!ENTITY gimp-help-version    "2018-05-19-f8fb93ed2">
-  <!ENTITY gimp-help-download   "http://www.zarniwhoop.uk/gimp-help/gimp-help-&gimp-help-version;.tar.xz">
-  <!ENTITY gimp-help-md5sum     "f420eccb087d797936738b62e066e0a6">
-  <!ENTITY gimp-help-size       "159 MB">
-  <!ENTITY gimp-help-buildsize  "From 350 MB (en only) to 1429 MB (all 18
-                                 languages), average of 52 MB per translation">
-  <!ENTITY gimp-help-time       "1.9 SBU (en only), average of 2.4 SBU per
-                                 translation (measured with 5 languages), 14
-                                 SBU, with parallelism=4, for all languages">
+  <!ENTITY gimp-help-version    "2018-08-21">
+  <!ENTITY gimp-help-download   "&sources-anduin-http;/gimp-help-&gimp-help-version;.tar.xz">
+  <!ENTITY gimp-help-md5sum     "4557d7450f0867b4a55190e6525065dc">
+  <!ENTITY gimp-help-size       "172 MB">
+  <!ENTITY gimp-help-buildsize  "From 352 MB (en only) to 1.6 GB (all 18
+                                 languages)">
+  <!ENTITY gimp-help-time       "1.9 SBU (en only), 13 SBU, with parallelism=4,
+                                 for all languages">
 ]>
 <!--
@@ -98 +97 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>
-          The optional help files for 2.10 are still being updated. In the
-          meantime, here is a git pull:
+        <note>
+          <para>
+           The creation of local html files with recent versions of the necessary
+           packages is somewhat broken (some png images are not sourced by the
+           generated HTML, only their captions are visible).
+          </para>
+        </note>
+        <para>
+          The updating of the help files is still WIP, with large parts of the
+          text for many languages not yet translated. Here is a git pull:
           <ulink url="&gimp-help-download;"/>
         </para>
@@ -106 +112 @@
       <listitem>
         <para>
-          The downloads may have been updated since this version of the
-          book was committed. For the gimp-help-&gimp-help-version; tarball,
-          the MD5 sum is: &gimp-help-md5sum; and other sums may be in the <ulink
-          url="http://www.zarniwhoop.uk/gimp-help/README">README</ulink> file in
-          the same directory.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
           Download size: &gimp-help-size;
+        </para>
+        <para>
+          Download md5sum: &gimp-help-md5sum;
         </para>
       </listitem>
@@ -156 +156 @@
       <xref linkend="dbus-glib"/>,
       <xref linkend="gs"/> (with libgs installed),
+      <xref linkend="gvfs"/> (to access the online help),
       <xref linkend="iso-codes"/>,
       <xref linkend="libgudev"/>,
@@ -166 +167 @@
       <xref linkend="aalib"/>,
       <xref linkend="alsa-lib"/>,
-      <xref linkend="gvfs"/> (to access the online help),
       <xref linkend="libmng"/>,
       <xref linkend="libwebp"/>,
@@ -183 +183 @@
     </para>
 
-    <bridgehead renderas="sect4">Optional, for optimizing the PNG files in the
-    help system</bridgehead>
+    <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
     <para role="optional">
+      <ulink url="http://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
       <ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
       <ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
+      to optimize the png files, but see the note on the help download above
     </para>
 
@@ -229 +230 @@
     <para>
       The <filename>gimp-help</filename> tarball contains images and English
-      text help for help files, together with translations.
-    </para>
-
-    <para>
-      If you downloaded the <filename>gimp-help</filename> tarball, unpack
-      it and change into the root of the newly created source tree. Prepare for
+      text help for help files, together with translations. Because of the
+      issues mentioned in the note above, you are recommended to use the online
+      help, either by building against <xref linkend="gvfs"/> so that 'help'
+      can open the latest XML files in your browser, or else you can manually
+      open the html in your browser by going to <ulink
+      url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
+      (change the language code if desired).
+    </para>
+
+    <para>
+      If you nevertheless wish to install local copies of the help files to read
+      offline, unpack the <filename>gimp-help</filename> tarball
+      and change into the root of the newly created source tree. Prepare for
       the build with the following command:
     </para>
 
-<screen><userinput>ALL_LINGUAS=&quot;ca da de el en en_GB es fi fr it ja ko nl nn pt_BR ru zh_CN&quot; \
+<screen><userinput>ALL_LINGUAS=&quot;ca da de el en en_GB es fi fr it ja ko nl nn pt_BR ro ru zh_CN&quot; \
 ./autogen.sh --prefix=/usr &amp;&amp;</userinput></screen>