mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-25 07:42:13 +08:00
3727a4c736
Update to gimp-2.10.14. Update to decorator-4.4.1. Update to telepathy-mission-control-5.16.5. git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22321 af4574ff-66df-0310-9fd7-8a98e5e911e0
559 lines
19 KiB
XML
559 lines
19 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!ENTITY gimp-download-http "https://download.gimp.org/pub/gimp/v2.10/gimp-&gimp-version;.tar.bz2">
|
|
<!ENTITY gimp-download-ftp " ">
|
|
<!ENTITY gimp-md5sum "a64f2be299755a2da130306cad9b1d26">
|
|
<!ENTITY gimp-size "31 MB">
|
|
<!ENTITY gimp-buildsize "1020 MB (194 MB installed, add 928 MB for tests)">
|
|
<!ENTITY gimp-time "2.7 SBU (Using parallelism=4; add 0.5 SBU for tests)">
|
|
|
|
<!-- 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 "2019-04-08">
|
|
<!ENTITY gimp-help-download "&sources-anduin-http;/gimp/gimp-help-&gimp-help-version;.tar.xz">
|
|
<!ENTITY gimp-help-md5sum "e334ebe7fd5e12350e6319c2e8c39141">
|
|
<!ENTITY gimp-help-size "166 MB">
|
|
<!ENTITY gimp-help-buildsize "From 310 MB (en only) to 1.6 GB (all 18
|
|
languages)">
|
|
<!ENTITY gimp-help-time "0.8 SBU (en only), 13 SBU, with parallelism=4,
|
|
for all languages">
|
|
]>
|
|
<!--
|
|
<!ENTITY gimp-help-version "2.8.2">
|
|
<!ENTITY gimp-help-download "https://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">
|
|
<!ENTITY gimp-help-md5sum "a591c8974b2f4f584d0a769d52ed6c5b">
|
|
<!ENTITY gimp-help-size "152 MB">
|
|
<!ENTITY gimp-help-buildsize "From 307 MB (en only) to 1257 MB (all 18
|
|
languages), average of 52 MB per translation">
|
|
<!ENTITY gimp-help-time "0.8 SBU (en only), average of 1.2 SBU per
|
|
translation (measured with 5 languages), 5.9
|
|
SBU, with parallelism=8, for all languages">
|
|
-->
|
|
|
|
<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
|
|
<?dbhtml filename="gimp.html" ?>
|
|
|
|
<sect1info>
|
|
<othername>$LastChangedBy$</othername>
|
|
<date>$Date$</date>
|
|
</sect1info>
|
|
|
|
<title>Gimp-&gimp-version;</title>
|
|
|
|
<indexterm zone="gimp">
|
|
<primary sortas="a-Gimp">Gimp</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to Gimp</title>
|
|
|
|
<para>
|
|
The <application>Gimp</application> package contains
|
|
the GNU Image Manipulation Program which is useful for
|
|
photo retouching, image composition and image authoring.
|
|
</para>
|
|
|
|
&lfs90_checked;
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&gimp-download-http;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download (FTP): <ulink url="&gimp-download-ftp;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download MD5 sum: &gimp-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &gimp-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &gimp-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &gimp-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
|
<!--
|
|
<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>
|
|
-->
|
|
<note>
|
|
<para>
|
|
The updating of the help files is still a work in progress, with large
|
|
parts of the text for many languages not yet translated. The file below
|
|
is a git snapshot.
|
|
</para>
|
|
</note>
|
|
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&gimp-help-download;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &gimp-help-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download md5sum: &gimp-help-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &gimp-help-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &gimp-help-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
|
|
|
|
<bridgehead renderas="sect4">Required</bridgehead>
|
|
<para role="required">
|
|
<xref linkend="gegl"/>,
|
|
<xref linkend="gexiv2"/>,
|
|
<xref linkend="glib-networking"/>,
|
|
<xref linkend="gtk2"/>,
|
|
<xref linkend="harfbuzz"/>.
|
|
<xref linkend="libjpeg"/>,
|
|
<xref linkend="libmypaint"/>,
|
|
<xref linkend="librsvg"/>,
|
|
<xref linkend="libtiff"/>,
|
|
<!-- en can be built without this -->
|
|
<xref linkend="libxml2py2"/> (to build the translated help files),
|
|
<xref linkend="lcms2"/>,
|
|
<xref linkend="mypaint-brushes"/>,
|
|
<xref linkend="poppler"/> (including poppler-data) and
|
|
<!-- some parts of Xorg appear to be required, as are deps it pulls in -->
|
|
<xref linkend="x-window-system"/>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
|
<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
|
|
<xref linkend="xdg-utils"/>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
|
<para role="optional">
|
|
<xref linkend="aalib"/>,
|
|
<xref linkend="alsa-lib"/>,
|
|
<xref linkend="libmng"/>,
|
|
<xref linkend="libwebp"/>,
|
|
<xref linkend="openjpeg2"/>,
|
|
an <xref linkend="server-mail"/> (that provides a
|
|
<command>sendmail</command> program),
|
|
<xref linkend="gtk-doc"/>,
|
|
<ulink url="https://people.freedesktop.org/~hughsient/appstream-glib">appstream-glib</ulink> and
|
|
<ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>
|
|
</para>
|
|
|
|
<para>
|
|
When you have run configure, you will see that WebKit is not found -
|
|
that dependency is for the legacy webkit-1.0 which should never be used
|
|
on a modern system exposed to the internet.
|
|
</para>
|
|
|
|
<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:
|
|
<ulink url="&blfs-wiki;/gimp"/>
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Gimp</title>
|
|
|
|
<para>
|
|
Install <application>Gimp</application> by running
|
|
the following commands:
|
|
</para>
|
|
|
|
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &&
|
|
make</userinput></screen>
|
|
|
|
<para>
|
|
To test the results (requires an X-Windowed terminal) issue:
|
|
<command>make check</command>. Six tests are known to fail.
|
|
All appear to be related to the same problem in the test suite.
|
|
</para>
|
|
|
|
<para>
|
|
Now, as the <systemitem class="username">root</systemitem>
|
|
user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>make install</userinput></screen>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/update-icons-and-desktop.xml"/>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Gimp-Help</title>
|
|
|
|
<para>
|
|
The <filename>gimp-help</filename> tarball contains images and English
|
|
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="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>
|
|
Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
|
|
you do not wish to install. Alternatively, remove the line starting with
|
|
<envar>ALL_LINGUAS</envar>, if you wish to build all languages.
|
|
</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>
|
|
<envar>ALL_LINGUAS="ca da de el en en_GB ..."</envar>: 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><option>--disable-python</option>: This option is necessary if
|
|
you have not installed <application>PyGTK</application>.</para>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/gtk-doc-rebuild.xml"/>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="configuration">
|
|
<title>Configuring The Gimp</title>
|
|
|
|
<sect3 id="gimp-config">
|
|
<title>Config Files</title>
|
|
|
|
<para>
|
|
<filename>/etc/gimp/2.0/*</filename> and
|
|
<filename>~/.gimp-2.8/gimprc</filename>
|
|
</para>
|
|
|
|
<indexterm zone="gimp gimp-config">
|
|
<primary sortas="e-AA.gimp-2.0/gimprc">~/.g/GIMP/2.10/*</primary>
|
|
</indexterm>
|
|
|
|
<indexterm zone="gimp gimp-config">
|
|
<primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
|
|
</indexterm>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Libraries</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
gimp (symlink), gimp-2.10,
|
|
gimp-console (symlink), gimp-console-2.10,
|
|
gimp-test-clipboard-2.0, and
|
|
gimptool-2.0
|
|
</seg>
|
|
<seg>
|
|
libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
|
|
libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
|
|
libgimpthumb-2.0.so, libgimpui-2.0.so, and libgimpwidgets-2.0.so
|
|
</seg>
|
|
<seg>
|
|
/etc/gimp,
|
|
/usr/include/gimp-2.0,
|
|
/usr/{lib,share}/gimp,
|
|
/usr/share/gimp/2.0,
|
|
/usr/share/gtk-doc/html/libgimp{,base,color,config}, and
|
|
/usr/share/gtk-doc/html/libgimp{math,module,thumb,widgets}
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="gimp-prog">
|
|
<term><command>gimp</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a symbolic link to <command>gimp-2.10</command>.
|
|
</para>
|
|
<indexterm zone="gimp gimp-prog">
|
|
<primary sortas="b-gimp">gimp</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimp-2.10">
|
|
<term><command>gimp-2.10</command></term>
|
|
<listitem>
|
|
<para>
|
|
is the Gnu Image Manipulation Program. It works with a variety
|
|
of image formats and provides a large selection of tools.
|
|
</para>
|
|
<indexterm zone="gimp gimp-2.10">
|
|
<primary sortas="b-gimp-2.10">gimp-2.10</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimp-console">
|
|
<term><command>gimp-console</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a symbolic link to <command>gimp-console-2.10</command>.
|
|
</para>
|
|
<indexterm zone="gimp gimp-console">
|
|
<primary sortas="b-gimp-console">gimp-console</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimp-console-2.10">
|
|
<term><command>gimp-console-2.10</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a console program that behaves as if The
|
|
<application>Gimp</application> was called with the
|
|
<option>--no-interface</option> command-line option.
|
|
</para>
|
|
<indexterm zone="gimp gimp-console-2.10">
|
|
<primary sortas="b-gimp-console-2.10">gimp-console-2.10</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimptool-2.0">
|
|
<term><command>gimptool-2.0</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a tool that can build plug-ins or scripts and install them
|
|
if they are distributed in one source file.
|
|
<command>gimptool-2.0</command> can also be used by programs that
|
|
need to know what libraries and include-paths The
|
|
<application>Gimp</application> was compiled with.
|
|
</para>
|
|
<indexterm zone="gimp gimptool-2.0">
|
|
<primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimp-2.0">
|
|
<term><filename class="libraryfile">libgimp-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides C bindings for The <application>Gimp</application>'s
|
|
Procedural Database (PDB) which offers an interface to core functions
|
|
and to functionality provided by plug-ins.
|
|
</para>
|
|
<indexterm zone="gimp libgimp-2.0">
|
|
<primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpbase-2.0">
|
|
<term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the C functions for basic
|
|
<application>Gimp</application> functionality such as determining
|
|
enumeration data types, gettext translation, determining The
|
|
<application>Gimp</application>'s version number and capabilities,
|
|
handling data files and accessing the environment.
|
|
</para>
|
|
<indexterm zone="gimp libgimpbase-2.0">
|
|
<primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpcolor-2.0">
|
|
<term><filename
|
|
class="libraryfile">libgimpcolor-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the C functions relating to RGB, HSV and CMYK colors as
|
|
well as converting colors between different color models and
|
|
performing adaptive supersampling on an area.
|
|
</para>
|
|
<indexterm zone="gimp libgimpcolor-2.0">
|
|
<primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpconfig-2.0">
|
|
<term><filename
|
|
class="libraryfile">libgimpconfig-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains C functions for reading and writing config information.
|
|
</para>
|
|
<indexterm zone="gimp libgimpconfig-2.0">
|
|
<primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpmath-2.0">
|
|
<term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains C functions which provide mathematical definitions and
|
|
macros, manipulate 3x3 transformation matrices, set up and manipulate
|
|
vectors and the MD5 message-digest algorithm.
|
|
</para>
|
|
<indexterm zone="gimp libgimpmath-2.0">
|
|
<primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpmodule-2.0">
|
|
<term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the C functions which implements module loading using
|
|
GModule and keeps a list of GimpModule's found in a given
|
|
searchpath.
|
|
</para>
|
|
<indexterm zone="gimp libgimpmodule-2.0">
|
|
<primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpthumb-2.0">
|
|
<term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the C functions for handling The
|
|
<application>Gimp</application>'s thumbnail objects.
|
|
</para>
|
|
<indexterm zone="gimp libgimpthumb-2.0">
|
|
<primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpui-2.0">
|
|
<term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains The <application>Gimp</application>'s common user
|
|
interface functions.
|
|
</para>
|
|
<indexterm zone="gimp libgimpui-2.0">
|
|
<primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpwidgets-2.0">
|
|
<term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains The <application>Gimp</application>
|
|
and <application>GTK</application>'s widget creation and
|
|
manipulation functions.
|
|
</para>
|
|
<indexterm zone="gimp libgimpwidgets-2.0">
|
|
<primary
|
|
sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|