source: xsoft/other/gimp.xml@ de1a0d9

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 de1a0d9 was 56605b9, checked in by Bruce Dubbs <bdubbs@…>, 10 years ago

Remove XML::Parser from perl modules
Archive acl, attr, intltool, expat, gperf
Synchronize libcap with LFS.

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