source: xsoft/other/gimp.xml@ 39ae4e34

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 39ae4e34 was 39ae4e34, checked in by Bruce Dubbs <bdubbs@…>, 13 months ago

Update to gimp-2.10.22.
Update to cairomm-1.16.0.
Add libsigc++-3.0.4.

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

  • Property mode set to 100644
File size: 19.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY gimp-download-http "https://download.gimp.org/pub/gimp/v2.10/gimp-&gimp-version;.tar.bz2">
8 <!ENTITY gimp-download-ftp " ">
9 <!ENTITY gimp-md5sum "9d559ba6f039da033754f1d62a91cc39">
10 <!ENTITY gimp-size "32 MB">
11 <!ENTITY gimp-buildsize "1.3 GB (267 MB installed, add 0.9 GB for tests)">
12 <!ENTITY gimp-time "2.8 SBU (Using parallelism=4; add 0.7 SBU for tests)">
13
14 <!-- pro-tem, a pull of gimp-help, https://gitlab.gnome.org/GNOME/gimp-help.git
15 git archive - -format=tar - -prefix=${DIRNAME}/ HEAD | xz >../${DIRNAME}.tar.xz -->
16
17 <!-- renodr: I generated the git tarball using the following instructions:
18 cd /tmp &&
19 mkdir gimp-help &&
20 cd gimp-help &&
21 git clone https://gitlab.gnome.org/GNOME/gimp-help.git &&
22 rm -rv gimp-help/.git &&
23 mv -v gimp-help gimp-help-<DATE>
24 tar -cJvf gimp-help-<DATE>.tar.xz gimp-help-<DATE>
25
26 After you've completed this, run a test build, and upload the tarball to
27 anduin.-->
28
29 <!ENTITY gimp-help-version "2020-10-07">
30 <!ENTITY gimp-help-download "&sources-anduin-http;/gimp/gimp-help-&gimp-help-version;.tar.xz">
31 <!ENTITY gimp-help-md5sum "39cee813a1cd91cc2d2892cf94d44f05">
32 <!ENTITY gimp-help-size "170 MB">
33 <!ENTITY gimp-help-buildsize "From 384 MB (en only) to 1.8 GB (all 18
34 languages)">
35 <!ENTITY gimp-help-time "1.0 SBU (en only), 9.7 SBU, with parallelism=4,
36 for all languages">
37]>
38
39<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
40 <?dbhtml filename="gimp.html" ?>
41
42 <sect1info>
43 <othername>$LastChangedBy$</othername>
44 <date>$Date$</date>
45 </sect1info>
46
47 <title>Gimp-&gimp-version;</title>
48
49 <indexterm zone="gimp">
50 <primary sortas="a-Gimp">Gimp</primary>
51 </indexterm>
52
53 <sect2 role="package">
54 <title>Introduction to Gimp</title>
55
56 <para>
57 The <application>Gimp</application> package contains
58 the GNU Image Manipulation Program which is useful for
59 photo retouching, image composition and image authoring.
60 </para>
61
62 &lfs10_checked;
63
64 <bridgehead renderas="sect3">Package Information</bridgehead>
65 <itemizedlist spacing="compact">
66 <listitem>
67 <para>
68 Download (HTTP): <ulink url="&gimp-download-http;"/>
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Download (FTP): <ulink url="&gimp-download-ftp;"/>
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Download MD5 sum: &gimp-md5sum;
79 </para>
80 </listitem>
81 <listitem>
82 <para>
83 Download size: &gimp-size;
84 </para>
85 </listitem>
86 <listitem>
87 <para>
88 Estimated disk space required: &gimp-buildsize;
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Estimated build time: &gimp-time;
94 </para>
95 </listitem>
96 </itemizedlist>
97
98 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
99<!--
100 <note>
101 <para>
102 The creation of local html files with recent versions of the necessary
103 packages is somewhat broken (some png images are not sourced by the
104 generated HTML, only their captions are visible).
105 </para>
106 </note>
107-->
108 <note>
109 <para>
110 The updating of the help files is still a work in progress, with large
111 parts of the text for many languages not yet translated. The file below
112 is a git snapshot.
113 </para>
114 </note>
115
116 <itemizedlist spacing="compact">
117 <listitem>
118 <para>
119 Download (HTTP): <ulink url="&gimp-help-download;"/>
120 </para>
121 </listitem>
122 <listitem>
123 <para>
124 Download size: &gimp-help-size;
125 </para>
126 </listitem>
127 <listitem>
128 <para>
129 Download md5sum: &gimp-help-md5sum;
130 </para>
131 </listitem>
132 <listitem>
133 <para>
134 Estimated disk space required: &gimp-help-buildsize;
135 </para>
136 </listitem>
137 <listitem>
138 <para>
139 Estimated build time: &gimp-help-time;
140 </para>
141 </listitem>
142 </itemizedlist>
143
144 <bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
145
146 <bridgehead renderas="sect4">Required</bridgehead>
147 <para role="required">
148 <xref linkend="gegl"/>,
149 <xref linkend="gexiv2"/>,
150 <xref linkend="glib-networking"/>,
151 <xref linkend="gtk2"/>,
152 <xref linkend="harfbuzz"/>.
153 <xref linkend="libjpeg"/>,
154 <xref linkend="libmypaint"/>,
155 <xref linkend="librsvg"/>,
156 <xref linkend="libtiff"/>,
157 <!-- en can be built without this -->
158 <xref linkend="libxml2py2"/> (to build the translated help files),
159 <xref linkend="lcms2"/>,
160 <xref linkend="mypaint-brushes"/>,
161 <xref linkend="poppler"/> (including poppler-data) and
162 <!-- some parts of Xorg appear to be required, as are deps it pulls in -->
163 <xref linkend="x-window-system"/>
164 </para>
165
166 <bridgehead renderas="sect4">Recommended</bridgehead>
167 <para role="recommended">
168 <xref linkend="dbus-glib"/>,
169 <xref linkend="gs"/> (with libgs installed),
170 <xref linkend="gvfs"/> (to access the online help),
171 <xref linkend="iso-codes"/>,
172 <xref linkend="libgudev"/>,
173 <xref linkend="pygtk"/> (including the gtk, pango and pangocairo modules) and
174 <xref linkend="xdg-utils"/>
175 </para>
176
177 <bridgehead renderas="sect4">Optional</bridgehead>
178 <para role="optional">
179 <xref linkend="aalib"/>,
180 <xref linkend="alsa-lib"/>,
181 <xref linkend="libmng"/>,
182 <xref linkend="libwebp"/>,
183 <xref linkend="openjpeg2"/>,
184 an <xref linkend="server-mail"/> (that provides a
185 <command>sendmail</command> program),
186 <xref linkend="gtk-doc"/>,
187 <ulink url="https://people.freedesktop.org/~hughsient/appstream-glib">appstream-glib</ulink>,
188 <ulink url="https://github.com/ianlancetaylor/libbacktrace">libbacktrace</ulink>,
189 <ulink url="https://github.com/strukturag/libheif">libheif</ulink>,
190 <ulink url="https://www.nongnu.org/libunwind">libunwind</ulink>, and
191 <ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>
192 </para>
193
194 <para>
195 When you have run configure, you will see that WebKit is not found -
196 that dependency is for the legacy webkit-1.0 which should never be used
197 on a modern system exposed to the internet.
198 </para>
199
200 <bridgehead renderas="sect4">Optional, for building the help system</bridgehead>
201 <para role="optional">
202 <ulink url="http://dblatex.sourceforge.net/">dblatex</ulink> (for PDF docs),
203 <ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
204 <ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
205 to optimize the png files, but see the note on the help download above
206 </para>
207
208 <para condition="html" role="usernotes">User Notes:
209 <ulink url="&blfs-wiki;/gimp"/>
210 </para>
211 </sect2>
212
213 <sect2 role="installation">
214 <title>Installation of Gimp</title>
215
216 <para>
217 Install <application>Gimp</application> by running
218 the following commands:
219 </para>
220
221<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
222make</userinput></screen>
223
224 <para>
225 To test the results (requires an X-Windowed terminal) issue:
226 <command>make check</command>.
227 <!-- Six tests are known to fail.
228 All appear to be related to the same problem in the test suite.-->
229 <!-- km: in 2.10.16 no failures, 2 tests were skipped -->
230 </para>
231
232 <para>
233 Now, as the <systemitem class="username">root</systemitem>
234 user:
235 </para>
236
237<screen role="root"><userinput>make install</userinput></screen>
238
239 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
240 href="../../xincludes/update-icons-and-desktop.xml"/>
241
242 </sect2>
243
244 <sect2 role="installation">
245 <title>Installation of Gimp-Help</title>
246
247 <para>
248 The <filename>gimp-help</filename> tarball contains images and English
249 text help for help files, together with translations. Because of the
250 issues mentioned in the note above, you are recommended to use the online
251 help, either by building against <xref linkend="gvfs"/> so that 'help'
252 can open the latest XML files in your browser, or else you can manually
253 open the html in your browser by going to <ulink
254 url="https://docs.gimp.org/2.10/en/">https://docs.gimp.org/2.10/en</ulink>
255 (change the language code if desired).
256 </para>
257
258 <para>
259 If you nevertheless wish to install local copies of the help files to read
260 offline, unpack the <filename>gimp-help</filename> tarball
261 and change into the root of the newly created source tree. Prepare for
262 the build with the following command:
263 </para>
264
265<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; \
266./autogen.sh --prefix=/usr</userinput></screen>
267
268 <para>
269 Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
270 you do not wish to install. Alternatively, remove the line starting with
271 <envar>ALL_LINGUAS</envar>, if you wish to build all languages.
272 </para>
273
274 <para>
275 Now build the help files:
276 </para>
277
278<screen><userinput>make</userinput></screen>
279
280 <para>
281 Issue the following commands as the
282 <systemitem class="username">root</systemitem> user to install the help
283 files:
284 </para>
285
286<screen role="root"><userinput>make install &amp;&amp;
287chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
288
289 </sect2>
290
291 <sect2 role="commands" id="gimp-cmd-explanations">
292 <title>Command Explanations</title>
293
294 <para>
295 <envar>ALL_LINGUAS=&quot;ca da de el en en_GB ...&quot;</envar>: by
296 default, the help files will be rendered in all the available languages.
297 Remove the codes of any languages you do not wish to build.
298 </para>
299
300 <para>
301 <option>--disable-python</option>: This option is necessary if
302 you have not installed <application>PyGTK</application>.
303 </para>
304
305 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
306 href="../../xincludes/gtk-doc-rebuild.xml"/>
307
308 </sect2>
309
310 <sect2 role="configuration">
311 <title>Configuring The Gimp</title>
312
313 <sect3 id="gimp-config">
314 <title>Config Files</title>
315
316 <para>
317 <filename>/etc/gimp/2.0/*</filename> and
318 <filename>~/.gimp-2.8/gimprc</filename>
319 </para>
320
321 <indexterm zone="gimp gimp-config">
322 <primary sortas="e-AA.gimp-2.0/gimprc">~/.g/GIMP/2.10/*</primary>
323 </indexterm>
324
325 <indexterm zone="gimp gimp-config">
326 <primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
327 </indexterm>
328
329 </sect3>
330
331 </sect2>
332
333 <sect2 role="content">
334 <title>Contents</title>
335
336 <segmentedlist>
337 <segtitle>Installed Programs</segtitle>
338 <segtitle>Installed Libraries</segtitle>
339 <segtitle>Installed Directories</segtitle>
340
341 <seglistitem>
342 <seg>
343 gimp (symlink), gimp-2.10,
344 gimp-console (symlink), gimp-console-2.10,
345 gimp-test-clipboard-2.0, and
346 gimptool-2.0
347 </seg>
348 <seg>
349 libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
350 libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
351 libgimpthumb-2.0.so, libgimpui-2.0.so, and libgimpwidgets-2.0.so
352 </seg>
353 <seg>
354 /etc/gimp,
355 /usr/include/gimp-2.0,
356 /usr/{lib,share}/gimp,
357 /usr/share/gtk-doc/html/libgimp{,base,color,config}, and
358 /usr/share/gtk-doc/html/libgimp{math,module,thumb,widgets}
359 </seg>
360 </seglistitem>
361 </segmentedlist>
362
363 <variablelist>
364 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
365 <?dbfo list-presentation="list"?>
366 <?dbhtml list-presentation="table"?>
367
368 <varlistentry id="gimp-prog">
369 <term><command>gimp</command></term>
370 <listitem>
371 <para>
372 is a symbolic link to <command>gimp-2.10</command>.
373 </para>
374 <indexterm zone="gimp gimp-prog">
375 <primary sortas="b-gimp">gimp</primary>
376 </indexterm>
377 </listitem>
378 </varlistentry>
379
380 <varlistentry id="gimp-2.10">
381 <term><command>gimp-2.10</command></term>
382 <listitem>
383 <para>
384 is the Gnu Image Manipulation Program. It works with a variety
385 of image formats and provides a large selection of tools.
386 </para>
387 <indexterm zone="gimp gimp-2.10">
388 <primary sortas="b-gimp-2.10">gimp-2.10</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="gimp-console">
394 <term><command>gimp-console</command></term>
395 <listitem>
396 <para>
397 is a symbolic link to <command>gimp-console-2.10</command>.
398 </para>
399 <indexterm zone="gimp gimp-console">
400 <primary sortas="b-gimp-console">gimp-console</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="gimp-console-2.10">
406 <term><command>gimp-console-2.10</command></term>
407 <listitem>
408 <para>
409 is a console program that behaves as if The
410 <application>Gimp</application> was called with the
411 <option>--no-interface</option> command-line option.
412 </para>
413 <indexterm zone="gimp gimp-console-2.10">
414 <primary sortas="b-gimp-console-2.10">gimp-console-2.10</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 <varlistentry id="gimptool-2.0">
420 <term><command>gimptool-2.0</command></term>
421 <listitem>
422 <para>
423 is a tool that can build plug-ins or scripts and install them
424 if they are distributed in one source file.
425 <command>gimptool-2.0</command> can also be used by programs that
426 need to know what libraries and include-paths The
427 <application>Gimp</application> was compiled with.
428 </para>
429 <indexterm zone="gimp gimptool-2.0">
430 <primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
431 </indexterm>
432 </listitem>
433 </varlistentry>
434
435 <varlistentry id="libgimp-2.0">
436 <term><filename class="libraryfile">libgimp-2.0.so</filename></term>
437 <listitem>
438 <para>
439 provides C bindings for The <application>Gimp</application>'s
440 Procedural Database (PDB) which offers an interface to core functions
441 and to functionality provided by plug-ins.
442 </para>
443 <indexterm zone="gimp libgimp-2.0">
444 <primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
445 </indexterm>
446 </listitem>
447 </varlistentry>
448
449 <varlistentry id="libgimpbase-2.0">
450 <term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
451 <listitem>
452 <para>
453 provides the C functions for basic
454 <application>Gimp</application> functionality such as determining
455 enumeration data types, gettext translation, determining The
456 <application>Gimp</application>'s version number and capabilities,
457 handling data files and accessing the environment.
458 </para>
459 <indexterm zone="gimp libgimpbase-2.0">
460 <primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
461 </indexterm>
462 </listitem>
463 </varlistentry>
464
465 <varlistentry id="libgimpcolor-2.0">
466 <term><filename
467 class="libraryfile">libgimpcolor-2.0.so</filename></term>
468 <listitem>
469 <para>
470 provides the C functions relating to RGB, HSV and CMYK colors as
471 well as converting colors between different color models and
472 performing adaptive supersampling on an area.
473 </para>
474 <indexterm zone="gimp libgimpcolor-2.0">
475 <primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
476 </indexterm>
477 </listitem>
478 </varlistentry>
479
480 <varlistentry id="libgimpconfig-2.0">
481 <term><filename
482 class="libraryfile">libgimpconfig-2.0.so</filename></term>
483 <listitem>
484 <para>
485 contains C functions for reading and writing config information.
486 </para>
487 <indexterm zone="gimp libgimpconfig-2.0">
488 <primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
489 </indexterm>
490 </listitem>
491 </varlistentry>
492
493 <varlistentry id="libgimpmath-2.0">
494 <term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
495 <listitem>
496 <para>
497 contains C functions which provide mathematical definitions and
498 macros, manipulate 3x3 transformation matrices, set up and manipulate
499 vectors and the MD5 message-digest algorithm.
500 </para>
501 <indexterm zone="gimp libgimpmath-2.0">
502 <primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
503 </indexterm>
504 </listitem>
505 </varlistentry>
506
507 <varlistentry id="libgimpmodule-2.0">
508 <term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
509 <listitem>
510 <para>
511 provides the C functions which implements module loading using
512 GModule and keeps a list of GimpModule's found in a given
513 searchpath.
514 </para>
515 <indexterm zone="gimp libgimpmodule-2.0">
516 <primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 <varlistentry id="libgimpthumb-2.0">
522 <term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
523 <listitem>
524 <para>
525 provides the C functions for handling The
526 <application>Gimp</application>'s thumbnail objects.
527 </para>
528 <indexterm zone="gimp libgimpthumb-2.0">
529 <primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
530 </indexterm>
531 </listitem>
532 </varlistentry>
533
534 <varlistentry id="libgimpui-2.0">
535 <term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
536 <listitem>
537 <para>
538 contains The <application>Gimp</application>'s common user
539 interface functions.
540 </para>
541 <indexterm zone="gimp libgimpui-2.0">
542 <primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
543 </indexterm>
544 </listitem>
545 </varlistentry>
546
547 <varlistentry id="libgimpwidgets-2.0">
548 <term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
549 <listitem>
550 <para>
551 contains The <application>Gimp</application>
552 and <application>GTK</application>'s widget creation and
553 manipulation functions.
554 </para>
555 <indexterm zone="gimp libgimpwidgets-2.0">
556 <primary
557 sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
558 </indexterm>
559 </listitem>
560 </varlistentry>
561
562 </variablelist>
563
564 </sect2>
565
566</sect1>
Note: See TracBrowser for help on using the repository browser.