source: xsoft/other/gimp.xml@ 993eb82

12.2 gimp3 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since 993eb82 was 993eb82, checked in by Ken Moffat <zarniwhoop@…>, 2 months ago

Patch gimp-2.10.38 to build with gcc14.

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