source: xsoft/other/gimp.xml@ e14ac42

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind 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 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since e14ac42 was 5e11bc38, checked in by Fernando de Oliveira <fernando@…>, 10 years ago

Update to webkitgtk-2.4.5.
Remove WebKitGTK+1.10.x, consequently, fix Midori-0.5.8 and Gimp-2.8.14 (remove broken ftp link from the latter).
Fix Tk-8.6.2 md5sum that changed overnight. Thanks Wayne B.
LibreOffice-4.3.0 - fix broken symbolic links. Thanks Wayne B.

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

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