source: xsoft/other/gimp.xml@ e0d45ee

11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since e0d45ee was e0d45ee, checked in by Douglas R. Reno <renodr@…>, 17 months ago

Update to gimp-2.10.28

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