Author: ken Date: Wed Aug 22 13:54:35 2018 New Revision: 20372 Log: 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.
Modified: trunk/BOOK/general/prog/perl-modules.xml trunk/BOOK/introduction/welcome/changelog.xml trunk/BOOK/xsoft/other/gimp.xml Modified: trunk/BOOK/general/prog/perl-modules.xml ============================================================================== --- trunk/BOOK/general/prog/perl-modules.xml Wed Aug 22 13:43:56 2018 (r20371) +++ trunk/BOOK/general/prog/perl-modules.xml Wed Aug 22 13:54:35 2018 (r20372) @@ -156,10 +156,7 @@ library, look at the comments in the code 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 packages elsewhere in the book, promote it to a top-level entry so that it can @@ -214,8 +211,10 @@ <para>For unversioned modules on this page, if you are building without 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> <!-- Archive::Zip --> @@ -244,8 +243,8 @@ <literallayout>&Archive-Zip-download-http; 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> (http://search.cpan.org/dist/SUPER/) (for the testsuite)</literallayout> Modified: trunk/BOOK/introduction/welcome/changelog.xml ============================================================================== --- trunk/BOOK/introduction/welcome/changelog.xml Wed Aug 22 13:43:56 2018 (r20371) +++ trunk/BOOK/introduction/welcome/changelog.xml Wed Aug 22 13:54:35 2018 (r20372) @@ -45,6 +45,11 @@ <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 <ulink url="&blfs-ticket-root;10859">#10859</ulink>.</para> </listitem> Modified: trunk/BOOK/xsoft/other/gimp.xml ============================================================================== --- trunk/BOOK/xsoft/other/gimp.xml Wed Aug 22 13:43:56 2018 (r20371) +++ trunk/BOOK/xsoft/other/gimp.xml Wed Aug 22 13:54:35 2018 (r20372) @@ -13,15 +13,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"> ]> <!-- <!ENTITY gimp-help-version "2.8.2"> @@ -97,24 +96,25 @@ <bridgehead renderas="sect3">Additional Downloads</bridgehead> <itemizedlist spacing="compact"> <listitem> + <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 optional help files for 2.10 are still being updated. In the - meantime, here is a git pull: + 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> </listitem> <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. + Download size: &gimp-help-size; </para> - </listitem> - <listitem> <para> - Download size: &gimp-help-size; + Download md5sum: &gimp-help-md5sum; </para> </listitem> <listitem> @@ -155,6 +155,7 @@ <para role="recommended"> <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"/>, <xref linkend="pygtk"/> (including the gtk, pango and pangocairo modules) and @@ -165,7 +166,6 @@ <para role="optional"> <xref linkend="aalib"/>, <xref linkend="alsa-lib"/>, - <xref linkend="gvfs"/> (to access the online help), <xref linkend="libmng"/>, <xref linkend="libwebp"/>, <xref linkend="openjpeg2"/>, @@ -182,11 +182,12 @@ on a modern system exposed to the internet. </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> <para condition="html" role="usernotes">User Notes: @@ -228,16 +229,23 @@ <para> The <filename>gimp-help</filename> tarball contains images and English - text help for help files, together with translations. + 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 downloaded the <filename>gimp-help</filename> tarball, unpack - it and change into the root of the newly created source tree. Prepare for + 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="ca da de el en en_GB es fi fr it ja ko nl nn pt_BR ru zh_CN" \ +<screen><userinput>ALL_LINGUAS="ca da de el en en_GB es fi fr it ja ko nl nn pt_BR ro ru zh_CN" \ ./autogen.sh --prefix=/usr &&</userinput></screen> <para> -- http://lists.linuxfromscratch.org/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page