source: xsoft/other/gimp.xml@ e0d45ee

<?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        "56bf7e78b5dd72ed82124f2cbb028d80">
  <!ENTITY gimp-size          "30 MB">
  <!ENTITY gimp-buildsize     "885 MB (194 MB installed, add 820 MB for tests)">
  <!ENTITY gimp-time          "1.7 SBU (Using parallelism=4; add 0.6 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 -->

  <!-- renodr: I generated the git tarball using the following instructions:
       cd /tmp &&
       mkdir gimp-help &&
       cd gimp-help &&
       git clone https://gitlab.gnome.org/GNOME/gimp-help.git &&
       cd gimp-help &&
       git checkout gimp-help-2-10 &&
       cd .. &&
       rm -rv gimp-help/.git &&
       mv -v gimp-help gimp-help-<DATE>
       tar -cJvf gimp-help-<DATE>.tar.xz gimp-help-<DATE>

       After you've completed this, run a test build, and upload the tarball to
       anduin.-->

  <!ENTITY gimp-help-version    "2021-03-30">
  <!ENTITY gimp-help-download   "&sources-anduin-http;/gimp/gimp-help-&gimp-help-version;.tar.xz">
  <!ENTITY gimp-help-md5sum     "df6acc812c829b610d621f8e6973a680">
  <!ENTITY gimp-help-size       "170 MB">
  <!ENTITY gimp-help-buildsize  "From 383 MB (en only) to 1.8 GB (all 17
                                 languages)">
  <!ENTITY gimp-help-time       "1.8 SBU (en only), 14.0 SBU, with parallelism=4,
                                 for all languages">
]>

<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
  <?dbhtml filename="gimp.html" ?>

  <sect1info>
    <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>

    &lfs110a_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>
        Updating 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 MD5 sum: &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="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="gvfs"/> (to access the online help),
      <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>,
      <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
      <ulink url="https://github.com/strukturag/libheif/">libheif</ulink> with
      <ulink url="https://github.com/strukturag/libde265/">libde265</ulink>
      (both needed to read macOS heic images),
      <ulink url="https://www.nongnu.org/libunwind">libunwind</ulink>,
      <ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>, and
      <ulink url="https://www.openexr.com/">OpenEXR</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 &amp;&amp;
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.-->
      <!-- km: in 2.10.16 no failures, 2 tests were skipped -->
    </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=&quot;ca da de el en en_GB es fi fr it ja ko nn pt_BR ro ru zh_CN&quot; \
./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 &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>
      <envar>ALL_LINGUAS=&quot;ca da de el en en_GB ...&quot;</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/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 implement module loading using
            GModule and supports keeping 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>