source: xsoft/other/gimp.xml@ 24e5f9d

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules 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 24e5f9d was cd964c8, checked in by Ken Moffat <ken@…>, 6 years ago

Build the Python2 libxml2 module and clarify where / when it is used. Make an additional entry for this in the python modules - if trying to build both sets of modules before installing libxml.so, the lib has to be built twice with separate invocations of configure, that is slow if all the optional dependencies are invoked. The dependencies for docbook-xsl are all used at runtime, note that and flag their xref tags as runtime.

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

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