mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-25 07:42:13 +08:00
4116c85eca
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@14273 af4574ff-66df-0310-9fd7-8a98e5e911e0
580 lines
20 KiB
XML
580 lines
20 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 "http://download.gimp.org/pub/gimp/v2.8/gimp-&gimp-version;.tar.bz2">
|
|
<!ENTITY gimp-download-ftp " ">
|
|
<!-- <!ENTITY gimp-download-ftp "ftp://mirrors.xmission.com/gimp/gimp/v2.8/gimp-&gimp-version;.tar.bz2">-->
|
|
<!ENTITY gimp-md5sum "233c948203383fa078434cc3f8f925cb">
|
|
<!ENTITY gimp-size "20 MB">
|
|
<!ENTITY gimp-buildsize "642 MB (additional 553 MB to run the test suite,
|
|
the help files add from 307 MB (en only) to
|
|
reputedly 1.3 GB (all 18 languages), typically
|
|
increasing by 60 MB per translation)">
|
|
<!ENTITY gimp-time "4.2 SBU (additional 0.9 SBU to run the test
|
|
suite, and for the help files, from 0.6 SBU (en
|
|
only) to reputedly 19 SBU (all) - typically 1.3
|
|
SBU per translation)">
|
|
|
|
<!ENTITY gimp-help-version "2.8.2">
|
|
<!ENTITY gimp-help-download "http://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">
|
|
<!ENTITY gimp-help-md5sum "a591c8974b2f4f584d0a769d52ed6c5b">
|
|
<!ENTITY gimp-help-size "152 MB">
|
|
]>
|
|
|
|
<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>
|
|
|
|
&lfs76_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>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Optional help files: <ulink url="&gimp-help-download;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download MD5 sum: &gimp-help-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &gimp-help-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Optional patch:
|
|
<ulink url="&patch-root;/gimp-&gimp-version;-device_info-1.patch"/>
|
|
</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>
|
|
|
|
<bridgehead renderas="sect4">Required</bridgehead>
|
|
<para role="required">
|
|
<xref linkend="gegl"/> and
|
|
<xref linkend="gtk2"/>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
|
<para role="recommended">
|
|
<xref linkend="pygtk"/> (including the gtk and pango modules)
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
|
<para role="optional">
|
|
<xref linkend="aalib"/>,
|
|
<xref linkend="alsa-lib"/>,
|
|
<xref linkend="curl"/>,
|
|
<xref linkend="dbus-glib"/>,
|
|
<xref linkend="gs"/> (with libgs installed),
|
|
<xref linkend="gvfs"/>,
|
|
<xref linkend="iso-codes"/>,
|
|
<xref linkend="jasper"/>,
|
|
<xref linkend="lcms"/> or <xref linkend="lcms2"/>,
|
|
<xref linkend="libexif"/>,
|
|
<xref linkend="libmng"/>,
|
|
<xref linkend="librsvg"/>,
|
|
<ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>,
|
|
<xref linkend="poppler"/>,
|
|
an <xref linkend="server-mail"/> (that provides a
|
|
<command>sendmail</command> program),
|
|
<xref linkend="udev-extras"/> (for GUdev),
|
|
<xref linkend="webkitgtk2"/> (required for the help-plugin) and
|
|
<xref linkend="gtk-doc"/>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Optional, for optimizing the PNG files in the
|
|
help system</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>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Gimp</title>
|
|
|
|
<para>
|
|
In order to get rid of an annoying message when running from a terminal
|
|
and/or if you wish to run the test suite, optionally use the
|
|
following patch:
|
|
</para>
|
|
|
|
<screen><userinput>patch -Np1 -i ../gimp-&gimp-version;-device_info-1.patch</userinput></screen>
|
|
|
|
<para>
|
|
Install <application>Gimp</application> by running
|
|
the following commands:
|
|
</para>
|
|
|
|
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc --without-gvfs &&
|
|
make</userinput></screen>
|
|
|
|
<para>
|
|
To test the results (requires an X-Windowed terminal) issue:
|
|
<command>make check</command>.
|
|
</para>
|
|
|
|
<para>
|
|
Now, as the <systemitem class="username">root</systemitem>
|
|
user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>make install</userinput></screen>
|
|
|
|
<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. Prepare for
|
|
the build with the following command:
|
|
</para>
|
|
|
|
<screen><userinput>ALL_LINGUAS="ca da de el en en_GB es fr it ja ko nl nn pt_BR ru sl sv zh_CN" \
|
|
./configure --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>
|
|
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>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/update-icons-and-desktop.xml"/>
|
|
|
|
</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>
|
|
<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
|
|
ensure that <application>cURL</application> is used at run-time, instead of
|
|
<application>Gvfs</application>. You can omit this if you are installing
|
|
<application>Gvfs</application> AND will be running <command>gvfsd</command>,
|
|
e.g., in a <application>GNOME</application> desktop.
|
|
</para>
|
|
|
|
<para><option>--disable-python</option>: This option is necessary if
|
|
you have not installed <application>PyGTK</application>.</para>
|
|
|
|
<!--<para>
|
|
<command>./autogen.sh</command> <parameter>-prefix=/usr</parameter>: 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>
|
|
<command>xzcat ../gimp-help-2.8.0-build_fixes-1.patch.xz</command>:
|
|
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. 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>
|
|
|
|
<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">~/.gimp-2.0/gimprc</primary>
|
|
</indexterm>
|
|
|
|
<indexterm zone="gimp gimp-config">
|
|
<primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
|
|
</indexterm>
|
|
|
|
</sect3>
|
|
|
|
<sect3>
|
|
<title>Configuration Information</title>
|
|
|
|
<para>
|
|
The <application>Gimp</application> executes a configuration wizard
|
|
for each user upon their initial use of the program.
|
|
</para>
|
|
|
|
<para>
|
|
The <application>Gimp</application> executes the
|
|
<command>firefox</command> web browser by default to view the help
|
|
files. If you do not have <application>Firefox</application>, or
|
|
prefer a different web browser, you can set a new system value in
|
|
<filename>/etc/gimp/2.0/gimprc</filename>. Execute the following
|
|
command as the <systemitem class="username">root</systemitem> user,
|
|
replacing <replaceable><browser></replaceable> with your
|
|
preferred web browser:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>echo '(web-browser "<replaceable><browser></replaceable> %s")' >> /etc/gimp/2.0/gimprc</userinput></screen>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Libraries</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
gimp, gimp-2.8, gimp-console, gimp-console-2.8 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/gimp,
|
|
/usr/share/gimp,
|
|
/usr/share/gimp/2.0/help/{en,lang2,lang3,...},
|
|
/usr/share/gtk-doc/html/{libgimp,libgimpbase,libgimpcolor},
|
|
/usr/share/gtk-doc/html/{libgimpconfig,libgimpmath},
|
|
/usr/share/gtk-doc/html/{libgimpmodule,libgimpthumb} and
|
|
/usr/share/gtk-doc/html/libgimpwidgets
|
|
</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.8</command>.
|
|
</para>
|
|
<indexterm zone="gimp gimp-prog">
|
|
<primary sortas="b-gimp">gimp</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimp-2.8">
|
|
<term><command>gimp-2.8</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.8">
|
|
<primary sortas="b-gimp-2.8">gimp-2.8</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.8</command>.
|
|
</para>
|
|
<indexterm zone="gimp gimp-console">
|
|
<primary sortas="b-gimp-console">gimp-console</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimp-console-2.8">
|
|
<term><command>gimp-console-2.8</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.8">
|
|
<primary sortas="b-gimp-console-2.8">gimp-console-2.8</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>
|