source: xsoft/other/gimp.xml@ 7583e9c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 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 7583e9c was a4d3fe5, checked in by Fernando de Oliveira <fernando@…>, 8 years ago
  • Update to gimp-2.8.16. Split Gimp and Gimp-Help in the same page (statistics, build instructions). Statistics, particularly, were too cluttered, but I believe it could be further simplified, perhaps moving some parts to the text (?).

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

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