source: xsoft/other/gimp.xml@ e810b585

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since e810b585 was e810b585, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to gimp-2.10.10.
Update to itstool-2.0.6.
Update to ristretto-0.8.4.

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

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