source: xsoft/other/gimp.xml@ dfdf251

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.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 dfdf251 was dfdf251, checked in by Ken Moffat <ken@…>, 4 years ago

gegl-0.4.22,
gimp-2.10.16.

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

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