source: xsoft/other/gimp.xml@ 3c7d69e6

10.0 10.1 11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 3c7d69e6 was 3c7d69e6, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Update to gimp-2.10.20
Update to intel-vaapi-driver-2.4.1
Update to babl-0.1.78
Update to gegl-0.4.24
Remove unnecessary section from iso-codes

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

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