source: xsoft/other/gimp.xml@ 08de396

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 08de396 was 3458ddad, checked in by Fernando de Oliveira <fernando@…>, 10 years ago

Gimp-2.8.10: switch ftp site. Thanks, Bruce.

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

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