source: xsoft/other/gimp.xml@ ccded7e

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since ccded7e was 40454cd2, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Update to WebKitGTK+-2.32.0
Update to gimp-2.10.24
popt: Add optional dependency on doxygen

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

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