source: xsoft/other/gimp.xml@ d0323de

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since d0323de was d0323de, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

LFS-7.3 tags thanks to Ken Moffat

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

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