source: xsoft/other/gimp.xml@ 2b7420b

10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 2b7420b was 2b7420b, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Tag printer stack, window managers, and misc

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