source: xsoft/other/gimp.xml@ 62032e7

12.2 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since 62032e7 was 62032e7, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Remove gimp obsolete gtk2 dependency

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